Changes for page LSS Communication Protocol
Last modified by Eric Nantel on 2024/11/21 09:43
Change comment: There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -137,7 +137,7 @@ 137 137 | 23|**M**odel| | QM| | | | none (integer)| 138 138 | 24|Serial **N**umber| | QN| | | | none (integer)| 139 139 | 25|**F**irmware version| | QF| | | | none (integer)| 140 -| 26|**Q**uery (general status)| | Q| | | ✓| none (integer from 1 to 8)| 140 +| 26|**Q**uery (general status)| | Q| | | ✓| none (integer from 1 to 8)| See command description for details 141 141 | 27|**V**oltage| | QV| | | ✓| tenths of volt (ex 113 = 11.3V; 92 = 9.2V)| 142 142 | 28|**T**emperature| | QT| | | ✓| degrees Celsius| 143 143 | 29|**C**urrent| | QC| | | ✓| tenths of Amps (ex 2 = 0.2A)| ... ... @@ -232,10 +232,10 @@ 232 232 233 233 Query Position in Pulse (**QP**) 234 234 235 -Example: #5QP<cr> might return *5QP 235 +Example: #5QP<cr> might return *5QP2334 236 236 237 237 This command queries the current angular position in PWM "units". The user must take into consideration that the response includes any angular range and origin configurations in order to determine the actual angle. 238 -Valid values for QP are {-500, [500, 2500], -2500}. Values outside the [500, 2500] range are given a negative corresponding end point value to indicate they are out of bounds. 238 +Valid values for QP are {-500, [500, 2500], -2500}. Values outside the [500, 2500] range are given a negative corresponding end point value to indicate they are out of bounds (note that if the servo is physically located at one of the endpoints, it may return a negative number if it is a fraction of a degree beyond the position). 239 239 240 240 __9. Position in Degrees (**D**)__ 241 241 ... ... @@ -247,8 +247,10 @@ 247 247 248 248 Query Position in Degrees (**QD**) 249 249 250 -Example: #5QD<cr> might return *5QD 0<cr>250 +Example: #5QD<cr> might return *5QD132<cr> 251 251 252 +This means the servo is located at 13.2 degrees. 253 + 252 252 __10. Wheel Mode in Degrees (**WD**)__ 253 253 254 254 Ex: #5WD900<cr> ... ... @@ -287,10 +287,10 @@ 287 287 If #5QSD1<cr> is sent, the configured maximum speed (CSD value) will be returned instead. You can also query the current speed using "2" and the current target travel speed using "3". See the table below for an example: 288 288 289 289 |**Command sent**|**Returned value (1/10 °)** 290 -|ex: #5QSD<cr>| Currentsession value for maximum speed (set by latest SD/SR command)291 -|ex: #5QSD1<cr>|Cur rentmaximum speedconfigured(set by CSD/CSR)292 -|ex: #5QSD2<cr>| Current speed.293 -|ex: #5QSD3<cr>|Target travel speed .292 +|ex: #5QSD<cr>|Session value for maximum speed (set by latest SD/SR command) 293 +|ex: #5QSD1<cr>|Configured maximum speed (set by CSD/CSR) 294 +|ex: #5QSD2<cr>|Instantaneous speed (same as QWD) 295 +|ex: #5QSD3<cr>|Target travel speed 294 294 295 295 Configure Speed in Degrees (**CSD**) 296 296 ... ... @@ -312,10 +312,10 @@ 312 312 If #5QSR1<cr> is sent, the configured maximum speed (CSR value) will be returned instead. You can also query the current speed using "2" and the current target travel speed using "3". See the table below for an example: 313 313 314 314 |**Command sent**|**Returned value (1/10 °)** 315 -|ex: #5QSR<cr>| Currentsession value for maximum speed (set by latest SD/SR command)316 -|ex: #5QSR1<cr>|Cur rentmaximum speedconfigured(set by CSD/CSR)317 -|ex: #5QSR2<cr>| Current speed.318 -|ex: #5QSR3<cr>|Target travel speed .317 +|ex: #5QSR<cr>|Session value for maximum speed (set by latest SD/SR command) 318 +|ex: #5QSR1<cr>|Configured maximum speed (set by CSD/CSR) 319 +|ex: #5QSR2<cr>|Instantaneous speed (same as QWR) 320 +|ex: #5QSR3<cr>|Target travel speed 319 319 320 320 Configure Speed in RPM (**CSR**) 321 321 ... ... @@ -323,11 +323,11 @@ 323 323 324 324 Using the CSR command sets the servo's maximum speed which is saved in EEPROM. In the example above, the servo's maximum speed will be set to 45rpm. When the servo is powered on (or after a reset), the CSR value is used. Note that CSD and CSR are effectively the same, but allow the user to specify the speed in either unit. The last command (either CSR or CSD) is what the servo uses for that session. 325 325 326 -__14. Rigidity(R)__328 +__14. Angular Stiffness (AS)__ 327 327 328 -The servo's rigidity can be thought of as (though not identical to) a damped spring in which the rigidityvalue affects the stiffness and embodies how much, and how quickly the servo tried keep the requested position against changes.330 +The servo's rigidity / angular stiffness can be thought of as (though not identical to) a damped spring in which the value affects the stiffness and embodies how much, and how quickly the servo tried keep the requested position against changes. 329 329 330 -A positive value of " rigidity":332 +A positive value of "angular stiffness": 331 331 332 332 * The more torque will be applied to try to keep the desired position against external input / changes 333 333 * The faster the motor will reach its intended travel speed and the motor will decelerate faster and nearer to its target position ... ... @@ -339,17 +339,17 @@ 339 339 340 340 The default value is zero and the effect becomes extreme by -4, +4. There are no units, only integers between -4 to 4. Greater values produce increasingly erratic behavior. 341 341 342 -Ex: #5 R-2<cr>344 +Ex: #5AS-2<cr> 343 343 344 -This reduces the rigidityto -2 for that session, allowing the servo to deviate more around the desired position. This can be beneficial in many situations such as impacts (legged robots) where more of a "spring" effect is desired. Upon reset, the servo will use the value stored in memory, based on the last configuration command.346 +This reduces the angular stiffness to -2 for that session, allowing the servo to deviate more around the desired position. This can be beneficial in many situations such as impacts (legged robots) where more of a "spring" effect is desired. Upon reset, the servo will use the value stored in memory, based on the last configuration command. 345 345 346 -Ex: #5Q R<cr>348 +Ex: #5QAS<cr> 347 347 348 348 Queries the value being used. 349 349 350 -Ex: #5C R<cr>352 +Ex: #5CAS<cr> 351 351 352 -Writes the desired rigidityvalue to memory.354 +Writes the desired angular stiffness value to memory. 353 353 354 354 __15. N/A (removed)__ 355 355 ... ... @@ -371,7 +371,7 @@ 371 371 372 372 Configure LED Color (**CLED**) 373 373 374 -Configuring the LED color via the CLED command sets the startup color of the servo after a reset or power cycle. 376 +Configuring the LED color via the CLED command sets the startup color of the servo after a reset or power cycle. Note that it also changes the session's LED color immediately as well. 375 375 376 376 __17. Identification Number__ 377 377 ... ... @@ -432,13 +432,13 @@ 432 432 433 433 Ex: #5QFP<cr> might return *5QFP1550<cr> 434 434 435 -The reply above indicates that servo with ID 5 has a first position pulse of 1550 microseconds. 437 +The reply above indicates that servo with ID 5 has a first position pulse of 1550 microseconds. If no first position has been set, servo will respond with DIS ("disabled"). 436 436 437 -Configure First Position in Pulses (CFP) 439 +Configure First Position in Pulses (**CFP**) 438 438 439 439 Ex: #5CP1550<cr> 440 440 441 -This configuration command means the servo, when set to RC mode, will immediately move to an angle equivalent to having received an RC pulse of 1550 microseconds upon power up. Sending a CFP command without a number results in the servo remaining limp upon power up. 443 +This configuration command means the servo, when set to RC mode, will immediately move to an angle equivalent to having received an RC pulse of 1550 microseconds upon power up. Sending a CFP command without a number results in the servo remaining limp upon power up (i.e. disabled). 442 442 443 443 __21. First / Initial Position (Degrees)__ 444 444 ... ... @@ -482,9 +482,20 @@ 482 482 483 483 __26. Query Status (**Q**)__ 484 484 485 -Ex: #5Q<cr> might return *5Q _<cr>487 +Ex: #5Q<cr> might return *5Q6<cr>, which indicates the motor is holding a position. 486 486 487 -{Description coming soon} 489 +|*Value returned|**Status**|**Detailed description** 490 +|ex: *5Q0<cr>|Unknown|LSS is unsure 491 +|ex: *5Q1<cr>|Limp|Motor driving circuit is not powered and horn can be moved freely 492 +|ex: *5Q2<cr>|Free moving|Motor driving circuit is not powered and horn can be moved freely 493 +|ex: *5Q3<cr>|Accelerating|Increasing speed from rest (or previous speeD) towards travel speed 494 +|ex: *5Q4<cr>|Traveling|Moving at a stable speed 495 +|ex: *5Q5<cr>|Deccelerating|Decreasing speed towards travel speed towards rest 496 +|ex: *5Q6<cr>|Holding|Keeping current position 497 +|ex: *5Q7<cr>|Stepping|Special low speed mode to maintain torque 498 +|ex: *5Q8<cr>|Outside limits|More details coming soon 499 +|ex: *5Q9<cr>|Stuck|Motor cannot perform request movement at current speed setting 500 +|ex: *5Q10<cr>|Blocked|Similar to stuck, but the motor is at maxiumum duty and still cannot move (i.e.: stalled) 488 488 489 489 __27. Query Voltage (**QV**)__ 490 490