Changes for page LSS-PRO Communication Protocol
Last modified by Eric Nantel on 2024/09/06 14:52
Change comment: There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -124,10 +124,10 @@ 124 124 | |[[**Default** Configuration>>||anchor="HDefault26confirm"]]|(% style="text-align:center" %)DEFAULT|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Revert to firmware default values. See command for details 125 125 | |[[Firmware **Update** Mode>>||anchor="HUpdate26confirm"]]|(% style="text-align:center" %)UPDATE|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Update firmware. See command for details. 126 126 | |[[**Confirm** Changes>>||anchor="HConfirm"]]|(% style="text-align:center" %)CONFIRM|(% style="text-align:center" %) |(% style="text-align:center" %) | | | 127 -| |[[** E**nableCAN**T**erminal>>||anchor="HConfigureRCMode28CRC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QET|(% style="text-align:center" %)CET| |0or1|0:Disable1:Enable128 -| |[[** ID** NumberIdentificationNumber28ID29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QID|(% style="text-align:center" %)CID|0||Resetrequiredafterchange. ID254is"broadcast"whichall servos respond to.129 -| |[[**U**SB **C**onnection Stat e>>||anchor="HBaudRate"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QUC|(% style="text-align:center" %) | |0 or 1|0: Not connected 1: Connected130 -| |**Q**uery **F**irmware **R**elease|(% style="text-align:center" %) |(% style="text-align:center" %)QFR|(% style="text-align:center" %) | | | 127 +| |[[**ID** Number >>||anchor="HIDNumber28ID29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QID|(% style="text-align:center" %)CID|0| |Reset required after change. ID 254 is a "broadcast" which all servos respond to. 128 +| |[[**E**nable CAN **T**erminal>>doc:||anchor="HEnableCANTerminalResistor28ET29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QET|(% style="text-align:center" %)CET| |0 or 1|0: Disable 1: Enable 129 +| |[[**U**SB **C**onnection Status>>||anchor="HUSBConnectionStatus28UC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QUC|(% style="text-align:center" %) | |0 or 1|0: Not connected 1: Connected 130 +| |[[**Q**uery **F**irmware **R**elease>>doc:||anchor="HFirmwareRelease28FR29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QFR|(% style="text-align:center" %) | | | 131 131 132 132 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Motion**>>||anchor="HMotion"]] 133 133 |(% 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** ... ... @@ -141,19 +141,15 @@ 141 141 142 142 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Motion Setup**>>||anchor="HMotionSetup"]] 143 143 |(% 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** 144 -| |[[**E**nable **M**otion Profile>>||anchor="HEnableMotionProfile28EM29"]]|(% style="text-align:center" %)EM|(% style="text-align:center" %)QEM|(% style="text-align:center" %)CEM|1| |EM1: trapezoidal motion profile / EM0: no motion profile 145 -| |[[**F**ilter **P**osition **C**ount>>||anchor="HFilterPositionCount28FPC29"]]|(% style="text-align:center" %)FPC|(% style="text-align:center" %)QFPC|(% style="text-align:center" %)CFPC|5| |Affects motion only when motion profile is disabled (EM0) 146 146 | |[[**O**rigin Offset>>||anchor="HOriginOffset28O29"]]|(% style="text-align:center" %)O|(% style="text-align:center" %)QO|(% style="text-align:center" %)CO|0|1/10°| 147 147 | |[[**A**ngular **R**ange>>||anchor="HAngularRange28AR29"]]|(% style="text-align:center" %)AR|(% style="text-align:center" %)QAR|(% style="text-align:center" %)CAR|1800|1/10°| 148 -| |[[**A**ngular **S**tiffness>>||anchor="HAngularStiffness28AS29"]]|(% style="text-align:center" %)AS|(% style="text-align:center" %)QAS|(% style="text-align:center" %)CAS|0|-4 to +4 integer|Suggested values are between 0 to +4 149 -| |[[**A**ngular **H**olding Stiffness>>||anchor="HAngularHoldingStiffness28AH29"]]|(% style="text-align:center" %)AH|(% style="text-align:center" %)QAH|(% style="text-align:center" %)CAH|4|-10 to +10 integer| 150 150 | |[[**A**ngular **A**cceleration>>||anchor="HAngularAcceleration28AA29"]]|(% style="text-align:center" %)AA|(% style="text-align:center" %)QAA|(% style="text-align:center" %)CAA|100|°/s^^2^^|Increments of 10°/s^^2^^. Only when motion profile is enabled (EM1). 151 151 | |[[**A**ngular **D**eceleration>>||anchor="HAngularDeceleration28AD29"]]|(% style="text-align:center" %)AD|(% style="text-align:center" %)QAD|(% style="text-align:center" %)CAD|100|°/s^^2^^|Increments of 10°/s^^2^^. Only when motion profile is enabled (EM1). 152 152 | |[[**G**yre Direction>>||anchor="HGyreDirection28G29"]]|(% style="text-align:center" %)G|(% style="text-align:center" %)QG|(% style="text-align:center" %)CG|1| |Gyre / rotation direction: 1= CW (clockwise) -1 = CCW (counter-clockwise) 153 153 | |[[**F**irst Position (**D**eg)>>||anchor="HFirstPosition"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QFD|(% style="text-align:center" %)CFD|No value|1/10°|Reset required after change. 154 -| |[[**M**aximum **M**otor **D**uty>>||anchor="HMaximumMotorDuty28MMD29"]]|(% style="text-align:center" %)MMD|(% style="text-align:center" %)QMMD|(% style="text-align:center" %) |1023|255 to 1023 integer| 155 155 | |[[Maximum **S**peed in **D**egrees>>||anchor="HMaximumSpeedinDegrees28SD29"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %)QSD|(% style="text-align:center" %)CSD|Max|0.1°/s|SD overwrites SR / CSD overwrites CSR and vice-versa 156 156 | |[[Maximum **S**peed in **R**PM>>||anchor="HMaximumSpeedinRPM28SR29"]]|(% style="text-align:center" %)SR|(% style="text-align:center" %)QSR|(% style="text-align:center" %)CSR|Max|RPM|SD overwrites SR / CSD overwrites CSR and vice-versa 152 +| |[[Step Mode>>doc:||anchor="HStepMode28SM29"]]|(% style="text-align:center" %)SM|(% style="text-align:center" %)QM|(% style="text-align:center" %)CSM|2|1, 2, 4|Numbers represent fractions: full step, ½ step, ¼ step 157 157 158 158 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Modifiers**>>||anchor="HModifiers"]] 159 159 |(% style="width:25px" %) |(% style="width:200px" %)**Description**|(% style="text-align:center; width:100px" %)**Modifier**|(% style="text-align:center; width:75px" %)**Query**|(% style="text-align:center; width:75px" %)**Config**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** ... ... @@ -167,32 +167,140 @@ 167 167 | |[[**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) 168 168 | |[[**Q**uery **F**irmware Version>>||anchor="HQueryFirmware28QF29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QF|(% style="text-align:center" %) | | | 169 169 | |[[**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 170 -| |**Q**uery **T**emperature **P**robe|(% style="text-align:center" %) |(% style="text-align:center" %)QTP|(% style="text-align:center" %) | | |Queries temperature probe fixed to stepper motor 171 -| |**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" %) | | |((( 172 172 QTCW: Queries the temperature status of the motor controller (pre-warning) 173 173 174 174 QTCE: Queries the temperature status of the motor controller (over-temp error) 175 175 ))) 176 -| |**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 177 -| |**Q**uery **I**MU Linear **X**|(% style="text-align:center" %) |(% style="text-align:center" %)QIX|(% style="text-align:center" %) | |mm/s^2| 178 -| |**Q**uery **I**MU Linear **Y**|(% style="text-align:center" %) |(% style="text-align:center" %)QIY|(% style="text-align:center" %) | |mm/s^2| 179 -| |**Q**uery **I**MU Linear **Z**|(% style="text-align:center" %) |(% style="text-align:center" %)QIZ|(% style="text-align:center" %) | |mm/s^2| 180 -| |**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) 181 -| |**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) 182 -| |**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) 183 183 184 184 |(% colspan="8" style="color:orange; font-size:18px" %)[[**RGB LED**>>||anchor="HRGBLED"]] 185 185 |(% 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 186 | |[[**LED** Color>>||anchor="HLEDColor28LED29"]]|(% style="text-align:center" %)LED|(% style="text-align:center" %)QLED|(% style="text-align:center" %)CLED| |0 to 7 integer|0=Off; 1=Red; 2=Green; 3=Blue; 4=Yellow; 5=Cyan; 6=Magenta; 7=White 187 -| |[[**C**onfigure **L**ED **B**linking>>||anchor="HConfigureLEDBlinking28CLB29"]]|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)CLB| |0 to 63 integer|Reset required after change. See command for details. 188 188 189 189 = (% style="color:inherit; font-family:inherit" %)Details(%%) = 190 190 191 191 == (% style="color:inherit; font-family:inherit" %)Communication Setup(%%) == 192 192 188 +|(% colspan="2" %)((( 189 +====== __Reset__ ====== 190 +))) 191 +| |((( 192 +Ex: #5RESET<cr> 193 + 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 +))) 196 + 197 +|(% colspan="2" %)((( 198 +====== (% style="color:inherit; font-family:inherit" %)__Default & confirm__(%%) ====== 199 +))) 200 +|(% style="width:30px" %) |((( 201 +(% style="color:inherit; font-family:inherit" %)Ex: #5DEFAULT<cr> 202 + 203 +(% 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. 204 + 205 +(% style="color:inherit; font-family:inherit" %)EX: #5DEFAULT<cr> followed by #5CONFIRM<cr> 206 + 207 +(% 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. 208 + 209 +(% style="color:inherit; font-family:inherit" %)Note: After the CONFIRM command is sent, the servo will automatically perform a RESET. 210 +))) 211 + 212 +|(% colspan="2" %)((( 213 +====== (% style="color:inherit; font-family:inherit" %)__Update & confirm__(%%) ====== 214 +))) 215 +|(% style="width:30px" %) |((( 216 +(% style="color:inherit; font-family:inherit" %)Ex: #5UPDATE<cr> 217 + 218 +(% 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. 219 + 220 +(% style="color:inherit; font-family:inherit" %)EX: #5UPDATE<cr> followed by #5CONFIRM<cr> 221 + 222 +(% 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. 223 + 224 +(% style="color:inherit; font-family:inherit" %)Note: After the CONFIRM command is sent, the servo will automatically perform a RESET. 225 +))) 226 + 227 +|(% colspan="2" %)((( 228 +====== (% style="color:inherit; font-family:inherit" %)__Confirm__(%%) ====== 229 +))) 230 +|(% style="width:30px" %) |((( 231 +(% style="color:inherit; font-family:inherit" %)Ex: #5CONFIRM<cr> 232 + 233 +(% style="color:inherit; font-family:inherit" %)This command is used to confirm changes after a Default or Update command. 234 +Note: After the CONFIRM command is sent, the servo will automatically perform a RESET. 235 +))) 236 + 237 +|(% colspan="2" %)((( 238 +====== (% style="color:inherit; font-family:inherit" %)__ID Number__(%%) ====== 239 +))) 240 +|(% style="width:30px" %) |((( 241 +This assigns ID #5 to the servo previously assigned to ID 0 242 + 243 +(% style="color:inherit; font-family:inherit" %)Configure ID Number (**CID**) 244 + 245 +(% style="color:inherit; font-family:inherit" %)Ex: #0CID5<cr> 246 + 247 +The default ID is 0, so this sets the servo to ID 5. 248 + 249 +Query ID Number (**QID**) 250 + 251 +Ex: #254QID<cr> might return *254QID5<cr> 252 + 253 +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. 254 +))) 255 + 256 +|(% colspan="2" %)((( 257 +====== (% style="color:inherit; font-family:inherit" %)__Enable CAN Terminal Resistor__(%%) ====== 258 +))) 259 +|(% style="width:30px" %) |((( 260 +Query Enable CAN Terminal Resistor (**QET**) 261 + 262 +Ex: #5QET<cr> might return *QET0<cr> 263 + 264 +This means that servo with ID 5 is NOT configured as the last servo in the CAN bus. 265 + 266 +Configure Enable CAN Terminal Resistor (**CET**) 267 + 268 +(% style="color:inherit; font-family:inherit" %)Ex: #5CET1<cr> 269 + 270 +(% 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. 271 +))) 272 + 273 +|(% colspan="2" %)((( 274 +====== __USB Connection Status__ ====== 275 +))) 276 +|(% style="width:30px" %) |((( 277 +Query USB Connection Status (**QUC**) 278 + 279 +Ex: #5QUC<cr> might return *5QUC1<cr> meaning the servo is connected via USB 280 +))) 281 + 282 +|(% colspan="2" %)((( 283 +====== __Firmware Release__ ====== 284 +))) 285 +|(% style="width:30px" %) |((( 286 +Query Firmware Release (**QFR**) 287 + 288 +Ex: #5QFR<cr> might return *QFR11<cr> meaning it has a (random) firmware release version number 11. 289 + 290 +This is used to verify if the firmware on the servos is up to date, or which version is running on the microcontroller. 291 +))) 292 + 193 193 == Motion == 194 194 195 -====== __Position in Degrees (**D**)__ ====== 295 +|(% colspan="2" %)((( 296 +====== __Position in Degrees__ ====== 297 +))) 298 +|(% style="width:30px" %) |((( 299 +Position in Degrees (**D**) 196 196 197 197 Example: #5D1456<cr> 198 198 ... ... @@ -211,15 +211,24 @@ 211 211 Ex: #5QDT<cr> might return *5QDT6783<cr> 212 212 213 213 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. 318 +))) 214 214 215 -====== __(Relative) Move in Degrees (**MD**)__ ====== 320 +|(% colspan="2" %)((( 321 +====== __(Relative) Move in Degrees__ ====== 322 +))) 323 +|(% style="width:30px" %) |((( 324 +Move in Degrees (**MD**) 216 216 217 - 218 218 Example: #5MD123<cr> 219 219 220 220 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. 329 +))) 221 221 222 -====== __Wheel Mode in Degrees (**WD**)__ ====== 331 +|(% colspan="2" %)((( 332 +====== __Wheel Mode in Degrees__ ====== 333 +))) 334 +|(% style="width:30px" %) |((( 335 +Wheel mode in Degrees (**WD**) 223 223 224 224 Ex: #5WD90<cr> 225 225 ... ... @@ -230,8 +230,13 @@ 230 230 Ex: #5QWD<cr> might return *5QWD90<cr> 231 231 232 232 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). 346 +))) 233 233 234 -====== __Wheel Mode in RPM (**WR**)__ ====== 348 +|(% colspan="2" %)((( 349 +====== __Wheel Mode in RPM__ ====== 350 +))) 351 +|(% style="width:30px" %) |((( 352 +Wheel moed in RPM (**WR**) 235 235 236 236 Ex: #5WR40<cr> 237 237 ... ... @@ -242,8 +242,14 @@ 242 242 Ex: #5QWR<cr> might return *5QWR40<cr> 243 243 244 244 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). 363 +))) 245 245 246 -====== __(Relative) Move in Degrees (**MD**)__ ====== 365 +|(% colspan="2" %)((( 366 +====== __(Relative) Move in Degrees__ ====== 367 +))) 368 +|(% style="width:30px" %) |((( 369 +(% class="wikigeneratedid" %) 370 +Move in Degrees (**MD**) 247 247 248 248 (% class="wikigeneratedid" id="HExample:235M15003Ccr3E" %) 249 249 Example: #5M1500<cr> ... ... @@ -250,8 +250,13 @@ 250 250 251 251 (% class="wikigeneratedid" id="HTherelativemoveinPWMcommandcausestheservotoreaditscurrentpositionandmovebythespecifiednumberofPWMsignal.ForexampleiftheservoissettorotateCW28default29andanMcommandof1500issenttotheservo2Citwillcausetheservotorotateclockwiseby90degrees.NegativePWMvaluewouldcausetheservotorotateintheoppositeconfigureddirection." %) 252 252 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. 377 +))) 253 253 254 -====== __Query Status (**Q**)__ ====== 379 +|(% colspan="2" %)((( 380 +====== __Query Status__ ====== 381 +))) 382 +|(% style="width:30px" %) |((( 383 +Query Status (**Q**) 255 255 256 256 The status query describes what the servo is currently doing. The query returns an integer which must be looked up in the table below. 257 257 ... ... @@ -281,18 +281,29 @@ 281 281 | |ex: *5Q1<cr>|Current limit has been passed|Something cause the current to either spike, or remain too high for too long 282 282 | |ex: *5Q2<cr>|Input voltage detected is below or above acceptable range|Check the voltage of your batteries or power source 283 283 | |ex: *5Q3<cr>|Temperature limit has been reached|The servo is too hot to continue operating safely. 413 +))) 284 284 285 -====== __Limp (**L**)__ ====== 415 +|(% colspan="2" %)((( 416 +====== __Limp__ ====== 417 +))) 418 +|(% style="width:30px" %) |((( 419 +Limp (**L**) 286 286 287 287 Example: #5L<cr> 288 288 289 289 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>. 424 +))) 290 290 291 -====== __Halt & Hold (**H**)__ ====== 426 +|(% colspan="2" %)((( 427 +====== __Halt & Hold__ ====== 428 +))) 429 +|(% style="width:30px" %) |((( 430 +Halt & Hold (**H**) 292 292 293 293 Example: #5H<cr> 294 294 295 295 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.) 435 +))) 296 296 297 297 == Motion Setup == 298 298 ... ... @@ -394,8 +394,10 @@ 394 394 395 395 This command will cause servo #5's positions to be inverted, effectively causing the servo to rotate in the opposite direction given the same command. For example in a 2WD robot, servos are often physically installed back to back, therefore setting one of the servos to a negative gyration, the same wheel command (ex WR30) to both servos will cause the robot to move forward or backward rather than rotate. 396 396 397 -Query Gyre Direction (**QG**) Ex: #5QG<cr> might return *5QG-1<cr>537 +Query Gyre Direction (**QG**) 398 398 539 +Ex: #5QG<cr> might return *5QG-1<cr> 540 + 399 399 The value returned above means the servo is in a counter-clockwise gyration. Sending a #5WR30 command will rotate the servo in a counter-clockwise gyration at 30 RPM. 400 400 401 401 Configure Gyre (**CG**) ... ... @@ -432,6 +432,24 @@ 432 432 433 433 Configure Speed in RPM (**CSR**)Ex: #5CSR45<cr>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) received is what the servo uses for that session. 434 434 577 +====== __Step Mode (**SM**)__ ====== 578 + 579 +Ex: #8SM2<cr> 580 + 581 +This sets servo with ID 8 to 1/2 step mode. Since this is an action as opposed to a configuration, it only affects that session. 582 + 583 +Note that the torque and max RPM of the actuator will be affected. 584 + 585 +Query Step Mode (**QSM**) 586 + 587 +Ex: #8QSM<cr> might return *8QSM2<cr> meaning servo with ID 8 is set to half step mode. 588 + 589 +Configure Step Mode (**CSM**) 590 + 591 +Ex: #8SM2<cr> 592 + 593 +This sets servo with ID 8 to 1/2 step mode. Since this is a configuration as opposed to a configuration and the servo will be in 1/2 step mode when powered. 594 + 435 435 == Modifiers == 436 436 437 437 ====== __Speed (**SD**) modifier__ ====== ... ... @@ -459,27 +459,31 @@ 459 459 460 460 **Note:** If the calculated speed at which a servo must rotate for a timed move is greater than its maximum speed (which depends on voltage and load), then it will move at its maximum speed, and the time of the move may be longer than requested 461 461 462 -====== 622 +====== ====== 463 463 464 464 == Telemetry == 465 465 466 -====== __Query Voltage (**QV**)__ ======626 +====== __Query PCB Temperature (**QT**)__ ====== 467 467 468 -Ex: #5Q V<cr> might return *5QV11200<cr>628 +Ex: #5QT<cr> might return *5QT564<cr> 469 469 470 -The numberreturnedisinmilliVolts, so in thecase above, servowithID5hasaninputvoltageof 11.2V.630 +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. 471 471 472 -====== __Query Temperature (**QT**)__ ====== 632 +====== __Query Temperature Probe (**QTP**)__ ====== 473 473 474 -Ex: #5QT<cr> might return *5QT564<cr>634 +Ex: 475 475 476 - 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.636 +====== __Query Temp of Controller (**QTCW**)__ ====== 477 477 478 - ====== __Query Motor Driver Current (**QC**)__ ======638 +Ex: 479 479 640 +An alternative is QTCE 641 + 642 +====== __Query Current (**QC**)__ ====== 643 + 480 480 Ex: #5QC<cr> might return *5QC140<cr> 481 481 482 -The units are in milliamps, so in the example above, the servo is consuming 140mA, or 0.14A. It represents the RMS value. 646 +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. 483 483 484 484 ====== __Query Model String (**QMS**)__ ====== 485 485 ... ... @@ -498,3 +498,17 @@ 498 498 Ex: #5QN<cr> might return *5QN12345678<cr> 499 499 500 500 The number in the response (12345678) would be the servo's serial number which is set and should not be changed by the user. 665 + 666 +====== __Query IMU Linear (**QIX** **QIY** **QIZ**)__ ====== 667 + 668 +Ex: #6QIX<cr> might return *6QIX30<cr> 669 + 670 +This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 30mm per second squared. 671 + 672 +====== __Query IMU Angular (**QIA** **QIB** **QIC**)__ ====== 673 + 674 +Ex: #6QIB<cr> might return *6QIB44<cr> 675 + 676 +This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 4.4 degrees per second squared. 677 + 678 +