APIs, concepts, guides, and more
SyncOutputWithMotion.cpp
1
22#include <cassert>
23#include "rsi.h" // Import our RapidCode Library.
24#include "SampleAppsHelper.h" // Import our SampleApp helper functions.
25#include <cmath>
26#include "SampleApps.h"
27
28using namespace RSI::RapidCode; // Import the RapidCode namespace
29
31int SyncOutputWithMotion::Run()
32{
34 /* CONSTANTS */
35 // *NOTICE* The following constants must be configured before attempting to run with hardware.
36
37 // Axis configuration parameters
38 const int AXIS_COUNT = 1; // number of axes
39 const int AXIS_NUMBER = 0; // axis number
40
41 const double USER_UNITS = 1048576; // encoder counts per rev (set as appropiate)
42
43 // Motion parameters
44 const double TIME_SLICE = 0.01; // 0.01s = 10ms
45 const int REVS = 2; // number of revolutions
46 const int RPS = 1; // revs / sec
47 const int TOTAL_POINTS = (int)(REVS / TIME_SLICE / RPS); // total number of points
48 const int EMPTY_CT = -1; // Number of points that remains in the buffer before an e-stop
49
50 // To run with hardware, set the USE_HARDWARE flag to true AFTER you have configured the parameters above and taken proper safety precautions.
51 USE_HARDWARE = false;
52
53 /* SAMPLE APP BODY */
54
55 // Initizalize the controller from software w/ multiple axes
58
59 // Setup the controller for the appropriate hardware configuration.
60 if (USE_HARDWARE)
61 {
63 }
64 else
65 {
66 SampleAppsHelper::SetupControllerForPhantoms(controller, AXIS_COUNT, { AXIS_NUMBER });
67 }
68
69 MultiAxis* multiAxis;
70
71 try {
72 // add an additional axis for the multiaxis supervisor
73 controller->MotionCountSet(controller->AxisCountGet() + 1);
74
75 // create the multiaxis using the ID of the first free axis (0 indexed)
76 multiAxis = controller->MultiAxisGet(controller->MotionCountGet() - 1);
78
79 // populate the multiaxis
80 Axis* axis = controller->AxisGet(AXIS_NUMBER);
82 axis->UserUnitsSet(USER_UNITS);
84 axis->EStopAbort();
85 axis->ClearFaults();
86 axis->PositionSet(0);
87
88 multiAxis->AxisAdd(axis);
89
90 // populate the positions and times
91 std::vector<double> positions, times;
92 for (int i = 0; i < TOTAL_POINTS; i += AXIS_COUNT)
93 {
94 positions.push_back(i * TIME_SLICE * RPS);
95 times.push_back(TIME_SLICE);
96 }
97
98
99 // prepare the controller (and drive)
100 multiAxis->Abort();
101 multiAxis->ClearFaults();
102 assert(multiAxis->StateGet() == RSIState::RSIStateIDLE);
103 multiAxis->AmpEnableSet(true);
104
105
106 // set up the inputs
108 // ensure the digital out is set low
109 output0->Set(0);
110
111 // The motion element ID at which to set the output
112 int outPutEnableID = TOTAL_POINTS / 2;
113
114
115 // enable streaming output
116 multiAxis->StreamingOutputsEnableSet(true);
117
118
119 // Enable the streaming output (The following are functionally equivalent)
120 //multiAxis->StreamingOutputAdd(output0->MaskGet(), 0, output0->AddressGet(), outPutEnableID);
121 multiAxis->StreamingOutputAdd(output0, true, outPutEnableID);
122
123 // Disable the output (The following are functionally equivalent)
124 //multiAxis->StreamingOutputAdd(0, output0->MaskGet(), output0->AddressGet(), outPutEnableID);
125 //multiAxis->StreamingOutputAdd(output0, false, outPutEnableID);
126
127
128 multiAxis->MovePT(RSIMotionType::RSIMotionTypePT, &positions[0], &times[0], TOTAL_POINTS, EMPTY_CT, false, true);
129
130 printf("Motion started. Waiting to complete.\n");
131 multiAxis->MotionDoneWait();
132 printf("Motion Complete. The outputs should have been set\n");
133
134 multiAxis->StreamingOutputsClear(); // cleanup for next run
135
136 multiAxis->EStopAbort();
137 }
138 catch (RsiError const& err) {
139 printf("\n%s\n", err.text);
140 return -1;
141 }
142 controller->Delete(); // Delete the controller as the program exits to ensure memory is deallocated in the correct order.
143 return 0;
145}
void UserUnitsSet(double countsPerUserUnit)
Sets the number of counts per User Unit.
void ErrorLimitActionSet(RSIAction action)
Set the action that will occur when the Error Limit Event triggers.
void PositionSet(double position)
Set the Command and Actual positions.
Represents a single axis of motion control. This class provides an interface for commanding motion,...
Definition rsi.h:5643
void Set(bool state)
Set the state of a Digital Output.
static IOPoint * CreateDigitalOutput(Axis *axis, RSIMotorDedicatedOut motorDedicatedOutNumber)
Create a Digital Output from an Axis' Dedicated Output bits.
Represents one specific point: Digital Output, Digital Input, Analog Output, or Analog Input....
Definition rsi.h:11058
Axis * AxisGet(int32_t axisNumber)
AxisGet returns a pointer to an Axis object and initializes its internals.
void MotionCountSet(int32_t motionCount)
Set the number of processed Motion Supervisors in the controller.
static MotionController * CreateFromSoftware()
Initialize and start the RMP EtherCAT controller.
void Delete(void)
Delete the MotionController and all its objects.
MultiAxis * MultiAxisGet(int32_t motionSupervisorNumber)
MultiAxisGet returns a pointer to a MultiAxis object and initializes its internals.
int32_t AxisCountGet()
Get the number of axes processing.
int32_t MotionCountGet()
Get the number of Motion Supervisors available in the firmware.
Represents the RMP soft motion controller. This class provides an interface to general controller con...
Definition rsi.h:796
Axis * AxisGet(int32_t index)
Get the Axis class used in this MultiAxis class.
void AxisAdd(Axis *axis)
Add an Axis to a MultiAxis group.
Represents multiple axes of motion control, allows you to map two or more Axis objects together for e...
Definition rsi.h:10338
void ClearFaults()
Clear all faults for an Axis or MultiAxis.
void AmpEnableSet(bool enable)
Enable all amplifiers.
void Abort()
Abort an axis.
int32_t MotionDoneWait()
Waits for a move to complete.
void StreamingOutputAdd(int32_t onMask, int32_t offMask, uint64_t address)
RSIState StateGet()
Get the Axis or MultiAxis state.
void StreamingOutputsClear()
Clear the contents of the Streaming Output List.
void StreamingOutputsEnableSet(bool enable)
Sets whether Streaming Output is enabled (true) or disabled (false).
void MovePT(RSIMotionType type, const double *const position, const double *const time, int32_t pointCount, int32_t emptyCount, bool retain, bool final)
A move commanded by a list of position and time points.
void EStopAbort()
E-Stop, then abort an axis.
Represents the error details thrown as an exception by all RapidCode classes. This class contains an ...
Definition rsi.h:107
@ RSIMotionTypePT
Position-Time algorithm with continuous position but discontinuous velocity. Best for short time inte...
@ RSIActionNONE
None - do not perform any action.
@ RSIStateIDLE
Idle, ready for anything.
static void SetupControllerForHardware(MotionController *controller)
Sets up the controller for hardware use by resetting it and starting the network.
static void CheckErrors(RapidCodeObject *rsiObject)
Checks for errors in the given RapidCodeObject and throws an exception if any non-warning errors are ...
static void SetupControllerForPhantoms(MotionController *controller, int axisCount, std::vector< int > axisNums)
Sets up the controller for phantom axes, including configuring specified axes as phantom.