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
-
... ... @@ -91,7 +91,7 @@ 91 91 92 92 The ability to store a "virtual angular position" is a feature which allows for rotation beyond 360 degrees, permitting multiple rotations of the output horn, moving the center position and more. The "absolute position" would be the angle of the output shaft with respect to a 360.00 degree circle and can be obtained by taking the modulus (with respect to 360 degrees) of the value. For example if the virtual position is reported as 153350 (or 1533.50 degrees), taking the modulus would give 93.5 degrees (36000 * 4 + 9350 = 153350) as the absolute position (assuming no origin offset). 93 93 94 -[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/s es-pro/lss-pro/lss-p-communication-protocol/WebHome/LSS-servo-positions.jpg||alt="LSS-servo-positions.jpg"]]94 +[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/lynxmotion-smart-servo-pro/lss-p-communication-protocol/WebHome/LSS-servo-positions.jpg||alt="LSS-servo-positions.jpg"]] 95 95 96 96 In this example, the gyre direction (explained below, a.k.a. "rotation direction") is positive (clockwise), and origin offset has not been modified. Each square represents 30 degrees. The following command is sent: 97 97 ... ... @@ -116,62 +116,62 @@ 116 116 117 117 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Communication Setup**>>||anchor="HCommunicationSetup"]] 118 118 |(% 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** 119 -| |[[**Reset**>>||anchor="HReset"]]|(% style="text-align:center" %)RESET|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |Soft reset 120 -| |[[**Default** Configuration>>||anchor="HDefault26confirm"]]|(% style="text-align:center" %)DEFAULT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |Revert to firmware default values 121 -| |[[Firmware **Update** Mode>>||anchor="HUpdate26confirm"]]|(% style="text-align:center" %)UPDATE|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |Update firmware 122 -| |[[**Confirm** Changes>>||anchor="HConfirm"]]|(% style="text-align:center" %)CONFIRM|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |Confirm the action for some commands 123 -| |[[**ID** Number >>||anchor="HIDNumber28ID29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QID|(% style="text-align:center" %)CID|(% style="text-align:center" %)0|(% style="text-align:center" %) |Reset required after change. ID 254 is a "broadcast" which all servos respond to. 124 -| |[[**E**nable CAN **T**erminal>>doc:||anchor="HEnableCANTerminalResistor28ET29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QET|(% style="text-align:center" %)CET|(% style="text-align:center" %)1|(% style="text-align:center" %)0 or 1|0: Disable 1: Enable 125 -| |[[**U**SB **C**onnection Status>>||anchor="HUSBConnectionStatus28UC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QUC|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)0 or 1|0: Not connected 1: Connected 119 +| |[[**Reset**>>||anchor="HReset"]]|(% style="text-align:center" %)RESET|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Soft reset. See command for details. 120 +| |[[**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 121 +| |[[Firmware **Update** Mode>>||anchor="HUpdate26confirm"]]|(% style="text-align:center" %)UPDATE|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Update firmware. See command for details. 122 +| |[[**Confirm** Changes>>||anchor="HConfirm"]]|(% style="text-align:center" %)CONFIRM|(% style="text-align:center" %) |(% style="text-align:center" %) | | | 123 +| |[[**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. 124 +| |[[**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 125 +| |[[**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 126 +| |[[**Q**uery **F**irmware **R**elease>>doc:||anchor="HFirmwareRelease28FR29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QFR|(% style="text-align:center" %) | | | 126 126 127 127 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Motion**>>||anchor="HMotion"]] 128 128 |(% 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** 129 -| |[[Position in **D**egrees>>||anchor="HPositioninDegrees28D29"]]|(% style="text-align:center" %)D|(% style="text-align:center" %)QD|(% style="text-align:center" %) | |0 .01°|130 -| |[[**M**ove in **D**egrees (relative)>>||anchor="H28Relative29MoveinDegrees28MD29"]]|(% style="text-align:center" %)MD|(% style="text-align:center" %) |(% style="text-align:center" %) | |0 .01°|131 -| |[[**W**heel mode in **D**egrees>>||anchor="HWheelModeinDegrees28WD29"]]|(% style="text-align:center" %)WD|(% style="text-align:center" %)QWD|(% style="text-align:center" %) | | 0.01°/s|A.K.A. "Speed mode" or "Continuous rotation"130 +| |[[Position in **D**egrees>>||anchor="HPositioninDegrees28D29"]]|(% style="text-align:center" %)D|(% style="text-align:center" %)QD/QDT|(% style="text-align:center" %) | |1/100°| 131 +| |[[**M**ove in **D**egrees (relative)>>||anchor="H28Relative29MoveinDegrees28MD29"]]|(% style="text-align:center" %)MD|(% style="text-align:center" %) |(% style="text-align:center" %) | |1/100°| 132 +| |[[**W**heel mode in **D**egrees>>||anchor="HWheelModeinDegrees28WD29"]]|(% style="text-align:center" %)WD|(% style="text-align:center" %)QWD/QVT|(% style="text-align:center" %) | |°/s|A.K.A. "Speed mode" or "Continuous rotation" 132 132 | |[[**W**heel mode in **R**PM>>||anchor="HWheelModeinRPM28WR29"]]|(% style="text-align:center" %)WR|(% style="text-align:center" %)QWR|(% style="text-align:center" %) | |RPM|A.K.A. "Speed mode" or "Continuous rotation" 133 133 | |[[**Q**uery Motion Status>>||anchor="HQueryStatus28Q29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)Q|(% style="text-align:center" %) | |1 to 8 integer|See command description for details 134 -| |[[**Q**uery **M**otion **T**ime>>doc:||anchor="HMotionTime"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QMT|(% style="text-align:center" %) | |0.01s| 135 -| |[[**Q**uery **C**urrent **S**peed>>doc:||anchor="HCurrentSpeed"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QCS|(% style="text-align:center" %) | |0.01°/s| 136 136 | |[[**L**imp>>||anchor="HLimp28L29"]]|(% style="text-align:center" %)L|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Removes power from stepper coils 137 -| |[[**H**alt & Hold>> doc:||anchor="HHalt26Hold28H29"]]|(% style="text-align:center" %)H|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Stops (halts) motion and holds last position136 +| |[[**H**alt & Hold>>||anchor="HHalt26Hold28H29"]]|(% style="text-align:center" %)H|(% style="text-align:center" %) |(% style="text-align:center" %) | | |Stops (halts) motion profile and holds last position 138 138 139 139 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Motion Setup**>>||anchor="HMotionSetup"]] 140 140 |(% 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 -| |[[**O**rigin Offset>>||anchor="HOriginOffset28O29"]]|(% style="text-align:center" %)O|(% style="text-align:center" %)QO|(% style="text-align:center" %)CO|(% style="text-align:center" %)0|(% style="text-align:center" %)0.01°| 142 -| |[[**A**ngular **R**ange>>||anchor="HAngularRange28AR29"]]|(% style="text-align:center" %)AR|(% style="text-align:center" %)QAR|(% style="text-align:center" %)CAR|(% style="text-align:center" %)36000|(% style="text-align:center" %)0.01°| 143 -| |[[**A**ngular **A**cceleration>>||anchor="HAngularAcceleration28AA29"]]|(% style="text-align:center" %)AA|(% style="text-align:center" %)QAA|(% style="text-align:center" %)CAA|(% style="text-align:center" %) |(% style="text-align:center" %)0.01°/s^2| 144 -| |[[**A**ngular **D**eceleration>>||anchor="HAngularDeceleration28AD29"]]|(% style="text-align:center" %)AD|(% style="text-align:center" %)QAD|(% style="text-align:center" %)CAD|(% style="text-align:center" %) |(% style="text-align:center" %)0.01°/s^2| 145 -| |[[**G**yre Direction>>||anchor="HGyreDirection28G29"]]|(% style="text-align:center" %)G|(% style="text-align:center" %)QG|(% style="text-align:center" %)CG|(% style="text-align:center" %)1|(% style="text-align:center" %)1 or -1|Gyre / rotation direction: 1= CW (clockwise) -1 = CCW (counter-clockwise) 146 -| |[[**F**irst Position (**D**eg)>>||anchor="HFirstPosition"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QFD|(% style="text-align:center" %)CFD|(% style="text-align:center" %) |(% style="text-align:center" %)0.01°|Reset required after change. 147 -| |[[Maximum **S**peed in **D**egrees>>||anchor="HMaximumSpeedinDegrees28SD29"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %)QSD|(% style="text-align:center" %)CSD|(% style="text-align:center" %) |(% style="text-align:center" %)0.01°/s|SD / CSD overwrites SR / CSR 148 -| |[[Maximum **S**peed in **R**PM>>||anchor="HMaximumSpeedinRPM28SR29"]]|(% style="text-align:center" %)SR|(% style="text-align:center" %)QSR|(% style="text-align:center" %)CSR|(% style="text-align:center" %) |(% style="text-align:center" %)RPM|SR / CSR overwrites SD / CSD 140 +| |[[**O**rigin Offset>>||anchor="HOriginOffset28O29"]]|(% style="text-align:center" %)O|(% style="text-align:center" %)QO|(% style="text-align:center" %)CO|0|1/10°| 141 +| |[[**A**ngular **R**ange>>||anchor="HAngularRange28AR29"]]|(% style="text-align:center" %)AR|(% style="text-align:center" %)QAR|(% style="text-align:center" %)CAR|1800|1/10°| 142 +| |[[**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). 143 +| |[[**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). 144 +| |[[**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) 145 +| |[[**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. 146 +| |[[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 147 +| |[[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 148 +| |[[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 149 149 150 150 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Modifiers**>>||anchor="HModifiers"]] 151 151 |(% 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** 152 -| |[[**S**peed in **D**egrees>> doc:||anchor="HSpeed28SD29modifier"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %) |(% style="text-align:center" %) | |0.01°/s|For D and MD action commands152 +| |[[**S**peed in **D**egrees>>||anchor="HSpeed28S2CSD29modifier"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %) |(% style="text-align:center" %) | |1°/s|For D and MD action commands 153 153 | |[[**T**imed move>>||anchor="HTimedmove28T29modifier"]]|(% style="text-align:center" %)T|(% style="text-align:center" %) |(% style="text-align:center" %) | |ms|Time associated with D, MD commands 154 154 155 155 |(% colspan="8" style="color:orange; font-size:18px" %)[[**Telemetry**>>||anchor="HTelemetry"]] 156 156 |(% 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** 157 -| |[[**Q**uery PCB **T**emperature>>doc:||anchor="HQueryPCBTemperature28QT29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QT|(% style="text-align:center" %) | |0.1°C| 158 -| |[[**Q**uery **C**urrent>>doc:||anchor="HQueryCurrent28QC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QC|(% style="text-align:center" %) | |mA|Nominal RMS value to stepper motor driver IC. 159 -| |[[**Q**uery **M**odel **S**tring>>doc:||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) 160 -| |[[**Q**uery **F**irmware Version>>doc:||anchor="HQueryFirmware28QF29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QF|(% style="text-align:center" %) | | | 161 -| |[[**Q**uery Serial **N**umber>>doc:||anchor="HQuerySerialNumber28QN29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QN|(% style="text-align:center" %) | | |Returns the unique serial number for the servo 162 -| |[[**Q**uery **T**emperature **P**robe>>doc:||anchor="HQueryTemperatureProbe28QTP29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTP|(% style="text-align:center" %) | |0.1°C|Queries temperature probe fixed to the stepper motor 163 -| |[[**Q**uery **T**emp of **M**CU>>doc:||anchor="HQueryTemperatureMCU28QTM29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTM|(% style="text-align:center" %) | |0.1°C| 164 -| |[[**Q**uery **T**emp of **C**ontroller **E**rror>>doc:||anchor="HQueryTempControllerError28QTCE29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTCE|(% style="text-align:center" %) | | |((( 165 -Temperature error status of the motor controller (over-temp error) 157 +| |[[**Q**uery PCB **T**emperature>>||anchor="HQueryTemperature28QT29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QT|(% style="text-align:center" %) | |°C| 158 +| |[[**Q**uery **C**urrent>>||anchor="HQueryCurrent28QC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QC|(% style="text-align:center" %) | |mA|Nominal RMS value to stepper motor driver IC. 159 +| |[[**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) 160 +| |[[**Q**uery **F**irmware Version>>||anchor="HQueryFirmware28QF29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QF|(% style="text-align:center" %) | | | 161 +| |[[**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 162 +| |[[**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 163 +| |[[**Q**uery **T**emp of **M**CU>>doc:||anchor="HQueryMCUTemperature28QTM29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTM|(% style="text-align:center" %) | | | 164 +| |[[**Q**uery **T**emp of **C**ontroller>>doc:||anchor="HQueryTempofController28QTCW29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTCW, QTCE|(% style="text-align:center" %) | | |((( 165 +QTCW: Queries the temperature status of the motor controller (pre-warning) 166 + 167 +QTCE: Queries the temperature status of the motor controller (over-temp error) 166 166 ))) 167 -| |[[**Q**uery **T**emp of **C**ontroller **W**arning>>doc:||anchor="HQueryTempControllerWarning28QTCW29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QTCW|(% style="text-align:center" %) | | |Temperature error status of the motor controller (pre-warning) 168 -| |[[**Q**uery **E**rror **F**lag>>doc:||anchor="HQueryErrorFlag28QEF29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QEF|(% style="text-align:center" %) | | | 169 169 | |[[**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| 170 170 | |[[**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| 171 171 | |[[**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| 172 -| |[[**Q**uery **I**MU Angular Accel **α** >>doc:||anchor="HQueryIMUAngular28QIAQIBQI G29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIA|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel α (Alpha)173 -| |[[**Q**uery **I**MU Angular Accel **β**>>doc:||anchor="HQueryIMUAngular28QIAQIBQI G29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIB|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel β (Beta)174 -| |[[**Q**uery **I**MU Angular Accel **γ**>>doc:||anchor="HQueryIMUAngular28QIAQIBQI G29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QIG|(% style="text-align:center" %) | |°/s^2|Query IMU Angular Accel γ (Gamma)172 +| |[[**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) 173 +| |[[**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) 174 +| |[[**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) 175 175 176 176 |(% colspan="8" style="color:orange; font-size:18px" %)[[**RGB LED**>>||anchor="HRGBLED"]] 177 177 |(% 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** ... ... @@ -359,10 +359,13 @@ 359 359 ))) 360 360 361 361 |(% colspan="2" %)((( 362 -====== __Relative **M**ove in**D**egrees(**MD**)__ ======362 +====== __(Relative) Move in Degrees__ ====== 363 363 ))) 364 364 |(% style="width:30px" %) |((( 365 365 (% class="wikigeneratedid" %) 366 +Move in Degrees (**MD**) 367 + 368 +(% class="wikigeneratedid" id="HExample:235M15003Ccr3E" %) 366 366 Example: #5M1500<cr> 367 367 368 368 (% class="wikigeneratedid" id="HTherelativemoveinPWMcommandcausestheservotoreaditscurrentpositionandmovebythespecifiednumberofPWMsignal.ForexampleiftheservoissettorotateCW28default29andanMcommandof1500issenttotheservo2Citwillcausetheservotorotateclockwiseby90degrees.NegativePWMvaluewouldcausetheservotorotateintheoppositeconfigureddirection." %) ... ... @@ -370,9 +370,11 @@ 370 370 ))) 371 371 372 372 |(% colspan="2" %)((( 373 -====== __ **Q**uery Status(**Q**)__ ======376 +====== __Query Status__ ====== 374 374 ))) 375 375 |(% style="width:30px" %) |((( 379 +Query Status (**Q**) 380 + 376 376 The status query describes what the servo is currently doing. The query returns an integer which must be looked up in the table below. 377 377 378 378 Ex: #5Q<cr> might return *5Q6<cr>, which indicates the motor is holding a position. ... ... @@ -404,23 +404,11 @@ 404 404 ))) 405 405 406 406 |(% colspan="2" %)((( 407 -====== __ **Q**uery** M**otion **T**ime (**QMT**)__ ======412 +====== __Limp__ ====== 408 408 ))) 409 409 |(% style="width:30px" %) |((( 410 - 411 -))) 415 +Limp (**L**) 412 412 413 -|(% colspan="2" %)((( 414 -====== __**Q**uery** C**urrent **S**peed (**QCS**)__ ====== 415 -))) 416 -|(% style="width:30px" %) |((( 417 - 418 -))) 419 - 420 -|(% colspan="2" %)((( 421 -====== __**L**imp (**L**)__ ====== 422 -))) 423 -|(% style="width:30px" %) |((( 424 424 Example: #5L<cr> 425 425 426 426 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>. ... ... @@ -427,9 +427,11 @@ 427 427 ))) 428 428 429 429 |(% colspan="2" %)((( 430 -====== __ **H**alt & Hold(**H**)__ ======423 +====== __Halt & Hold__ ====== 431 431 ))) 432 432 |(% style="width:30px" %) |((( 426 +Halt & Hold (**H**) 427 + 433 433 Example: #5H<cr> 434 434 435 435 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.) ... ... @@ -437,18 +437,16 @@ 437 437 438 438 == Motion Setup == 439 439 440 -|(% colspan="2" %)((( 441 441 ====== __Origin Offset (**O**)__ ====== 442 -))) 443 -|(% style="width:30px" %) |((( 436 + 444 444 Example: #5O2400<cr>This command allows you to change the origin of the servo in relation to the factory zero position for that session. As with all action commands, the setting will be lost upon servo reset / power cycle. Origin offset commands are not cumulative and always relate to factory zero. In the first image, the origin at factory offset '0' (centered). 445 445 446 -[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/s es-pro/lss-pro/lss-p-communication-protocol/WebHome/LSS-servo-default.jpg||alt="LSS-servo-default.jpg"]]439 +[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/lynxmotion-smart-servo-pro/lss-p-communication-protocol/WebHome/LSS-servo-default.jpg||alt="LSS-servo-default.jpg"]] 447 447 448 448 449 449 In the second image, the origin, and the corresponding angular range (explained below) have been shifted by +240.0 degrees: 450 450 451 -[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/s es-pro/lss-pro/lss-p-communication-protocol/WebHome/LSS-servo-origin.jpg||alt="LSS-servo-origin.jpg"]]444 +[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/lynxmotion-smart-servo-pro/lss-p-communication-protocol/WebHome/LSS-servo-origin.jpg||alt="LSS-servo-origin.jpg"]] 452 452 453 453 454 454 Origin Offset Query (**QO**) ... ... @@ -462,26 +462,23 @@ 462 462 Example: #5CO-24<cr> 463 463 464 464 This command allows you to change the origin of the servo in relation to the factory zero position in EEPROM. The setting will be saved upon servo reset / power cycle. Origin offset configuration commands are not cumulative and always relate to factory zero. The new origin is also used in RC mode. In the example, the new origin will be at -2.4 degrees from the factory zero. 465 -))) 466 466 467 -|(% colspan="2" %)((( 468 468 ====== __Angular Range (**AR**)__ ====== 469 -))) 470 -|(% style="width:30px" %) |((( 460 + 471 471 Example: #5AR1800<cr> 472 472 473 473 This command allows you to temporarily change the total angular range of the servo in tenths of degrees. This applies to the Position in Pulse (P) command and RC mode. The default for (P) and RC mode is 1800 (180.0 degrees total, or ±90.0 degrees). The image below shows a standard -180.0 to +180.0 range, with no offset: 474 474 475 -[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/s es-pro/lss-pro/lss-p-communication-protocol/WebHome/LSS-servo-default.jpg||alt="LSS-servo-default.jpg"]]465 +[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/lynxmotion-smart-servo-pro/lss-p-communication-protocol/WebHome/LSS-servo-default.jpg||alt="LSS-servo-default.jpg"]] 476 476 477 477 Below, the angular range is restricted to 180.0 degrees, or -90.0 to +90.0. The center has remained unchanged. 478 478 479 -[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/s es-pro/lss-pro/lss-p-communication-protocol/WebHome/LSS-servo-ar.jpg||alt="LSS-servo-ar.jpg"]]469 +[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/lynxmotion-smart-servo-pro/lss-p-communication-protocol/WebHome/LSS-servo-ar.jpg||alt="LSS-servo-ar.jpg"]] 480 480 481 481 482 482 Finally, the angular range action command (ex. #5AR1800<cr>) and origin offset action command (ex. #5O-1200<cr>) are used to move both the center and limit the angular range: 483 483 484 -[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/s es-pro/lss-pro/lss-p-communication-protocol/WebHome/LSS-servo-ar-o-1.jpg||alt="LSS-servo-ar-o-1.jpg"]]474 +[[image:https://wiki.lynxmotion.com/info/wiki/lynxmotion/download/lynxmotion-smart-servo-pro/lss-p-communication-protocol/WebHome/LSS-servo-ar-o-1.jpg||alt="LSS-servo-ar-o-1.jpg"]] 485 485 486 486 487 487 Query Angular Range (**QAR**) ... ... @@ -491,12 +491,9 @@ 491 491 Configure Angular Range (**CAR**) 492 492 493 493 This command allows you to change the total angular range of the servo in tenths of degrees in EEPROM. The setting will be saved upon servo reset / power cycle. 494 -))) 495 495 496 -|(% colspan="2" %)((( 497 497 ====== __Angular Acceleration (**AA**)__ ====== 498 -))) 499 -|(% style="width:30px" %) |((( 486 + 500 500 The default value for angular acceleration is 100. Accepts values of between 1 and 100. Increments of 10 degrees per second squared. 501 501 502 502 Ex: #5AA30<cr> ... ... @@ -514,12 +514,9 @@ 514 514 Ex: #5CAA30<cr> 515 515 516 516 This writes the angular acceleration of servo #5 to 30 degrees per second squared (°/s^^2^^) to EEPROM. 517 -))) 518 518 519 -|(% colspan="2" %)((( 520 520 ====== __Angular Deceleration (**AD**)__ ====== 521 -))) 522 -|(% style="width:30px" %) |((( 506 + 523 523 The default value for angular deceleration is 100. Accepts values of between 1 and 100. Increments of 10 degrees per second squared. 524 524 525 525 Ex: #5AD30<cr> ... ... @@ -537,12 +537,9 @@ 537 537 Ex: #5CAD30<cr> 538 538 539 539 This writes the angular deceleration of servo #5 to 30 degrees per second squared (°/s^^2^^) to EEPROM. 540 -))) 541 541 542 -|(% colspan="2" %)((( 543 543 ====== __Gyre Direction (**G**)__ ====== 544 -))) 545 -|(% style="width:30px" %) |((( 526 + 546 546 "Gyre" is defined as a circular course or motion. The effect of changing the gyre direction is as if you were to use a mirror image of a circle. By default: CW = 1; CCW = -1. 547 547 548 548 Ex: #5G-1<cr> ... ... @@ -560,19 +560,13 @@ 560 560 Ex: #5CG-1<cr> 561 561 562 562 This changes the gyre direction as described above and also writes to EEPROM. 563 -))) 564 564 565 -|(% colspan="2" %)((( 566 566 ====== __First Position__ ====== 567 -))) 568 -|(% style="width:30px" %) |((( 546 + 569 569 In certain cases, a user might want to have the servo move to a specific angle upon power up; we refer to this as "first position" (a.k.a. "initial position"). The factory default has no first position value stored in EEPROM and therefore upon power up, the servo remains limp until a position (or hold command) is assigned. Note that the number should be restricted to -1790 (-179.0 degrees) to +1790 (179.0 degrees) and values beyond this will be changed to 1800.Query First Position in Degrees (**QFD**)Ex: #5QFD<cr> might return *5QFD900<cr>The reply above indicates that servo with ID 5 has a first position of 90.0 degrees. If there is no first position value stored, the reply will be DIS.Configure First Position in Degrees (**CFD**)Ex: #5CFD900<cr>This configuration command means the servo, when set to smart mode, will immediately move to 90.0 degrees upon power up. Sending a CFD command without a number (Ex. #5CFD<cr>) results in the servo remaining limp upon power up. In order to remove the first position, send no value, ex: #5CFD<cr> 570 -))) 571 571 572 -|(% colspan="2" %)((( 573 573 ====== __Maximum Speed in Degrees (**SD**)__ ====== 574 -))) 575 -|(% style="width:30px" %) |((( 550 + 576 576 Ex: #5SD1800<cr>This command sets the servo's maximum speed for motion commands in tenths of degrees per second for that session. In the example above, the servo's maximum speed for that session would be set to 180.0 degrees per second. The servo's maximum speed cannot be set higher than its physical limit at a given voltage. The SD action command overrides CSD (described below) for that session. Upon reset or power cycle, the servo reverts to the value associated with CSD as described below. Note that SD and SR (described below) are effectively the same, but allow the user to specify the speed in either unit. The last command (either SR or SD) received is what the servo uses for that session.Query Speed in Degrees (**QSD**)Ex: #5QSD<cr> might return *5QSD1800<cr>By default QSD will return the current session value, which is set to the value of CSD as reset/power cycle and changed whenever an SD/SR command is processed. 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: 577 577 578 578 |**Command sent**|**Returned value (1/10 °)** ... ... @@ -582,14 +582,11 @@ 582 582 |ex: #5QSD3<cr>|Target travel speed 583 583 584 584 Configure Speed in Degrees (**CSD**)Ex: #5CSD1800<cr>Using the CSD 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 180.0 degrees per second. When the servo is powered on (or after a reset), the CSD value is used. Note that CSD and CSR (described below) 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. 585 -))) 586 586 587 -|(% colspan="2" %)((( 588 588 ====== __Maximum Speed in RPM (**SR**)__ ====== 589 -))) 590 -|(% style="width:30px" %) |((( 591 -====== Ex: #5SR45<cr>This command sets the servo's maximum speed for motion commands in rpm for that session. In the example above, the servo's maximum speed for that session would be set to 45rpm. The servo's maximum speed cannot be set higher than its physical limit at a given voltage. SR overrides CSR (described below) for that session. Upon reset or power cycle, the servo reverts to the value associated with CSR as described below. Note that SD (described above) and SR are effectively the same, but allow the user to specify the speed in either unit. The last command (either SR or SD) received is what the servo uses for that session.Query Speed in RPM (**QSR**)Ex: #5QSR<cr> might return *5QSR45<cr>By default QSR will return the current session value, which is set to the value of CSR as reset/power cycle and changed whenever an SD/SR command is processed. 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: ====== 592 592 563 +Ex: #5SR45<cr>This command sets the servo's maximum speed for motion commands in rpm for that session. In the example above, the servo's maximum speed for that session would be set to 45rpm. The servo's maximum speed cannot be set higher than its physical limit at a given voltage. SR overrides CSR (described below) for that session. Upon reset or power cycle, the servo reverts to the value associated with CSR as described below. Note that SD (described above) and SR are effectively the same, but allow the user to specify the speed in either unit. The last command (either SR or SD) received is what the servo uses for that session.Query Speed in RPM (**QSR**)Ex: #5QSR<cr> might return *5QSR45<cr>By default QSR will return the current session value, which is set to the value of CSR as reset/power cycle and changed whenever an SD/SR command is processed. 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: 564 + 593 593 |**Command sent**|**Returned value (1/10 °)** 594 594 |ex: #5QSR<cr>|Session value for maximum speed (set by latest SD/SR command) 595 595 |ex: #5QSR1<cr>|Configured maximum speed in EEPROM (set by CSD/CSR) ... ... @@ -597,16 +597,32 @@ 597 597 |ex: #5QSR3<cr>|Target travel speed 598 598 599 599 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. 600 -))) 601 601 573 +====== __Step Mode (**SM**)__ ====== 574 + 575 +Ex: #8SM2<cr> 576 + 577 +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. 578 + 579 +Note that the torque and max RPM of the actuator will be affected. 580 + 581 +Query Step Mode (**QSM**) 582 + 583 +Ex: #8QSM<cr> might return *8QSM2<cr> meaning servo with ID 8 is set to half step mode. 584 + 585 +Configure Step Mode (**CSM**) 586 + 587 +Ex: #8SM2<cr> 588 + 589 +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. 590 + 602 602 == Modifiers == 603 603 604 -|(% colspan="2" %)((( 605 605 ====== __Speed (**SD**) modifier__ ====== 606 -))) 607 -|(% style="width:30px" %) |((( 608 -====== Example: #5D0SD180<cr> ====== 609 609 595 +(% class="wikigeneratedid" id="HTimedmove28T29modifier" %) 596 +Example: #5D0SD180<cr> 597 + 610 610 (% class="wikigeneratedid" %) 611 611 Modifier (SD) is only for a position (D) or relative position (MD) action and determines the speed of the move in tenths of degrees per second. A speed modifier (SD) of 180 would cause the servo to rotate from its current position to the desired absolute or relative position at a speed of 18 degrees per second. 612 612 ... ... @@ -618,116 +618,69 @@ 618 618 619 619 (% class="wikigeneratedid" %) 620 620 This command queries the current speed in microseconds per second. 621 -))) 622 622 623 -|(% colspan="2" %)((( 624 624 ====== __Timed move (**T**) modifier__ ====== 625 -))) 626 -|(% style="width:30px" %) |((( 611 + 627 627 Example: #5D15000T2500<cr> 628 628 629 629 Timed move can be used only as a modifier for a position (D, MD) actions. The units are in milliseconds, so a timed move of 2500 milliseconds would cause the servo to rotate from its current position to the desired position in 2.5 seconds. The onboard controller will attempt to ensure that the move is performed entirely at the desired velocity, though differences in torque may cause it to not be exact. This command is in place to ensure backwards compatibility with the SSC-32 / 32U protocol. 630 630 631 631 **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 632 -))) 633 633 618 +====== ====== 619 + 634 634 == Telemetry == 635 635 636 -|(% colspan="2" %)((( 637 -====== __**Q**uery PCB **T**emperature (**QT**)__ ====== 638 -))) 639 -|(% style="width:30px" %) |((( 622 +====== __Query PCB Temperature (**QT**)__ ====== 623 + 640 640 Ex: #5QT<cr> might return *5QT564<cr> 641 641 642 642 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. 643 -))) 644 644 645 -|(% colspan="2" %)((( 646 -====== __**Q**uery **C**urrent (**QC**)__ ====== 647 -))) 648 -|(% style="width:30px" %) |((( 649 -====== Ex: #5QC<cr> might return *5QC140<cr> ====== 628 +====== __Query Temperature Probe (**QTP**)__ ====== 650 650 630 +Ex: 631 + 632 +====== __Query Temp of Controller (**QTCW**)__ ====== 633 + 634 +Ex: 635 + 636 +An alternative is QTCE 637 + 638 +====== __Query Current (**QC**)__ ====== 639 + 640 +Ex: #5QC<cr> might return *5QC140<cr> 641 + 651 651 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. 652 -))) 653 653 654 -|(% colspan="2" %)((( 655 -====== __**Q**uery **M**odel **S**tring (**QMS**)__ ====== 656 -))) 657 -|(% style="width:30px" %) |((( 658 -====== Ex: #5QMS<cr> might return *5QMSLSS-HS1<cr> ====== 644 +====== __Query Model String (**QMS**)__ ====== 659 659 646 +Ex: #5QMS<cr> might return *5QMSLSS-HS1<cr> 647 + 660 660 This reply means that the servo model is LSS-HS1: a high speed servo, first revision. 661 -))) 662 662 663 -|(% colspan="2" %)((( 664 -====== __**Q**uery **F**irmware (**QF**)__ ====== 665 -))) 666 -|(% style="width:30px" %) |((( 650 +====== __Query Firmware (**QF**)__ ====== 651 + 667 667 Ex: #5QF<cr> might return *5QF368<cr> 668 668 669 669 The number in the reply represents the firmware version, in this example being 368.The command #5QF3<cr> can also be sent and the servo will reply with a 3 numbers firmware version, for example, 368.29.14 670 -))) 671 671 672 -|(% colspan="2" %)((( 673 -====== __**Q**uery Serial **N**umber (**QN**)__ ====== 674 -))) 675 -|(% style="width:30px" %) |((( 676 -====== Ex: #5QN<cr> might return *5QN12345678<cr> ====== 656 +====== __Query Serial Number (**QN**)__ ====== 677 677 658 +Ex: #5QN<cr> might return *5QN12345678<cr> 659 + 678 678 The number in the response (12345678) would be the servo's serial number which is set and should not be changed by the user. 679 -))) 680 680 681 -|(% colspan="2" %)((( 682 -====== __**Q**uery **T**emperature **P**robe (**QTP**)__ ====== 683 -))) 684 -|(% style="width:30px" %) |((( 685 - 686 -))) 662 +====== __Query IMU Linear (**QIX** **QIY** **QIZ**)__ ====== 687 687 688 -|(% colspan="2" %)((( 689 -====== __**Q**uery **T**emperature **M**CU (**QTM**)__ ====== 690 -))) 691 -|(% style="width:30px" %) |((( 692 - 693 -))) 664 +Ex: #6QIX<cr> might return *6QIX30<cr> 694 694 695 -|(% colspan="2" %)((( 696 -====== __**Q**uery **T**emp **C**ontroller **E**rror (**QTCE**)__ ====== 697 -))) 698 -|(% style="width:30px" %) |((( 699 -====== ====== 700 -))) 701 - 702 -|(% colspan="2" %)((( 703 -====== **Q**uery **T**emp **C**ontroller **W**arning (**QTCW**) ====== 704 -))) 705 -|(% style="width:30px" %) |((( 706 -====== ====== 707 -))) 708 - 709 -|(% colspan="2" %)((( 710 -====== __Query Error Flag (**QEF**)__ ====== 711 -))) 712 -|(% style="width:30px" %) |((( 713 - 714 -))) 715 - 716 -|(% colspan="2" %)((( 717 -====== __**Q**uery **I**MU Linear (**QIX QIY QIZ**)__ ====== 718 -))) 719 -|(% style="width:30px" %) |((( 720 -====== Ex: #6QIX<cr> might return *6QIX30<cr> ====== 721 - 722 722 This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 30mm per second squared. 723 -))) 724 724 725 -|(% colspan="2" %)((( 726 -====== __**Q**uery **I**MU Angular (**QIA QIB QIG**)__ ====== 727 -))) 728 -|(% style="width:30px" %) |((( 729 -====== Ex: #6QIB<cr> might return *6QIB44<cr> ====== 668 +====== __Query IMU Angular (**QIA** **QIB** **QIC**)__ ====== 730 730 670 +Ex: #6QIB<cr> might return *6QIB44<cr> 671 + 731 731 This command queries servo 6's IMU's linear accelerometer in the X direction. The response is 4.4 degrees per second squared. 732 -))) 733 733 674 +