The RMP Motion Controller APIs
UserLimitCommandPositionDirect.cs
1using RSI.RapidCode.dotNET; // Import our RapidCode Library.
2using NUnit.Framework;
3using System;
4
6[TestFixture]
7[Category("Software")]
8public class UserLimitCommandPositionDirect : StaticMemoryTestBase
9 {
11 // Constants
12 const int AXIS_COUNT = 1;
13 const int USER_LIMIT_FIRST = 0; // Specify which user limit to use.
14 const int USER_LIMIT_SECOND = 1;
15 const int USER_LIMIT_COUNT = 2;
16 const RSIUserLimitLogic LOGIC = RSIUserLimitLogic.RSIUserLimitLogicEQ; // Logic for input value comparison.
17 const RSIUserLimitTriggerType TRIGGER_TYPE = RSIUserLimitTriggerType.RSIUserLimitTriggerTypeSINGLE_CONDITION; // Choose the how the condition (s) should be evaluated.
18 const RSIAction ACTION = RSIAction.RSIActionTRIGGERED_MODIFY; // Choose the action you want to cause when the User Limit triggers.
19
20 const int DURATION = 0; // Enter the time delay before the action is executed after the User Limit has triggered.
21 const bool ONE_SHOT = true; // if true, User Limit will only trigger ONCE
22
23 // User Limit Interrupt constants
24 const int COMMAND_POSITION_INDEX = 0;
25 const int ACTUAL_POSITION_INDEX = 1;
26 const int TC_COMMAND_POSITION_INDEX = 2;
27 const int TC_ACTUAL_POSITION_INDEX = 3;
28
29 public void UserLimitCommandPositionDirectSet()
30 {
31 // Some Necessary Pre User Limit Configuration
32 controller.AxisCountSet(AXIS_COUNT);
33 controller.UserLimitCountSet(USER_LIMIT_COUNT); // Set the amount of UserLimits that you want to use.
34 axis = CreateAndReadyAxis(Constants.AXIS_NUMBER); // Initialize your axis object.
35
36 // set the triggered modify values to stop very quickly
37 axis.TriggeredModifyDecelerationSet(Constants.DECELERATION);
38 axis.TriggeredModifyJerkPercentSet(Constants.JERK_PERCENT);
39
41 // USER LIMIT CONDITION 0 (trigger on digital input)
42 controller.UserLimitConditionSet(USER_LIMIT_FIRST, 0, LOGIC, axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeDIGITAL_INPUTS), 0x400000, 0x400000); // Set your User Limit Condition (1st step to setting up your user limit)
43
45 // controller.UserLimitOutputSet(USER_LIMIT_FIRST, RSIDataType.RSIDataTypeDOUBLE, axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeTC_ACTUAL_POSITION), controller.AddressGet(RSIControllerAddressType.RSIControllerAddressTypeUSER_BUFFER), true);
46
48 controller.UserLimitConfigSet(USER_LIMIT_FIRST, TRIGGER_TYPE, ACTION, axis.NumberGet(), DURATION, ONE_SHOT); // Set your User Limit Configuration. (2nd step to setting up your user limit)
49
51 // CONDITION 0 (wait for first user limit to trigger)
52 controller.UserLimitConditionSet(USER_LIMIT_SECOND, 0, RSIUserLimitLogic.RSIUserLimitLogicEQ, controller.AddressGet(RSIControllerAddressType.RSIControllerAddressTypeUSERLIMIT_STATUS, USER_LIMIT_FIRST), 1, 1);
53
54 // CONDITION 1 (AND wait for Axis command velcity = 0.0)
55 controller.UserLimitConditionSet(USER_LIMIT_SECOND, 1, RSIUserLimitLogic.RSIUserLimitLogicEQ, axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeCOMMAND_VELOCITY), 0.0);
56
57 // OUTPUT (copy value from UserBuffer to TC.CommandPosition when trigered)
58 //controller.UserLimitOutputSet(USER_LIMIT_SECOND, RSIDataType.RSIDataTypeDOUBLE, controller.AddressGet(RSIControllerAddressType.RSIControllerAddressTypeUSER_BUFFER), axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeTC_COMMAND_POSITION), true);
59 controller.UserLimitConfigSet(USER_LIMIT_SECOND, RSIUserLimitTriggerType.RSIUserLimitTriggerTypeCONDITION_AND, RSIAction.RSIActionNONE, 0, 0, ONE_SHOT);
60
61 // get the Axis moving
62 axis.ClearFaults();
63 axis.AmpEnableSet(true);
64 axis.MoveVelocity(Constants.VELOCITY, Constants.ACCELERATION);
65
66 // configure and enable interrupts
67 ConfigureUserLimitInterrupts(USER_LIMIT_FIRST);
68 ConfigureUserLimitInterrupts(USER_LIMIT_SECOND);
69 controller.InterruptEnableSet(true);
70
71 // wait for (and print) interrupts
72 WaitForInterrupts();
73 }
74
75 public void ConfigureUserLimitInterrupts(int userLimitIndex)
76 {
77 controller.UserLimitInterruptUserDataAddressSet(userLimitIndex, COMMAND_POSITION_INDEX, axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeCOMMAND_POSITION));
78 controller.UserLimitInterruptUserDataAddressSet(userLimitIndex, ACTUAL_POSITION_INDEX, axis.AddressGet(RSIAxisAddressType.RSIAxisAddressTypeACTUAL_POSITION));
79 }
80
81 public void WaitForInterrupts()
82 {
83 bool done = false;
84 int timeout_millseconds = 10;
85
86 while (!done)
87 {
88 RSIEventType eventType = controller.InterruptWait(timeout_millseconds);
89
90 Console.WriteLine("IRQ: " + eventType.ToString() + " at sample " + controller.InterruptSampleTimeGet());
91
92 switch (eventType)
93 {
94 case RSIEventType.RSIEventTypeUSER_LIMIT:
95 Console.WriteLine("UserLimit " + controller.InterruptSourceNumberGet());
96 Console.WriteLine("CmdPos: " + controller.InterruptUserDataDoubleGet(COMMAND_POSITION_INDEX));
97 Console.WriteLine("ActPos: " + controller.InterruptUserDataDoubleGet(ACTUAL_POSITION_INDEX));
98 Console.WriteLine("TC.CmdPos: " + controller.InterruptUserDataDoubleGet(TC_COMMAND_POSITION_INDEX));
99 Console.WriteLine("TC.ActPos: " + controller.InterruptUserDataDoubleGet(TC_ACTUAL_POSITION_INDEX));
100 break;
101 case RSIEventType.RSIEventTypeTIMEOUT:
102 done = true;
103 break;
104 default:
105 break;
106 }
107 }
108 }
110 }
uint64_t AddressGet(RSIAxisAddressType addressType)
Get the an address for some location on the Axis.
void TriggeredModifyDecelerationSet(double decel)
Set the deceleration rate for an Triggered Modify Event.
void MoveVelocity(double velocity)
void TriggeredModifyJerkPercentSet(double jerkPct)
Set the jerk percent for an Triggered Modify Event.
void UserLimitConditionSet(int32_t number, int32_t conditionNumber, RSIUserLimitLogic logic, uint64_t addressOfUInt32, uint32_t userLimitMask, uint32_t limitValueUInt32)
Set the conditions for a User Limit with a 32-bit integer trigger value.
uint64_t AddressGet(RSIControllerAddressType type)
Get the an address for some location on the MotionController.
void UserLimitInterruptUserDataAddressSet(int32_t number, uint32_t userDataIndex, uint64_t address)
Set the User Data address based on a User Limit trigger.
void UserLimitConfigSet(int32_t number, RSIUserLimitTriggerType triggerType, RSIAction action, int32_t actionAxis, double duration, bool singleShot)
Configure a User Limit.
void UserLimitCountSet(int32_t userLimitCount)
Set the number of processed UserLimits in the MotionController.
void InterruptEnableSet(bool enable)
Control interrupts for this class.
void AxisCountSet(int32_t axisCount)
Set the number of allocated and processed axes in the controller.
double InterruptUserDataDoubleGet(uint32_t userDataIndex)
Get the user data associated with the interrupt, as a 64-bit double.
int32_t InterruptSourceNumberGet()
Get the number (or index) of the object (Axis, Motor, etc) that generated the interrupt.
int32_t InterruptSampleTimeGet()
Get the sample timer value when the last interrupt was generated.
RSIEventType InterruptWait(int32_t milliseconds)
Suspend the current thread until an interrupt arrives from the controller.
void ClearFaults()
Clear all faults for an Axis or MultiAxis.
void AmpEnableSet(bool enable)
Enable all amplifiers.
int32_t NumberGet()
Get the axis number.
RSIControllerAddressType
Used to get firmware address used in User Limits, Sequencers, etc.
Definition rsienums.h:404
RSIEventType
Event Types or Status Bits.
Definition rsienums.h:911
RSIUserLimitLogic
Logic options for User Limits.
Definition rsienums.h:631
RSIAction
Action to perform on an Axis.
Definition rsienums.h:1051
RSIAxisAddressType
Used to get firmware address used in User Limits, Sequencers, etc.
Definition rsienums.h:425
RSIUserLimitTriggerType
Trigger types for UserLimits.
Definition rsienums.h:618