Wiki source code of SES-PRO Robotic Arm UI

Version 25.1 by Eric Nantel on 2024/10/09 15:53

Show last authors
1 {{lightbox image="https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/ses-pro/ses-pro-software/ses-pro-arm-ui/WebHome/LSS-PRO-UI.png" width="350"/}}
2
3 [[image:[email protected]]]
4
5 **Table of Contents**
6
7 {{toc/}}
8
9 = Installation =
10
11 Windows 7 Operating System or above
12
13 = Description =
14
15 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.
16
17 = Features =
18
19 * Angular and cartesian positioning of the end effector
20 * 3D graphical display of the appropriate robotic arm and end effector
21 * Sequencer to record and play back frames (single, looped or infinite)
22 * Error checking (speed, temperature etc.)
23 * Command output and user input
24 * Safety (Software E-Stop, Halt&Hold & Limp)
25
26 |(% colspan="2" %)(((
27 = =
28 )))
29 |(% style="width:25px" %) |(((
30
31 )))
32 |(% colspan="2" %)User Guide
33 | |(((
34 Pressing the i "Information" icon in the software will bring you to this page. Before proceeding with the guide, it is important to note the following:
35
36 * 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
37 * 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
38 )))
39 | |
40 | |
41 | |
42 | |
43 | |
44 | |
45 | |
46 | |
47 | |
48 | |
49 | |
50 | |
51 | |
52 | |
53 | |
54 | |
55 | |
56 | |
57 | |
58 | |
59 | |
60 | |
61 | |
62 | |
63 | |
64 | |
65 | |
66 | |
67 | |
68 | |
69 | |
70 | |
71 | |
72 | |
73 | |
74 | |
75 | |
76 | |
77 | |
78 | |
79 | |
80 | |
81 | |
82 | |
83 | |
84 | |
85 | |
86 | |
87 | |
88 | |
89 | |
90 | |
91 | |
92 | |
93 | |
94 | |
95 | |
96 | |
97 | |
98 | |
99 | |
100 | |
101 | |
102 | |
103 | |
104 | |
105 | |
106 | |
107 | |
108 | |
109 | |
110
111 (% class="wikigeneratedid" %)
112 = =
113
114 = User Guide =
115
116 Pressing the i "Information" icon in the software will bring you to this page. Before proceeding with the guide, it is important to note the following:
117
118 * 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
119 * 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
120
121 == IMPORTANT: Payload Considerations ==
122
123 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.
124 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.
125 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.
126 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".
127
128 == IMPORTANT: Emergency ==
129
130 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:
131
132 **Halt & Hold**
133
134 This will stop every joints and hold them in their last recorded angular positions. The corresponding command is #254H<cr>.
135
136 **Limp**
137
138 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>.
139
140 **Software Stop**
141
142 The E-stop button within the software sets all joints to limp.
143
144 **Hardware E-Stop**
145 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.
146
147 == Arm Connection ==
148
149 **Model**
150
151 The software currently supports the following Lynxmotion PRO Arms:
152
153 * 550mm 5DoF
154 * 550mm 6DoF
155 * 900mm 5DoF
156 * 900mm 6DoF
157
158 In practice, each 5DoF arm has joint 4 at a fixed angle, otherwise the arms are identical to the 6DoF. Users can always purchase the missing actuator to upgrade to a 6DoF.
159
160 **COM Port**
161
162 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. 
163
164 **Connect**
165
166 Once the COM port has been selection, the CONNECT button can be pressed, and once a servo has been found, the light next to it will go from red to green.
167
168 == Gripper Controls ==
169
170 **Model**
171
172 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.
173
174 * PGE-50-40 (40mm default configuration)
175 * PGE-50-40 (60mm configuration)
176 * PGE-50-40 (80mm configuration)
177 * CGE-10-10 (20mm configuration)
178 * CGE-10-10 (40mm configuration)
179 * CGE-10-10 (60mm configuration)
180
181 **COM Port**
182
183 Choose the appropriate COM port to which the gripper is connected (via its own USB cable). If you are not certain, you can check Windows -> Device Manager
184
185 **Baudrate**
186
187 The DH Robotics grippers provide the option to change the baud rate, though the default is 115200. If the gripper is configured by the user to a different baud rate, it is important to select the corresponding baud rate in teh software.
188
189 **Initialize**
190
191 Initializing the gripper opens it fully. This is available should the user encounter issues with positioning and need to re-zero the fingers.
192
193 **Connect**
194
195 Pressing CONNECT establishes a connection to the gripper and goes through the initilization process once, opening the gripper fully. Once connection has been established, the light next to the button will go from red to green.
196
197 **Speed**
198
199 The speed of motion can be adjusted either via the plus or minus buttons or entering a value between 0 and 100 and pressing enter.
200
201 **Force**
202
203 The maximum force exerted by the gripper can be adjusted either via the plus or minus buttons or entering a value between 0 and 100 and pressing enter.
204
205 **Open / Close**
206
207 These are shortcut buttons to either fully open or fully close the gripper.
208
209 **Sequencer**
210
211 The sequencer displays the gripper position as joint 7 (J7).
212
213 HINT: If you want the gripper to open or close on an object only at the end of a motion, create a separate frame where only J7 moves.
214
215 == 3D Model ==
216
217 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.
218
219 **View Controls**
220
221 Zoom: Shift + Middle Scroll
222
223 Rotate: Shift + Middle Mouse
224
225 Pan: None
226
227 == Manual Move ==
228
229 **Angular Control**
230
231 In angular mode, the user can control the angle of each joint
232
233 **Coordinates Control**
234
235 In coordinate control the user can control the cartesian position of the end effector
236
237 **End Effector Lock**
238
239 The orientation of the end effector can be locked.
240
241 == Direct Command ==
242
243 This section allow the user to send commands using the [[doc:ses-pro.lss-pro.lss-p-communication-protocol.WebHome]] directly if required.
244
245 A few things to keep in mind when using this:
246
247 * Make sure you know what you are doing as you can make the arm move in __dangerous__ ways.
248 * Sending commands does not require ‘#’ and ‘\r’ chars.
249 ** example for #2\r you should enter 2Q and press the "SEND" button
250 * The commands are validated, and it shows a notification in case of error.
251 * The replies of queries are shown in the text field below.
252
253 == Command Output ==
254
255 //{Coming Soon}//
256
257 == Telemetry ==
258
259 **Data to Display**
260
261 //{Coming Soon}//
262
263 **Display / Hide Actuator**
264
265 //{Coming Soon}//
266
267 == Sequencer ==
268
269 **Frames**
270
271 //{Coming Soon}//
272
273 **Record **
274
275 //{Coming Soon}//
276
277 **Edit **
278
279 Time, angles, gripper
280
281 //Alt + Left Click = Drag time//
282
283 **Reorder**
284
285 //{Coming Soon}//
286
287 **Play**
288
289 //{Coming Soon}//
290
291 **Errors**
292
293 //{Coming Soon}//
Copyright RobotShop 2018