Changes for page LSS-P - Communication Protocol
Last modified by Eric Nantel on 2024/07/03 09:42
Change comment: There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -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" %) | | |((( 166 +| |[[**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 167 +| |[[**Q**uery **T**emp of **M**CU>>doc:||anchor="HQueryMCUTemperature28QTM29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTM|(% style="text-align:center" %) | | | 168 +| |[[**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) 173 +| |[[**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| 174 +| |[[**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| 175 +| |[[**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| 176 +| |[[**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) 177 +| |[[**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) 178 +| |[[**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__(%%) ====== 188 +|(% colspan="2" %)((( 189 +====== __Reset__ ====== 190 +))) 191 +| |((( 192 +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.194 +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. 195 +))) 193 193 197 +|(% colspan="2" %)((( 194 194 ====== (% style="color:inherit; font-family:inherit" %)__Default & confirm__(%%) ====== 195 - 199 +))) 200 +| |((( 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. 210 +))) 205 205 212 +|(% colspan="2" %)((( 206 206 ====== (% style="color:inherit; font-family:inherit" %)__Update & confirm__(%%) ====== 207 - 214 +))) 215 +| |((( 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,16 +214,18 @@ 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. 225 +))) 217 217 218 -= =====(% style="color:inherit; font-family:inherit" %)__Confirm__(%%) ======219 - 227 +|(% colspan="2" %)(% style="color:inherit; font-family:inherit" %)__Confirm__ 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**)__(%%) ======226 - 235 +|(% colspan="2" %)(% style="color:inherit; font-family:inherit" %)__ID Number (**ID**)__ 236 +|(% style="width:30px" %) |((( 227 227 (% style="color:inherit; font-family:inherit" %)Configure ID Number (**CID**) 228 228 229 229 (% style="color:inherit; font-family:inherit" %)Ex: #0CID5<cr> ... ... @@ -235,9 +235,10 @@ 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. 248 +))) 238 238 239 -= =====(% style="color:inherit; font-family:inherit" %)__Enable CAN Terminal Resistor (**ET**)__(%%) ======240 - 250 +|(% colspan="2" %)(% style="color:inherit; font-family:inherit" %)__Enable CAN Terminal Resistor (**ET**)__ 251 +|(% style="width:30px" %) |((( 241 241 Query Enable CAN Terminal Resistor (**QET**) 242 242 243 243 Ex: #5QET<cr> might return *QET0<cr> ... ... @@ -249,21 +249,37 @@ 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. 263 +))) 252 252 253 -= =====__USB Connection Status (**UC**)__======254 - 265 +|(% colspan="2" %)__USB Connection Status (**UC**)__ 266 +|(% 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 270 +))) 258 258 259 -= =====__Firmware Release (**FR**)__======260 - 272 +|(% colspan="2" %)__Firmware Release (**FR**)__ 273 +|(% 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. 279 +))) 266 266 281 +====== ====== 282 + 283 + 284 +====== ====== 285 + 286 + 287 +====== ====== 288 + 289 + 290 +====== ====== 291 + 292 + 293 + 267 267 == Motion == 268 268 269 269 ====== __Position in Degrees (**D**)__ ====== ... ... @@ -557,23 +557,27 @@ 557 557 558 558 == Telemetry == 559 559 560 -====== __Query Voltage (**QV**)__ ======587 +====== __Query PCB Temperature (**QT**)__ ====== 561 561 562 -Ex: #5Q V<cr> might return *5QV11200<cr>589 +Ex: #5QT<cr> might return *5QT564<cr> 563 563 564 -The numberreturnedisinmilliVolts, so in thecase above, servowithID5hasaninputvoltageof 11.2V.591 +The units are in tenths of degrees Celcius, so in the example above, the servo's internal temperature is 56.4 degrees C. To convert from degrees Celcius to degrees Farenheit, multiply by 1.8 and add 32. Therefore 56.4C = 133.52F. 565 565 566 -====== __Query Temperature (**QT**)__ ====== 593 +====== __Query Temperature Probe (**QTP**)__ ====== 567 567 568 -Ex: #5QT<cr> might return *5QT564<cr>595 +Ex: 569 569 570 - Theunits arein tenths of degreesCelcius, so in the exampleabove,the servo's internal temperature is 56.4 degreesC. Toconvertfrom degrees Celcius to degrees Farenheit, multiply by 1.8 and add 32. Therefore56.4C =133.52F.597 +====== __Query Temp of Controller (**QTCW**)__ ====== 571 571 572 - ====== __Query Motor Driver Current (**QC**)__ ======599 +Ex: 573 573 601 +An alternative is QTCE 602 + 603 +====== __Query Current (**QC**)__ ====== 604 + 574 574 Ex: #5QC<cr> might return *5QC140<cr> 575 575 576 -The units are in milliamps, so in the example above, the servo is consuming 140mA, or 0.14A. It represents the RMS value. 607 +The units are in milliamps, so in the example above, the servo is consuming 140mA, or 0.14A. It represents the RMS value. The query calculates the RMS value of the current sent from the motor driver to the stepper motor. 577 577 578 578 ====== __Query Model String (**QMS**)__ ====== 579 579 ... ... @@ -592,3 +592,17 @@ 592 592 Ex: #5QN<cr> might return *5QN12345678<cr> 593 593 594 594 The number in the response (12345678) would be the servo's serial number which is set and should not be changed by the user. 626 + 627 +====== __Query IMU Linear (**QIX** **QIY** **QIZ**)__ ====== 628 + 629 +Ex: #6QIX<cr> might return *6QIX30<cr> 630 + 631 +This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 30mm per second squared. 632 + 633 +====== __Query IMU Angular (**QIA** **QIB** **QIC**)__ ====== 634 + 635 +Ex: #6QIB<cr> might return *6QIB44<cr> 636 + 637 +This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 4.4 degrees per second squared. 638 + 639 +