RecorderConfigureToTriggerOnMotion() [5/5]

void RecorderConfigureToTriggerOnMotion	(	MultiAxis *	multiAxis,
		bool	triggerOnMotion )

Parameters

multiAxis	MultiAxis object to trigger on.
triggerOnMotion	A boolean value to set the trigger configuration. TRUE = trigger on Motion.

Description:

RecorderConfigureToTriggerOnMotion sets the recorder to trigger on motion. The recording will start when motion begins, and it will automatically stop when the Motion Done condition is true.

Part of the Recorder method group.

Sample Code:

/*  This sample demonstrates how to use the Recorder to track multiple controller parameters.
    Shows how to configure the recorder, record axis position and digital input values,
    and retrieve recorded data to find when specific events occurred.
*/
 
using RSI.RapidCode; // RSI.RapidCode.dotNET;
 
Console.WriteLine("📜 Recorder");
 
int exitCode = 0;
 
// set sample config params
const int VALUES_PER_RECORD = 2;      // how many values to store in each record
const int RECORD_PERIOD_SAMPLES = 1;  // how often to record data (samples between consecutive records)
const int RECORD_TIME = 250;          // how long to record (milliseconds)
const int INPUT_INDEX = 0;
    
// get rmp objects
MotionController controller = MotionController.Get();
 
try
{
    Helpers.CheckErrors(controller);
 
    Helpers.VerifyHardwareUsage(controller);
    Helpers.VerifyAxisCount(controller);
 
    // set recorder count before any RapidCodeObject get/create other than the controller
    controller.RecorderCountSet(1);
 
    // get axis
    Axis axis = controller.AxisGet(Constants.AXIS_0_INDEX);
    Helpers.CheckErrors(axis);
 
    // configure phantom axis
    if (!Constants.USE_HARDWARE) Helpers.PhantomAxisReset(axis);
 
    // create simulated digital input using user buffer memory
    ulong userBufferAddress = controller.AddressGet(RSIControllerAddressType.RSIControllerAddressTypeUSER_BUFFER, 0);
    IOPoint digitalInput = IOPoint.CreateDigitalInput(controller, userBufferAddress, INPUT_INDEX);
 
    // stop recorder if already running
    if (controller.RecorderEnabledGet() == true)
    {
        controller.RecorderStop();   // stop recording
        controller.RecorderReset();  // reset controller
    }
 
    // configure recorder 
    controller.RecorderPeriodSet(RECORD_PERIOD_SAMPLES);                                                          // record every n samples
    controller.RecorderCircularBufferSet(false);                                                                  // do not use circular buffer
    controller.RecorderDataCountSet(VALUES_PER_RECORD);                                                           // number of values per record
    controller.RecorderDataAddressSet(0, axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeACTUAL_POSITION));  // record axis position
    RSIDataType actualPositionDataType = axis.AddressDataTypeGet(RSIAxisAddressType.RSIAxisAddressTypeACTUAL_POSITION);
    Console.WriteLine($"Axis Actual Position data type: {actualPositionDataType}");                               // print actual position type
    controller.RecorderDataAddressSet(1, digitalInput.AddressGet());                                              // record digital input state
 
    // start recording
    controller.RecorderStart();
    controller.OS.Sleep(RECORD_TIME / 2); // record for specified time
    controller.MemorySet(digitalInput.AddressGet(), 1 << INPUT_INDEX); // simulate input trigger
    controller.OS.Sleep(RECORD_TIME / 2); // continue recording for specified time
 
    // retrieve recorded data
    int recordsAvailable = controller.RecorderRecordCountGet();
    Console.WriteLine($"There are {recordsAvailable} records available");
 
    // process records to find when input triggered
    for (int i = 0; i < recordsAvailable; i++)
    {
        controller.RecorderRecordDataRetrieve();                            // retrieve one record
 
        FirmwareValue positionFirmwareValue = controller.RecorderRecordDataFirmwareValueGet(0);  // get axis position value
        double positionRecord = positionFirmwareValue.Double;
        FirmwareValue digitalInputFirmwareValue = controller.RecorderRecordDataFirmwareValueGet(1);   // get digital input value
        int digitalInputValue = digitalInputFirmwareValue.Int32;
 
        // check if digital input bit is high
        if ((digitalInputValue & digitalInput.MaskGet()) == digitalInput.MaskGet())
        {
            Console.WriteLine($"Encoder position was: {positionRecord} when input triggered");
            break;
        }
    }
 
    // stop and reset recorder
    controller.RecorderStop();
    controller.RecorderReset();
 
    exitCode = Constants.EXIT_SUCCESS;
}
// handle errors as needed
catch (Exception e)
{
    Console.WriteLine($"❌ Error: {e.Message}");
    exitCode = Constants.EXIT_FAILURE;
}
finally
{
    controller.Delete();  // dispose
}
 
return exitCode;

See also

RecorderDataCountSet, RecorderTriggerOnMotionGet This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.