Last modified by Eric Nantel on 2024/07/03 09:42

From version < 52.1 >
edited by Coleman Benson
on 2023/07/27 12:13
To version < 64.2 >
edited by Eric Nantel
on 2024/07/03 09:41
< >
Change comment: Update document after refactoring.

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -lynxmotion-smart-servo-pro.WebHome
1 +ses-pro-archive.lynxmotion-smart-servo-pro.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.CBenson
1 +xwiki:XWiki.ENantel
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -1,7 +1,5 @@
1 1  {{warningBox warningText="More information coming soon"/}}
2 2  
3 -
4 -
5 5  (% class="wikigeneratedid" id="HTableofContents" %)
6 6  **Page Contents**
7 7  
... ... @@ -163,20 +163,19 @@
163 163  | |[[**Q**uery **M**odel **S**tring>>||anchor="HQueryModelString28QMS29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QMS|(% style="text-align:center" %) | | |Returns the model of servo (ex: LSS-ST1, LSS-HS1, LSS-HT1)
164 164  | |[[**Q**uery **F**irmware Version>>||anchor="HQueryFirmware28QF29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QF|(% style="text-align:center" %) | | |
165 165  | |[[**Q**uery Serial **N**umber>>||anchor="HQuerySerialNumber28QN29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QN|(% style="text-align:center" %) | | |Returns the unique serial number for the servo
166 -| |**Q**uery **T**emperature **P**robe|(% style="text-align:center" %) |(% style="text-align:center" %)QTP|(% style="text-align:center" %) | | |Queries temperature probe fixed to the stepper motor
167 -| |**Q**uery **T**emp of **M**CU|(% style="text-align:center" %) |(% style="text-align:center" %)QTM|(% style="text-align:center" %) | | |
168 -| |**Q**uery **T**emp of **C**ontroller|(% style="text-align:center" %) |(% style="text-align:center" %)QTCW, QTCE|(% style="text-align:center" %) | | |(((
164 +| |[[**Q**uery **T**emperature **P**robe>>doc:||anchor="HQueryTemperatureProbe28QTP29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTP|(% style="text-align:center" %) | | |Queries temperature probe fixed to the stepper motor
165 +| |[[**Q**uery **T**emp of **M**CU>>doc:||anchor="HQueryMCUTemperature28QTM29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTM|(% style="text-align:center" %) | | |
166 +| |[[**Q**uery **T**emp of **C**ontroller>>doc:||anchor="HQueryTempofController28QTCW29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTCW, QTCE|(% style="text-align:center" %) | | |(((
169 169  QTCW: Queries the temperature status of the motor controller (pre-warning)
170 170  
171 171  QTCE: Queries the temperature status of the motor controller (over-temp error)
172 172  )))
173 -| |**Q**uery **C**urrent **S**peed |(% style="text-align:center" %) |(% style="text-align:center" %)QCS|(% style="text-align:center" %) | | |Queries the motor controller's calculated speed
174 -| |**Q**uery **I**MU Linear **X**|(% style="text-align:center" %) |(% style="text-align:center" %)QIX|(% style="text-align:center" %) | |mm/s^2|
175 -| |**Q**uery **I**MU Linear **Y**|(% style="text-align:center" %) |(% style="text-align:center" %)QIY|(% style="text-align:center" %) | |mm/s^2|
176 -| |**Q**uery **I**MU Linear **Z**|(% style="text-align:center" %) |(% style="text-align:center" %)QIZ|(% style="text-align:center" %) | |mm/s^2|
177 -| |**Q**uery **I**MU Angular Accel **α** |(% style="text-align:center" %) |(% style="text-align:center" %)QIA|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel α (Alpha)
178 -| |**Q**uery **I**MU Angular Accel **β**|(% style="text-align:center" %) |(% style="text-align:center" %)QIB|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel β (Beta)
179 -| |**Q**uery **I**MU Angular Accel **γ**|(% style="text-align:center" %) |(% style="text-align:center" %)QIC / QIG|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel γ (Gamma)
171 +| |[[**Q**uery **I**MU Linear **X**>>doc:||anchor="HQueryIMULinear28QIXQIYQIZ29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIX|(% style="text-align:center" %) | |mm/s^2|
172 +| |[[**Q**uery **I**MU Linear **Y**>>doc:||anchor="HQueryIMULinear28QIXQIYQIZ29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIY|(% style="text-align:center" %) | |mm/s^2|
173 +| |[[**Q**uery **I**MU Linear **Z**>>doc:||anchor="HQueryIMULinear28QIXQIYQIZ29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIZ|(% style="text-align:center" %) | |mm/s^2|
174 +| |[[**Q**uery **I**MU Angular Accel **α** >>doc:||anchor="HQueryIMUAngular28QIAQIBQIC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIA|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel α (Alpha)
175 +| |[[**Q**uery **I**MU Angular Accel **β**>>doc:||anchor="HQueryIMUAngular28QIAQIBQIC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIB|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel β (Beta)
176 +| |[[**Q**uery **I**MU Angular Accel **γ**>>doc:||anchor="HQueryIMUAngular28QIAQIBQIC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIC / QIG|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel γ (Gamma)
180 180  
181 181  |(% colspan="8" style="color:orange; font-size:18px" %)[[**RGB LED**>>||anchor="HRGBLED"]]
182 182  |(% style="width:25px" %) |(% style="width:200px" %)**Description**|(% style="text-align:center; width:100px" %)**Action**|(% style="text-align:center; width:75px" %)**Query**|(% style="text-align:center; width:75px" %)**Config**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes**
... ... @@ -186,13 +186,19 @@
186 186  
187 187  == (% style="color:inherit; font-family:inherit" %)Communication Setup(%%) ==
188 188  
189 -====== (% style="color:inherit; font-family:inherit" %)__Reset__(%%) ======
186 +|(% colspan="2" %)(((
187 +====== __Reset__ ======
188 +)))
189 +| |(((
190 +Ex: #5RESET<cr>
190 190  
191 -(% style="color:inherit; font-family:inherit" %)Ex: #5RESET<cr>
192 -This command does a "soft reset" and reverts all commands to those stored in EEPROM (i.e. configuration commands). Note: after a RESET command is received, the LSS will restart and perform initilization again, making it unavailable on the bus for a bit. See Session, note #2 for more details.
192 +This command does a "soft reset" and reverts all commands to those stored in EEPROM (i.e. configuration commands). Note: after a RESET command is received, the LSS will restart and perform initilization again, making it unavailable on the bus for a bit. See Session, note #2 for more details.
193 +)))
193 193  
195 +|(% colspan="2" %)(((
194 194  ====== (% style="color:inherit; font-family:inherit" %)__Default & confirm__(%%) ======
195 -
197 +)))
198 +|(% style="width:30px" %) |(((
196 196  (% style="color:inherit; font-family:inherit" %)Ex: #5DEFAULT<cr>
197 197  
198 198  (% style="color:inherit; font-family:inherit" %)This command sets in motion the reset of all values to the default values included with the version of the firmware installed on that servo. The servo then waits for the CONFIRM command. Any other command received will cause the servo to exit the DEFAULT function.
... ... @@ -202,9 +202,12 @@
202 202  (% style="color:inherit; font-family:inherit" %)Since it it not common to have to restore all configurations, a confirmation command is needed after a firmware command is sent. Should any command other than CONFIRM be received by the servo after the firmware command has been received, it will exit the command.
203 203  
204 204  (% style="color:inherit; font-family:inherit" %)Note: After the CONFIRM command is sent, the servo will automatically perform a RESET.
208 +)))
205 205  
210 +|(% colspan="2" %)(((
206 206  ====== (% style="color:inherit; font-family:inherit" %)__Update & confirm__(%%) ======
207 -
212 +)))
213 +|(% style="width:30px" %) |(((
208 208  (% style="color:inherit; font-family:inherit" %)Ex: #5UPDATE<cr>
209 209  
210 210  (% style="color:inherit; font-family:inherit" %)This command sets in motion the equivalent of a long button press when the servo is not powered in order to enter firmware update mode. This is useful should the button be broken or inaccessible. The servo then waits for the CONFIRM command. Any other command received will cause the servo to exit the UPDATE function.
... ... @@ -214,15 +214,23 @@
214 214  (% style="color:inherit; font-family:inherit" %)Since it it not common to have to update firmware, a confirmation command is needed after an UPDATE command is sent. Should any command other than CONFIRM be received by the servo after the firmware command has been received, it will leave the firmware action.
215 215  
216 216  (% style="color:inherit; font-family:inherit" %)Note: After the CONFIRM command is sent, the servo will automatically perform a RESET.
223 +)))
217 217  
225 +|(% colspan="2" %)(((
218 218  ====== (% style="color:inherit; font-family:inherit" %)__Confirm__(%%) ======
219 -
227 +)))
228 +|(% style="width:30px" %) |(((
220 220  (% style="color:inherit; font-family:inherit" %)Ex: #5CONFIRM<cr>
221 221  
222 222  (% style="color:inherit; font-family:inherit" %)This command is used to confirm changes after a Default or Update command.
223 223  Note: After the CONFIRM command is sent, the servo will automatically perform a RESET.
233 +)))
224 224  
225 -====== (% style="color:inherit; font-family:inherit" %)__ID Number (**ID**)__(%%) ======
235 +|(% colspan="2" %)(((
236 +====== (% style="color:inherit; font-family:inherit" %)__ID Number__(%%) ======
237 +)))
238 +|(% style="width:30px" %) |(((
239 +This assigns ID #5 to the servo previously assigned to ID 0
226 226  
227 227  (% style="color:inherit; font-family:inherit" %)Configure ID Number (**CID**)
228 228  
... ... @@ -235,9 +235,12 @@
235 235  Ex: #254QID<cr> might return *254QID5<cr>
236 236  
237 237  In this case, the broadcast ID is used to ensure the servo connected will reply with the ID. This can be used in case the ID assigned to a servo is forgotten.
252 +)))
238 238  
239 -====== (% style="color:inherit; font-family:inherit" %)__Enable CAN Terminal Resistor (**ET**)__(%%) ======
240 -
254 +|(% colspan="2" %)(((
255 +====== (% style="color:inherit; font-family:inherit" %)__Enable CAN Terminal Resistor__(%%) ======
256 +)))
257 +|(% style="width:30px" %) |(((
241 241  Query Enable CAN Terminal Resistor (**QET**)
242 242  
243 243  Ex: #5QET<cr> might return *QET0<cr>
... ... @@ -249,24 +249,35 @@
249 249  (% style="color:inherit; font-family:inherit" %)Ex: #5CET1<cr>
250 250  
251 251  (% style="color:inherit; font-family:inherit" %)This commands sets servo with ID 5 as being the last in the CAN Bus. The last servo in a CAN bus must be configured this way.
269 +)))
252 252  
253 -====== __USB Connection Status (**UC**)__ ======
254 -
271 +|(% colspan="2" %)(((
272 +====== __USB Connection Status__ ======
273 +)))
274 +|(% style="width:30px" %) |(((
255 255  Query USB Connection Status (**QUC**)
256 256  
257 257  Ex: #5QUC<cr> might return *5QUC1<cr> meaning the servo is connected via USB
278 +)))
258 258  
259 -====== __Firmware Release (**FR**)__ ======
260 -
280 +|(% colspan="2" %)(((
281 +====== __Firmware Release__ ======
282 +)))
283 +|(% style="width:30px" %) |(((
261 261  Query Firmware Release (**QFR**)
262 262  
263 263  Ex: #5QFR<cr> might return *QFR11<cr> meaning it has a (random) firmware release version number 11.
264 264  
265 265  This is used to verify if the firmware on the servos is up to date, or which version is running on the microcontroller.
289 +)))
266 266  
267 267  == Motion ==
268 268  
269 -====== __Position in Degrees (**D**)__ ======
293 +|(% colspan="2" %)(((
294 +====== __Position in Degrees__ ======
295 +)))
296 +|(% style="width:30px" %) |(((
297 +Position in Degrees (**D**)
270 270  
271 271  Example: #5D1456<cr>
272 272  
... ... @@ -285,15 +285,24 @@
285 285  Ex: #5QDT<cr> might return *5QDT6783<cr>
286 286  
287 287  The query target position command returns the target virtual position during and after an action which results in a rotation of the servo horn. In the example above, the servo is rotating to a virtual position of 678.3 degrees. Should the servo not have a target position or be in wheel mode, it will respond with the last target position used.
316 +)))
288 288  
289 -====== __(Relative) Move in Degrees (**MD**)__ ======
318 +|(% colspan="2" %)(((
319 +====== __(Relative) Move in Degrees__ ======
320 +)))
321 +|(% style="width:30px" %) |(((
322 +Move in Degrees (**MD**)
290 290  
291 -
292 292  Example: #5MD123<cr>
293 293  
294 294  The relative move command causes the servo to read its current position and move the specified number of tenths of degrees in the corresponding position. For example if the servo is set to rotate CW (default) and an MD command of 123 is sent to the servo, it will cause the servo to rotate clockwise by 12.3 degrees. Negative commands would cause the servo to rotate in the opposite configured direction.
327 +)))
295 295  
296 -====== __Wheel Mode in Degrees (**WD**)__ ======
329 +|(% colspan="2" %)(((
330 +====== __Wheel Mode in Degrees__ ======
331 +)))
332 +|(% style="width:30px" %) |(((
333 +Wheel mode in Degrees (**WD**)
297 297  
298 298  Ex: #5WD90<cr>
299 299  
... ... @@ -304,8 +304,13 @@
304 304  Ex: #5QWD<cr> might return *5QWD90<cr>
305 305  
306 306  The servo replies with the angular speed in degrees per second. A negative sign would indicate the opposite direction (for factory default a negative value would be counter clockwise).
344 +)))
307 307  
308 -====== __Wheel Mode in RPM (**WR**)__ ======
346 +|(% colspan="2" %)(((
347 +====== __Wheel Mode in RPM__ ======
348 +)))
349 +|(% style="width:30px" %) |(((
350 +Wheel moed in RPM (**WR**)
309 309  
310 310  Ex: #5WR40<cr>
311 311  
... ... @@ -316,8 +316,14 @@
316 316  Ex: #5QWR<cr> might return *5QWR40<cr>
317 317  
318 318  The servo replies with the angular speed in rpm. A negative sign would indicate the opposite direction (for factory default a negative value would be counter clockwise).
361 +)))
319 319  
320 -====== __(Relative) Move in Degrees (**MD**)__ ======
363 +|(% colspan="2" %)(((
364 +====== __(Relative) Move in Degrees__ ======
365 +)))
366 +|(% style="width:30px" %) |(((
367 +(% class="wikigeneratedid" %)
368 +Move in Degrees (**MD**)
321 321  
322 322  (% class="wikigeneratedid" id="HExample:235M15003Ccr3E" %)
323 323  Example: #5M1500<cr>
... ... @@ -324,8 +324,13 @@
324 324  
325 325  (% class="wikigeneratedid" id="HTherelativemoveinPWMcommandcausestheservotoreaditscurrentpositionandmovebythespecifiednumberofPWMsignal.ForexampleiftheservoissettorotateCW28default29andanMcommandof1500issenttotheservo2Citwillcausetheservotorotateclockwiseby90degrees.NegativePWMvaluewouldcausetheservotorotateintheoppositeconfigureddirection." %)
326 326  The relative move in PWM command causes the servo to read its current position and move by the specified number of PWM signal. For example if the servo is set to rotate CW (default) and an M command of 1500 is sent to the servo, it will cause the servo to rotate clockwise by 90 degrees. Negative PWM value would cause the servo to rotate in the opposite configured direction.
375 +)))
327 327  
328 -====== __Query Status (**Q**)__ ======
377 +|(% colspan="2" %)(((
378 +====== __Query Status__ ======
379 +)))
380 +|(% style="width:30px" %) |(((
381 +Query Status (**Q**)
329 329  
330 330  The status query describes what the servo is currently doing. The query returns an integer which must be looked up in the table below.
331 331  
... ... @@ -338,7 +338,7 @@
338 338  | |ex: *5Q3<cr>|3: Accelerating|Increasing speed from rest (or previous speed) towards travel speed
339 339  | |ex: *5Q4<cr>|4: Traveling|Moving at a stable speed
340 340  | |ex: *5Q5<cr>|5: Decelerating|Decreasing from travel speed towards final position.
341 -| |ex: *5Q6<cr>|6: Holding|Keeping current position (in EM0 mode, return will nornally be holding)
394 +| |ex: *5Q6<cr>|6: Holding|Keeping current position (in EM0 mode, return will normally be holding)
342 342  | |ex: *5Q7<cr>|7: Outside limits|{More details coming soon}
343 343  | |ex: *5Q8<cr>|8: Stuck|Motor cannot perform request movement at current speed setting
344 344  | |ex: *5Q9<cr>|9: Blocked|Similar to stuck, but the motor is at maximum duty and still cannot move (i.e.: stalled)
... ... @@ -355,18 +355,29 @@
355 355  | |ex: *5Q1<cr>|Current limit has been passed|Something cause the current to either spike, or remain too high for too long
356 356  | |ex: *5Q2<cr>|Input voltage detected is below or above acceptable range|Check the voltage of your batteries or power source
357 357  | |ex: *5Q3<cr>|Temperature limit has been reached|The servo is too hot to continue operating safely.
411 +)))
358 358  
359 -====== __Limp (**L**)__ ======
413 +|(% colspan="2" %)(((
414 +====== __Limp__ ======
415 +)))
416 +|(% style="width:30px" %) |(((
417 +Limp (**L**)
360 360  
361 361  Example: #5L<cr>
362 362  
363 363  This action causes the servo to go "limp". The microcontroller will still be powered, but the motor will not. As an emergency safety feature, should the robot not be doing what it is supposed to or risks damage, use the broadcast ID to set all servos limp #254L<cr>.
422 +)))
364 364  
365 -====== __Halt & Hold (**H**)__ ======
424 +|(% colspan="2" %)(((
425 +====== __Halt & Hold__ ======
426 +)))
427 +|(% style="width:30px" %) |(((
428 +Halt & Hold (**H**)
366 366  
367 367  Example: #5H<cr>
368 368  
369 369  This command causes the servo to stop immediately and hold that angular position. It overrides whatever the servo might be doing at the time the command is received (accelerating, travelling, deccelerating, etc.)
433 +)))
370 370  
371 371  == Motion Setup ==
372 372  
... ... @@ -567,10 +567,12 @@
567 567  
568 568  Ex:
569 569  
570 -====== __Query Temp of Controller (**QTCW**, **QTCE**)__ ======
634 +====== __Query Temp of Controller (**QTCW**)__ ======
571 571  
572 572  Ex:
573 573  
638 +An alternative is QTCE
639 +
574 574  ====== __Query Current (**QC**)__ ======
575 575  
576 576  Ex: #5QC<cr> might return *5QC140<cr>
... ... @@ -595,13 +595,13 @@
595 595  
596 596  The number in the response (12345678) would be the servo's serial number which is set and should not be changed by the user.
597 597  
598 -====== __Query IMU Linear (**QIX**, **QIY**, **QIZ**)__ ======
664 +====== __Query IMU Linear (**QIX** **QIY** **QIZ**)__ ======
599 599  
600 600  Ex: #6QIX<cr> might return *6QIX30<cr>
601 601  
602 602  This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 30mm per second squared.
603 603  
604 -__Query IMU Angular (**QIA**, **QIB**, **QIC**)__
670 +====== __Query IMU Angular (**QIA** **QIB** **QIC**)__ ======
605 605  
606 606  Ex: #6QIB<cr> might return *6QIB44<cr>
607 607  
Copyright RobotShop 2018