userlimit-digital-input-one-condition.cs

Note

See IO: User Limits 📜 for a detailed explanation of this sample code.

Warning

This is a sample program to assist in the integration of the RMP motion controller with your application. It may not contain all of the logic and safety features that your application requires. We recommend that you wire an external hardware emergency stop (e-stop) button for safety when using our code sample apps. Doing so will help ensure the safety of you and those around you and will prevent potential injury or damage.

The sample apps assume that the system (network, axes, I/O) are configured prior to running the code featured in the sample app. See the Configuration page for more information.

/*  This sample demonstrates how to configure a user limit triggered by a single digital input.
    When the input matches the specified value, the configured output is activated.
    Uses simulated IO with user buffer memory for demonstration purposes.
*/
 
using RSI.RapidCode; // RSI.RapidCode.dotNET;
 
Console.WriteLine("📜 User Limit: Digital Input One Condition");
 
// get rmp objects
MotionController controller = MotionController.Get();
 
try
{
    Helpers.CheckErrors(controller);
 
    // configure user limits
    controller.UserLimitCountSet(1);     // set the amount of user limits to use
    controller.InterruptEnableSet(true); // enable user limit interrupts
 
    // create simulated io using user buffer memory
    ulong userBufferAddress = controller.AddressGet(RSIControllerAddressType.RSIControllerAddressTypeUSER_BUFFER, 0);
    IOPoint input0  = IOPoint.CreateDigitalInput(controller, userBufferAddress,  bitNumber: 0);
    IOPoint output0 = IOPoint.CreateDigitalOutput(controller, userBufferAddress, bitNumber: 1);
 
    Helpers.CheckErrors(input0);
    Helpers.CheckErrors(output0);
 
    // configure user limit condition
    controller.UserLimitConditionSet(
        number:           0,
        conditionNumber:  0,
        logic:            RSIUserLimitLogic.RSIUserLimitLogicEQ,
        addressOfUInt32:  input0.AddressGet(),
        userLimitMask:    (uint)input0.MaskGet(),
        limitValueUInt32: (uint)input0.MaskGet());
 
    // configure user limit settings
    controller.UserLimitConfigSet(
        number:      0,
        triggerType: RSIUserLimitTriggerType.RSIUserLimitTriggerTypeSINGLE_CONDITION,
        action:      RSIAction.RSIActionNONE,
        actionAxis:  0,
        duration:    0);
 
    // configure user limit output
    controller.UserLimitOutputSet(
        number:    0,
        andMask:   (uint)output0.MaskGet(),
        orMask:    (uint)output0.MaskGet(),
        outputPtr: output0.AddressGet(),
        enabled:   true);
 
    Console.WriteLine("Waiting for input trigger...");
 
    // verify output is initially off
    if (output0.Get())
        throw new Exception("ERROR: Output should not be triggered yet");
 
    // set input high (bit 0) - condition met
    controller.MemorySet(input0.AddressGet(), 0b0001);  // bit 0 is high
 
    // wait for user limit interrupt to confirm trigger
    if (controller.InterruptWait(1000) != RSIEventType.RSIEventTypeUSER_LIMIT)
        throw new Exception("ERROR: User limit did not trigger when input was high");
 
    // verify output was activated
    if (!output0.Get())
        throw new Exception("ERROR: Output should be high after user limit triggered");
 
    Console.WriteLine("✓ User limit triggered successfully - input high, output activated");
 
    // cleanup
    output0.Set(false);
    controller.UserLimitDisable(0);
    controller.UserLimitCountSet(0);
 
    Console.WriteLine("\nUser limit digital input one condition complete.");
}
// handle errors as needed
finally
{
    controller.Delete();  // dispose
}