Changes for page SES-PRO Robotic Arm UI

Last modified by Eric Nantel on 2024/10/16 14:33

From version < 13.1 >
edited by Eric Nantel
on 2024/09/23 07:59
To version < 23.1 >
edited by Coleman Benson
on 2024/10/08 18:19
< >
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.ENantel
1 +xwiki:XWiki.CBenson
Content
... ... @@ -8,184 +8,166 @@
8 8  
9 9  = Description =
10 10  
11 +The Lynxmotion Servo Erector Set Professional (SES PRO) Arm Interface is a simple software which allows a user to control any of the Lynxmotion Professional Modular robotic arms in their default configuration. The two compatible gripper kits which are compatible with the SES PRO system (based on the DH Robotics PGE-50-40 and CGE-10-10 DC grillers) can also be controlled via this interface in each of their possible configurations. The included manual jog feature can be used to either position each joint angle, or move to specific cartesian coordinates. Arm (and gripper) positions can then be recorded as part of the built-in sequencer. A 3D display of the arm shows the position of the arm, and a graph can be used to show various information to the user. In order to get a better understanding of the protocol, commands sent to the arm are shown in the interface, and a user input field are standard.
11 11  
12 12  = Features =
13 13  
15 +* Angular and cartesian positioning of the end effector
16 +* 3D graphical display of the appropriate robotic arm and end effector
17 +* Sequencer to record and play back frames (single, looped or infinite)
18 +* Error checking (speed, temperature etc.)
19 +* Command output and user input
20 +* Safety (Software E-Stop, Halt&Hold & Limp)
14 14  
15 -<direct commands>
22 += User Guide =
16 16  
17 -* Does not require ‘#’ and ‘\r’ chars, example for #254Q\r the user should enter 254Q.
18 -* The replies of the query commands are shown in the text field below.
19 -* The commands are validated, and it shows a notification in case of error.
20 -* Supported commands:
24 +Before proceeding with the guide, it is important to note the following:
21 21  
22 -Action:
26 +* Neither the servos nor the arm are meant to be operated in proximity of humans as they do not have "collaborative" (COBOT) features and do not detect collision
27 +* The servos use stepper motors and do NOT include mechanical brakes. If the stepper motor is unable to retain or move to a desired angle (insufficient torque), the motor will rotate freely as opposed to hold the last position
23 23  
24 - # Communication setup
29 +== IMPORTANT: Payload Considerations ==
25 25  
26 - RESET = "RESET"
31 +1. The rated payload for each arm does NOT include an end effector, nor any added distance between the center of mass of the payload and the output of the final joint. Each of the two compatible Lynxmotion PRO grippers reduce the maximum payload of each arm, and it is up to the user to known and understand the concept of "torque" and center of mass before adding an end effector and payload.
32 +1. The rated maximum payload for each arm (at full reach) is at the rated speed for each motor. Moving any joint at a higher speed will decrease the payload capacity of the robot.
33 +1. Although each servo can provide significantly more torque than is needed for the rated payload (and therefore means the arm can support much higher loads at lower speeds, the mechanical and modular structure of the arms may fail. We strongly suggest testing and using each arm in a highly controlled and safe setting where, if a failure should occur with one or more joints, that nothing will break should the arm fall.
34 +1. The stepper motors provide the highest torque at low speeds, and lower torque at high speeds. Note that the maxium torque is not at the lowest speed as the torque to rpm curve for each servo resembles a "mountain".
27 27  
28 - DEFAULT_CONFIGURATION = "DEFAULT"
36 +== IMPORTANT: Emergency ==
29 29  
30 - FIRMWARE_UPDATE_MODE = "UPDATE"
38 +Before using the arm, it is important that a user know what to do when an issue or emergency arises where the arm must be stopped quickly. The following emergency options are available based on severity:
31 31  
32 - CONFIRM_CHANGES = "CONFIRM"
40 +**Halt & Hold**
41 +This will stop every joints and hold them in their last recorded angular positions. The corresponding command is #254H<cr>.
33 33  
34 - # Motion
43 +**Limp**
44 +All joints will go limp which mean there will be nothing avoiding them to turn freely (potentially causing the arm to fall). The high gear ratio of the strain wave gearing does mean there is some (low) level of resistant to rotation, but the gears and motor are nto "locked" and as such, the arm may fall. The corresponding command is #254L<cr>.
35 35  
36 - POSITION = "D"
46 +**Software Stop**
37 37  
38 - MOVE_DEGREES = "MD"
48 +The E-stop button within the software sets all joints to limp.
39 39  
40 - WHEEL_MODE_DEGREES = "WD"
50 +**Hardware E-Stop**
51 +A hardware E-stop (push to cut power) button is located on the power supply which will cut electricity to all actuators. Similar to a limp command, this can possibly cause the arm to fall. To reset this button, rotate the red "mushroom" in the direction indicated by the white arrows and it will spring out.
41 41  
42 - WHEEL_MODE_RPM = "WR"
53 +== Arm Connection ==
43 43  
44 - HALT_AND_HOLD = "H"
55 +**Model**
45 45  
46 - LIMP = "L"
57 +The software currently supports the Lynxmotion PRO 550mm 5 degree of freedom (5 DoF), 550mm 6DoF, 900mm 5DoF and 900mm 6DoF robotic arm configurations. In practice, each 5DoF has joint 4 at a fixed angle.
47 47  
48 - # Motion setup
59 +**Serial COM Port**
49 49  
50 - ORIGIN_OFFSET = "O"
61 +The first joint at the base (J1) must be connected via USB to a computer running the sofware. No other joints should have a USB connection. A USB 3.0 port or higher on the computer is suggested, as the lower communication speeds fo USB 2.0 or 1.0 may impede communication and cause unecessary delay or issues. 
51 51  
52 - ANGULAR_RANGE = "AR"
63 +**Connect**
53 53  
54 - ANGULAR_ACCELERATION = "AA"
65 +== Gripper Connection ==
55 55  
56 - ANGULAR_DECELERATION = "AD"
67 +**Model**
57 57  
58 - GYRE_DIRECTION = "G"
69 +The software currently supports two models of Lynxmotion PRO compatible grippers based on DH Robots' PGE-50-40 and CGE-10-10 electric grippers. The Lynxmotion kits include hardware to mount the fingers in multiple different offsets for smaller or larger objects. In the sequencer, the position of the fingers for each gripper are included in the sequencer as J7.
59 59  
60 - MAX_SPEED_DEGREES = "SD"
71 +**Serial COM Port**
61 61  
62 - MAX_SPEED_RPM = "SR"
73 +//{Coming Soon}//
63 63  
64 - # RGB LED
75 +**Baudrate**
65 65  
66 - LED_COLOR = "LED"
77 +//{Coming Soon}//
67 67  
68 - Query:
79 +**Connect**
69 69  
70 - # Communication setup
81 +//{Coming Soon}//
71 71  
72 - ID_NUMBER = "QID"
83 +**Calibrate**
73 73  
74 - ENABLE_CAN_TERMINAL = "QET"
85 +//{Coming Soon}//
75 75  
76 - USB_CONNECTION_STATUS = "QUC"
87 +**Speed**
77 77  
78 - # Motion
89 +//{Coming Soon}//
79 79  
80 - POSITION = "QD"
91 +**Force**
81 81  
82 - WHEEL_MODE_DEGREES = "QWD"
93 +//{Coming Soon}//
83 83  
84 - WHEEL_MODE_RPM = "QWR"
95 +**Open / Close**
85 85  
86 - MOTION_STATUS = "Q"
97 +//{Coming Soon}//
87 87  
88 - MOTION_TIME = "QMT"
99 +== 3D Model ==
89 89  
90 - CURRENT_SPEED = "QCS"
101 +The 3D model of the arm is shown as reference at all times. The display also includes a virtual plane to denote  the X-Y plane. The model updates based on the selection of the arm, gripper and finger configuration.
91 91  
103 +**View Controls**
92 92  
93 - # Telemetry
105 +//{Coming Soon}//
94 94  
95 - MODEL_STRING = "QMS" 
107 +== Manual Move ==
96 96  
97 - FIRMWARE_VERSION = "QF" 
109 +**Angular Control**
98 98  
99 - SERIAL_NUMBER = "QN" 
111 +In angular mode, the user can control the angle of each joint
100 100  
101 - TEMP_CONTROLLER_ERROR = "QTCE" 
113 +**Coordinates Control**
102 102  
103 - TEMP_CONTROLLER_WARNING = "QTCW" 
115 +In coordinate control the user can control the cartesian position of the end effector
104 104  
105 - CURRENT = "QC"
117 +**End Effector Lock**
106 106  
107 - ACCX = "QIX"
119 +The orientation of the end effector can be locked.
108 108  
109 - ACCY = "QIY"
121 +== Direct Command ==
110 110  
111 - ACCZ = "QIZ"
123 +This section allow the user to send commands using the [[doc:ses-pro.lss-pro.lss-p-communication-protocol.WebHome]] directly if required.
112 112  
113 - ACCALPHA = "QIA"
125 +A few things to keep in mind when using this:
114 114  
115 - ACCBETA = "QIB"
127 +* Make sure you know what you are doing as you can make the arm move in __dangerous__ ways.
128 +* Sending commands does not require ‘#’ and ‘\r’ chars.
129 +** example for #2\r you should enter 2Q and press the "SEND" button
130 +* The commands are validated, and it shows a notification in case of error.
131 +* The replies of queries are shown in the text field below.
116 116  
117 - ACCGAMMA = "QIG"
133 +== Command Output ==
118 118  
119 - TEMPMCU = "QTM"
135 +//{Coming Soon}//
120 120  
121 - TEMPPROBE = "QTP"
137 +== Telemetry ==
122 122  
123 - TEMPPCB = "QT"
139 +**Data to Display**
124 124  
125 - ERROR_FLAGS = "QEF"
141 +//{Coming Soon}//
126 126  
143 +**Display / Hide Actuator**
127 127  
128 - # RGB LED
145 +//{Coming Soon}//
129 129  
130 - LED_COLOR = "QLED"
147 +== Sequencer ==
131 131  
132 - LED_BLINKING = "QLB"
149 +**Frames**
133 133  
134 - LED_INDICATOR = "QLI"
151 +//{Coming Soon}//
135 135  
153 +**Record **
136 136  
137 - # Motion setup
155 +//{Coming Soon}//
138 138  
139 - ORIGIN_OFFSET = "QO"
157 +**Edit **
140 140  
141 - ANGULAR_RANGE = "QAR"
159 +Time, angles, gripper
142 142  
143 - ANGULAR_ACCELERATION = "QAA"
161 +//{Coming Soon}//
144 144  
145 - ANGULAR_DECELERATION = "QAD"
163 +**Reorder**
146 146  
147 - GYRE_DIRECTION = "QG"
165 +//{Coming Soon}//
148 148  
149 - MAX_SPEED_DEGREES = "QSD"
167 +**Play**
150 150  
151 - MAX_SPEED_RPM = "QSR"
169 +//{Coming Soon}//
152 152  
171 +**Errors**
153 153  
154 - Conf:
155 -
156 - # Communication setup
157 -
158 - ID_NUMBER = "CID"
159 -
160 - ENABLE_CAN_TERMINAL = "CET"
161 -
162 - USB_CONNECTION_STATUS = "CUC"
163 -
164 - # Motion setup
165 -
166 - MAX_SPEED_DEGREES = "CSD"
167 -
168 - MAX_SPEED_RPM = "CSR"
169 -
170 - ORIGIN_OFFSET = "CO"
171 -
172 - ANGULAR_RANGE = "CAR"
173 -
174 - ANGULAR_ACCELERATION = "CAA"
175 -
176 - ANGULAR_DECELERATION = "CAD"
177 -
178 - GYRE_DIRECTION = "CG"
179 -
180 - # RGB LED
181 -
182 - LED_COLOR = "CLED"
183 -
184 - LED_BLINKING = "CLB"
185 -
186 -
187 - Modifier:
188 -
189 - SPEED = "SD"
190 -
191 - TIME = "T"
173 +//{Coming Soon}//
ses-pro-robotic-arm-ui-installer.zip
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.ENantel
Size
... ... @@ -1,0 +1,1 @@
1 +212 bytes
Content
Copyright RobotShop 2018