Changes for page LSS Communication Protocol
Last modified by Eric Nantel on 2025/06/06 07:47
Change comment: There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -xwiki:XWiki. ENantel1 +xwiki:XWiki.BDaouas - Content
-
... ... @@ -7,29 +7,29 @@ 7 7 8 8 The Lynxmotion Smart Servo (LSS) serial protocol was created in order to be as simple and straightforward as possible from a user perspective ("human readable format"), while at the same time staying compact and robust yet highly versatile. The protocol was based on Lynxmotion's SSC-32 & SSC-32U RC servo controllers and almost everything one might expect to be able to configure for a smart servomotor is available. 9 9 10 -In order to be able to control each servo individually with commands, the first step should be to assign a different ID number to each servo (see details on theConfigureID,or "CID" command[[here>>doc:||anchor="HIdentificationNumber28ID29"]]). Only the servo(s) which have beenconfigured toaspecificIDwillact onacommandsentto thatID. There is currently no CRC or checksum implemented as part of the protocol.10 +In order to be able to control each servo individually with commands, the first step should be to assign a different ID number to each servo (see details on CID [[here>>doc:||anchor="HIdentificationNumber28ID29"]]). Once this has been done, only the servo(s) which have been assigned to the ID sent as part of the command will follow that command. There is currently no CRC or checksum implemented as part of the protocol. 11 11 12 12 == Session == 13 13 14 -{{html clean="false" wiki="true"}}14 +{{html wiki="true" clean="false"}} 15 15 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 16 16 A "session" is defined as the time between when the servo is powered ON to when it is powered OFF or reset.<div class="wikimodel-emptyline"></div> 17 17 18 -**Note 1:** For a given session, the action related to a specific command overrides the stored value in EEPROM.<div class="wikimodel-emptyline"></div> 19 -**Note 2:** During the power-on / reset process the LSS cannot accept commands for a small amount of time ( ~1.25 s).<div class="wikimodel-emptyline"></div>20 - **Note 3:**You can ensure the LSS is ready by using a query command to check for response (ex: #[id]Q\r or #[id]QID\rdescribed below). If the LSS is ready for commands (initialized) it will respond to the query. A timeout between 50-100 ms is recommended to compensate for drivers, OS and buffering delays.18 +**Note #1:** For a given session, the action related to a specific commands overrides the stored value in EEPROM.<div class="wikimodel-emptyline"></div> 19 +**Note #2:** During the power-on / reset process the LSS cannot accept commands for a small amount of time (1.25 s).<div class="wikimodel-emptyline"></div> 20 +You can ensure the LSS is ready by using a query command to check for response (ex: #[id]Q\r or #[id]QID\r). If the LSS is ready for commands (initialized) it will respond to the query. A timeout between 50-100 ms is recommended to compensate for drivers, OS and buffering delays. 21 21 <div class="wikimodel-emptyline"></div></div></div> 22 22 {{/html}} 23 23 24 24 == Action Commands == 25 25 26 -{{html clean="false" wiki="true"}}26 +{{html wiki="true" clean="false"}} 27 27 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 28 -Action commands tell the servo, within that session, to do something (i.e. "take an action"). The types of action commands which can be sent are described below, and they cannot be combined with other commands such as queries or configurations. Only one action command can be sent at a time. Action commands are session-specific, therefore once a servo is power cycled, it will not have any "memory" of previous actions or [[virtual positions>>||anchor="HVirtualAngularPosition"]] (described below). Action commands are sent serially to the servo's Rx pin and must be sent in the following format:<div class="wikimodel-emptyline"></div>28 +Action commands tell the servo, within that session, to do something (i.e. "take an action"). The types of action commands which can be sent are described below, and they cannot be combined with other commands such as queries or configurations. Only one action command can be sent at a time. Action commands are session-specific, therefore once a servo is power cycled, it will not have any "memory" of previous actions or [[virtual positions>>||anchor="HVirtualAngularPosition"]]. Action commands are sent serially to the servo's Rx pin and must be sent in the following format:<div class="wikimodel-emptyline"></div> 29 29 30 30 1. Start with a number sign **#** (Unicode Character: U+0023) 31 -1. Servo ID number as an integer (assigning an ID described below)32 -1. Action command (one or more letters, no whitespace, capital or lowercase from the list below)31 +1. Servo ID number as an integer 32 +1. Action command (one or more letters, no whitespace, capital or lower case) 33 33 1. Action value in the correct units with no decimal 34 34 1. End with a carriage return **\r** or **<cr>** Unicode Character (U+000D) 35 35 ... ... @@ -42,15 +42,15 @@ 42 42 43 43 == Modifiers == 44 44 45 -{{html clean="false" wiki="true"}}45 +{{html wiki="true" clean="false"}} 46 46 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 47 47 Modifiers can only be used with certain **action commands**. The format to include a modifier is:<div class="wikimodel-emptyline"></div> 48 48 49 49 1. Start with a number sign **#** (Unicode Character: U+0023) 50 50 1. Servo ID number as an integer 51 -1. Action command (one to three letters, no spaces, capital or lower casefrom a subset of action commandsbelow)51 +1. Action command (one to three letters, no spaces, capital or lower case) 52 52 1. Action value in the correct units with no decimal 53 -1. Modifier command (one or twolettersfromhelistof modifiersbelow)53 +1. Modifier command (one letter to too letters) 54 54 1. Modifier value in the correct units with no decimal 55 55 1. End with a carriage return **\r** or **<cr>** Unicode Character (U+000D) 56 56 ... ... @@ -62,7 +62,7 @@ 62 62 63 63 == Query Commands == 64 64 65 -{{html clean="false" wiki="true"}}65 +{{html wiki="true" clean="false"}} 66 66 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 67 67 Query commands request information from the servo. They are received via the Rx pin of the servo, and the servo's reply is sent via the servo's Tx pin. Using separate lines for Tx and Rx is called "full duplex". Query commands are also similar to action and configuration commands and must use the following format:<div class="wikimodel-emptyline"></div> 68 68 ... ... @@ -71,7 +71,7 @@ 71 71 1. Query command (one to four letters, no spaces, capital or lower case) 72 72 1. End with a carriage return **\r** or **<cr>** Unicode Character (U+000D)<div class="wikimodel-emptyline"></div> 73 73 74 -Ex: #5QD<cr> Query theposition in (tenth of) degrees for servowith ID#5<div class="wikimodel-emptyline"></div>74 +Ex: #5QD<cr> Query position in (tenth of) degrees for servo #5<div class="wikimodel-emptyline"></div> 75 75 76 76 The query will return a serial string (almost instantaneously) via the servo's Tx pin with the following format: 77 77 ... ... @@ -91,11 +91,11 @@ 91 91 92 92 == Configuration Commands == 93 93 94 -{{html clean="false" wiki="true"}}94 +{{html wiki="true" clean="false"}} 95 95 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 96 96 Configuration commands and corresponding values affect a servo's defaults which are written to and read from the servo's EEPROM.<div class="wikimodel-emptyline"></div> 97 97 98 -These configurations are retained in memory after the servo is reset or power is cut / lost. Some configuration commands affect the session, while others do not. In the Command table below, the column "Session" denotes if the configuration command affects the session. Not all action commands have a corresponding configuration command and vice versa. More information about which configuration commands are retained when in RC mode can be found on the [[LSS - RC PWM page>>doc:lynxmotion-smart-servo.lss-radio-control-pwm.WebHome]]. Configuration commands are not cumulative. This means that if two of thesame configuration commands are sent, one after the next, only the last configuration is used and stored.<div class="wikimodel-emptyline"></div>98 +These configurations are retained in memory after the servo is reset or power is cut / lost. Some configuration commands affect the session, while others do not. In the Command table below, the column "Session" denotes if the configuration command affects the session. Not all action commands have a corresponding configuration command and vice versa. More information about which configuration commands are retained when in RC mode can be found on the [[LSS - RC PWM page>>doc:lynxmotion-smart-servo.lss-radio-control-pwm.WebHome]]. Configuration commands are not cumulative. This means that if two same configuration commands are sent, one after the next, only the last configuration is used and stored.<div class="wikimodel-emptyline"></div> 99 99 100 100 The format to send a configuration command is identical to that of an action command:<div class="wikimodel-emptyline"></div> 101 101 ... ... @@ -153,89 +153,96 @@ 153 153 154 154 **Latest firmware version currently : 368.29.14** 155 155 156 -|(% colspan="10" style="color:orange; font-size:18px" %)[[**Communication Setup**>>||anchor=" HCommunicationSetup"]]156 +|(% colspan="10" style="color:orange; font-size:18px" %)[[**Communication Setup**>>||anchor="COMMUNICATION_SETUP"]] 157 157 |(% 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="text-align:center; width:75px" %)**RC**|(% style="text-align:center; width:75px" %)**Serial**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** 158 -| |[[**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. See command for details.159 -| |[[**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. See command for details160 -| |[[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. See command for details.161 -| |[[**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" %)✓| | |162 -| |[[**C**hange to **RC**>>||anchor=" HConfigureRCMode28CRC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)CRC|(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Change to RC mode 1 (position) or 2 (wheel).163 -| |[[**ID** #>>||anchor=" HIdentificationNumber28ID29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QID|(% style="text-align:center" %)CID|(% style="text-align:center" %) |(% style="text-align:center" %)✓|0| |Reset required after change. ID 254 is a "broadcast" which all servos respond to.164 -| |[[**B**audrate>>||anchor=" HBaudRate"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QB|(% style="text-align:center" %)CB|(% style="text-align:center" %) |(% style="text-align:center" %)✓|115200| |Reset required after change.158 +| |[[**Reset**>>||anchor="RESET"]]|(% style="text-align:center" %)RESET|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Soft reset. See command for details. 159 +| |[[**Default** Configuration>>||anchor="DEFAULT"]]|(% 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. See command for details 160 +| |[[Firmware **Update** Mode>>||anchor="UPDATE_CONFIRM"]]|(% style="text-align:center" %)UPDATE|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Update firmware. See command for details. 161 +| |[[**Confirm** Changes>>||anchor="CONFIRM"]]|(% style="text-align:center" %)CONFIRM|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | | 162 +| |[[**C**hange to **RC**>>||anchor="CHANGE_RC"]]|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)CRC|(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Change to RC mode 1 (position) or 2 (wheel). 163 +| |[[**ID** #>>||anchor="ID"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QID|(% style="text-align:center" %)CID|(% style="text-align:center" %) |(% style="text-align:center" %)✓|0| |Reset required after change. ID 254 is a "broadcast" which all servos respond to. 164 +| |[[**B**audrate>>||anchor="BAUDRATE"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QB|(% style="text-align:center" %)CB|(% style="text-align:center" %) |(% style="text-align:center" %)✓|115200| |Reset required after change. 165 165 166 -|(% colspan="10" style="color:orange; font-size:18px" %)[[**Motion**>>||anchor=" HMotion"]]166 +|(% colspan="10" style="color:orange; font-size:18px" %)[[**Motion**>>||anchor="MOTION"]] 167 167 |(% 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="text-align:center; width:75px" %)**RC**|(% style="text-align:center; width:75px" %)**Serial**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** 168 -| |[[Position in **D**egrees>>||anchor=" HPositioninDegrees28D29"]]|(% style="text-align:center" %)D|(% style="text-align:center" %)QD/QDT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1/10°|169 -| |[[**M**ove in **D**egrees (relative)>>||anchor=" H28Relative29MoveinDegrees28MD29"]]|(% style="text-align:center" %)MD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1/10°|170 -| |[[**W**heel mode in **D**egrees>>||anchor=" HWheelModeinDegrees28WD29"]]|(% style="text-align:center" %)WD|(% style="text-align:center" %)QWD/QVT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |°/s|A.K.A. "Speed mode" or "Continuous rotation"171 -| |[[**W**heel mode in **R**PM>>||anchor=" HWheelModeinRPM28WR29"]]|(% style="text-align:center" %)WR|(% style="text-align:center" %)QWR|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |RPM|A.K.A. "Speed mode" or "Continuous rotation"172 -| |[[Position in **P**WM>>||anchor=" HPositioninPWM28P29"]]|(% style="text-align:center" %)P|(% style="text-align:center" %)QP|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |us|Inherited from SSC-32 serial protocol173 -| |[[**M**ove in PWM (relative)>>||anchor=" H28Relative29MoveinPWM28M29"]]|(% style="text-align:center" %)M|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |us|174 -| |[[**R**aw **D**uty-cycle **M**ove>>||anchor=" HRawDuty-cycleMove28RDM29"]]|(% style="text-align:center" %)RDM|(% style="text-align:center" %)QMD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |-1023 to 1023 integer|Positive values : CW / Negative values : CCW175 -| |[[**Q**uery Status>>||anchor=" HQueryStatus28Q29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)Q|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1 to 8 integer|See command description for details176 -| |[[**L**imp>>||anchor=" HLimp28L29"]]|(% style="text-align:center" %)L|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |177 -| |[[**H**alt & Hold>>||anchor="HH alt26Hold28H29"]]|(% style="text-align:center" %)H|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |168 +| |[[Position in **D**egrees>>||anchor="POSITION_D"]]|(% style="text-align:center" %)D|(% style="text-align:center" %)QD/QDT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1/10°| 169 +| |[[**M**ove in **D**egrees (relative)>>||anchor="MOVE_D"]]|(% style="text-align:center" %)MD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1/10°| 170 +| |[[**W**heel mode in **D**egrees>>||anchor="WHEEL_D"]]|(% style="text-align:center" %)WD|(% style="text-align:center" %)QWD/QVT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |°/s|A.K.A. "Speed mode" or "Continuous rotation" 171 +| |[[**W**heel mode in **R**PM>>||anchor="WHEEL_RPM"]]|(% style="text-align:center" %)WR|(% style="text-align:center" %)QWR|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |RPM|A.K.A. "Speed mode" or "Continuous rotation" 172 +| |[[Position in **P**WM>>||anchor="POSITION_PWM"]]|(% style="text-align:center" %)P|(% style="text-align:center" %)QP|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |us|Inherited from SSC-32 serial protocol 173 +| |[[**M**ove in PWM (relative)>>||anchor="MOVE_PWM"]]|(% style="text-align:center" %)M|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |us| 174 +| |[[**R**aw **D**uty-cycle **M**ove>>||anchor="MOVE_RAW"]]|(% style="text-align:center" %)RDM|(% style="text-align:center" %)QMD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |-1023 to 1023 integer|Positive values : CW / Negative values : CCW 175 +| |[[**Q**uery Status>>||anchor="QUERY_STATUS"]]|(% style="text-align:center" %) |(% style="text-align:center" %)Q|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1 to 8 integer|See command description for details 176 +| |[[**L**imp>>||anchor="LIMP"]]|(% style="text-align:center" %)L|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | | 177 +| |[[**H**alt & Hold>>||anchor="HALT_HOLD"]]|(% style="text-align:center" %)H|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | | 178 178 179 -|(% colspan="10" style="color:orange; font-size:18px" %)[[**Motion Setup**>>||anchor=" HMotionSetup"]]179 +|(% colspan="10" style="color:orange; font-size:18px" %)[[**Motion Setup**>>||anchor="MOTION_SETUP"]] 180 180 |(% 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="text-align:center; width:75px" %)**RC**|(% style="text-align:center; width:75px" %)**Serial**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** 181 -| |[[**E**nable **M**otion Profile>>||anchor=" HEnableMotionProfile28EM29"]]|(% style="text-align:center" %)EM|(% style="text-align:center" %)QEM|(% style="text-align:center" %)CEM|(% style="text-align:center" %) |(% style="text-align:center" %)✓|1| |EM1: trapezoidal motion profile / EM0: no motion profile182 -| |[[**F**ilter **P**osition **C**ount>>||anchor=" HFilterPositionCount28FPC29"]]|(% style="text-align:center" %)FPC|(% style="text-align:center" %)QFPC|(% style="text-align:center" %)CFPC|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|5| |Affects motion only when motion profile is disabled (EM0)183 -| |[[**O**rigin Offset>>||anchor=" HOriginOffset28O29"]]|(% style="text-align:center" %)O|(% style="text-align:center" %)QO|(% style="text-align:center" %)CO|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|0|1/10°|184 -| |[[**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" %)✓|(% style="text-align:center" %)✓|1800|1/10°|185 -| |[[**A**ngular **S**tiffness>>||anchor=" HAngularStiffness28AS29"]]|(% style="text-align:center" %)AS|(% style="text-align:center" %)QAS|(% style="text-align:center" %)CAS|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|0|-4 to +4 integer|Suggested values are between 0 to +4186 -| |[[**A**ngular **H**olding Stiffness>>||anchor=" HAngularHoldingStiffness28AH29"]]|(% style="text-align:center" %)AH|(% style="text-align:center" %)QAH|(% style="text-align:center" %)CAH|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|4|-10 to +10 integer|187 -| |[[**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" %)✓|100|°/s^^2^^|Increments of 10°/s^^2^^. Only when motion profile is enabled (EM1).188 -| |[[**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" %)✓|100|°/s^^2^^|Increments of 10°/s^^2^^. Only when motion profile is enabled (EM1).189 -| |[[**G**yre Direction>>||anchor=" HGyreDirection28G29"]]|(% style="text-align:center" %)G|(% style="text-align:center" %)QG|(% style="text-align:center" %)CG|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|1| |Gyre / rotation direction: 1= CW (clockwise) -1 = CCW (counter-clockwise)190 -| |[[**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" %)✓|No value|1/10°|Reset required after change.191 -| |[[**M**aximum **M**otor **D**uty>>||anchor=" HMaximumMotorDuty28MMD29"]]|(% style="text-align:center" %)MMD|(% style="text-align:center" %)QMMD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓|1023|255 to 1023 integer|192 -| |[[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" %)✓|Max|0.1°/s|SD overwrites SR / CSD overwrites CSR and vice-versa193 -| |[[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" %)✓|Max|RPM|SD overwrites SR / CSD overwrites CSR and vice-versa181 +| |[[**E**nable **M**otion Profile>>||anchor="MOTION_PROFILE"]]|(% style="text-align:center" %)EM|(% style="text-align:center" %)QEM|(% style="text-align:center" %)CEM|(% style="text-align:center" %) |(% style="text-align:center" %)✓|1| |EM1: trapezoidal motion profile / EM0: no motion profile 182 +| |[[**F**ilter **P**osition **C**ount>>||anchor="FILTER_POSITION_COUNT"]]|(% style="text-align:center" %)FPC|(% style="text-align:center" %)QFPC|(% style="text-align:center" %)CFPC|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|5| |Affects motion only when motion profile is disabled (EM0) 183 +| |[[**O**rigin Offset>>||anchor="ORIGIN_OFFSET"]]|(% style="text-align:center" %)O|(% style="text-align:center" %)QO|(% style="text-align:center" %)CO|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|0|1/10°| 184 +| |[[**A**ngular **R**ange>>||anchor="ANGULAR_RANGE"]]|(% style="text-align:center" %)AR|(% style="text-align:center" %)QAR|(% style="text-align:center" %)CAR|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|1800|1/10°| 185 +| |[[**A**ngular **S**tiffness>>||anchor="ANGULAR_STIFFNESS"]]|(% style="text-align:center" %)AS|(% style="text-align:center" %)QAS|(% style="text-align:center" %)CAS|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|0|-4 to +4 integer|Suggested values are between 0 to +4 186 +| |[[**A**ngular **H**olding Stiffness>>||anchor="ANGULAR_HOLDING_STIFFNESS"]]|(% style="text-align:center" %)AH|(% style="text-align:center" %)QAH|(% style="text-align:center" %)CAH|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|4|-10 to +10 integer| 187 +| |[[**A**ngular **A**cceleration>>||anchor="ANGULAR_ACCELERATION"]]|(% style="text-align:center" %)AA|(% style="text-align:center" %)QAA|(% style="text-align:center" %)CAA|(% style="text-align:center" %) |(% style="text-align:center" %)✓|100|°/s^^2^^|Increments of 10°/s^^2^^. Only when motion profile is enabled (EM1). 188 +| |[[**A**ngular **D**eceleration>>||anchor="ANGULAR_DECELERATION"]]|(% style="text-align:center" %)AD|(% style="text-align:center" %)QAD|(% style="text-align:center" %)CAD|(% style="text-align:center" %) |(% style="text-align:center" %)✓|100|°/s^^2^^|Increments of 10°/s^^2^^. Only when motion profile is enabled (EM1). 189 +| |[[**G**yre Direction>>||anchor="GYRE_DIRECTION"]]|(% style="text-align:center" %)G|(% style="text-align:center" %)QG|(% style="text-align:center" %)CG|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|1| |Gyre / rotation direction: 1= CW (clockwise) -1 = CCW (counter-clockwise) 190 +| |[[**F**irst Position (**D**eg)>>||anchor="FIRST_POSITION"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QFD|(% style="text-align:center" %)CFD|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|No value|1/10°|Reset required after change. 191 +| |[[**M**aximum **M**otor **D**uty>>||anchor="MAXIMUM_RAW"]]|(% style="text-align:center" %)MMD|(% style="text-align:center" %)QMMD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓|1023|255 to 1023 integer| 192 +| |[[Maximum **S**peed in **D**egrees>>||anchor="MAXIMUM_SPEED_D"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %)QSD|(% style="text-align:center" %)CSD|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|Max|°/s|SD overwrites SR / CSD overwrites CSR and vice-versa 193 +| |[[Maximum **S**peed in **R**PM>>||anchor="MAXIMUM_SPEED_RPM"]]|(% style="text-align:center" %)SR|(% style="text-align:center" %)QSR|(% style="text-align:center" %)CSR|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓|Max|RPM|SD overwrites SR / CSD overwrites CSR and vice-versa 194 194 195 -|(% colspan="10" style="color:orange; font-size:18px" %)[[**Modifiers**>>||anchor=" HModifiers"]]195 +|(% colspan="10" style="color:orange; font-size:18px" %)[[**Modifiers**>>||anchor="MODIFIERS"]] 196 196 |(% 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="text-align:center; width:75px" %)**RC**|(% style="text-align:center; width:75px" %)**Serial**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** 197 -| |[[**S**peed>>||anchor=" HSpeed28S2CSD29modifier"]]|(% style="text-align:center" %)S|(% style="text-align:center" %)QS|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |uS/s |For P action command198 -| |[[**S**peed in **D**egrees>>||anchor=" HSpeed28S2CSD29modifier"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |0.1°/s|For D and MD action commands199 -| |[[**T**imed move>>||anchor=" HTimedmove28T29modifier"]]|(% style="text-align:center" %)T|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |ms|Modifier only for P, D and MD. Time can change based on load200 -| |[[**C**urrent **H**old>>||anchor=" HCurrentHalt26Hold28CH29modifier"]]|(% style="text-align:center" %)CH|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mA|Modifier for D, MD, WD and WR201 -| |[[**C**urrent **L**imp>>||anchor=" HCurrentLimp28CL29modifier"]]|(% style="text-align:center" %)CL|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mA|Modifier for D, MD, WD and WR197 +| |[[**S**peed>>||anchor="SPEEDS"]]|(% style="text-align:center" %)S|(% style="text-align:center" %)QS|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |uS/s |For P action command 198 +| |[[**S**peed in **D**egrees>>||anchor="SPEEDS"]]|(% style="text-align:center" %)SD|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |°/s|For D and MD action commands 199 +| |[[**T**imed move>>||anchor="TIMED_MOVE"]]|(% style="text-align:center" %)T|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |ms|Modifier only for P, D and MD. Time can change based on load 200 +| |[[**C**urrent **H**old>>||anchor="CURRENT_HOLD"]]|(% style="text-align:center" %)CH|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mA|Modifier for D, MD, WD and WR 201 +| |[[**C**urrent **L**imp>>||anchor="CURRENT_LIMP"]]|(% style="text-align:center" %)CL|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mA|Modifier for D, MD, WD and WR 202 202 203 -|(% colspan="10" style="color:orange; font-size:18px" %)[[**Telemetry**>>||anchor=" HTelemetry"]]203 +|(% colspan="10" style="color:orange; font-size:18px" %)[[**Telemetry**>>||anchor="TELEMETRY"]] 204 204 |(% 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="text-align:center; width:75px" %)**RC**|(% style="text-align:center; width:75px" %)**Serial**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** 205 -| |[[**Q**uery **V**oltage>>||anchor="HQueryVoltage28QV29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QV|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mV| 206 -| |[[**Q**uery **T**emperature>>||anchor="HQueryTemperature28QT29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1/10°C| 207 -| |[[**Q**uery **C**urrent>>||anchor="HQueryCurrent28QC29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QC|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mA| 208 -| |[[**Q**uery **M**odel **S**tring>>||anchor="HQueryModelString28QMS29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QMS|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Returns the model of servo (ex: LSS-ST1, LSS-HS1, LSS-HT1) 209 -| |[[**Q**uery **F**irmware Version>>||anchor="HQueryFirmware28QF29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QF|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | | 205 +| |[[**Q**uery **V**oltage>>||anchor="QUERY_VOLTAGE"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QV|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mV| 206 +| |[[**Q**uery **T**emperature>>||anchor="QUERY_TEMP"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QT|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |1/10°C| 207 +| |[[**Q**uery **C**urrent>>||anchor="QUERY_CURRENT"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QC|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| |mA| 208 +| |[[**Q**uery **M**odel **S**tring>>||anchor="QUERY_MODEL"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QMS|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Returns the model of servo (ex: LSS-ST1, LSS-HS1, LSS-HT1) 209 +| |[[**Q**uery **F**irmware Version>>||anchor="QUERY_FIRMWARE"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QF|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | | 210 +| |[[**Q**uery Serial **N**umber>>||anchor="QUERY_SERIAL"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QN|(% style="text-align:center" %) |(% style="text-align:center" %) |(% style="text-align:center" %)✓| | |Returns the unique serial number for the servo 210 210 211 -|(% colspan="10" style="color:orange; font-size:18px" %)[[**RGB LED**>>||anchor=" HRGBLED"]]212 +|(% colspan="10" style="color:orange; font-size:18px" %)[[**RGB LED**>>||anchor="RGB_LED"]] 212 212 |(% 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="text-align:center; width:75px" %)**RC**|(% style="text-align:center; width:75px" %)**Serial**|(% style="width:100px" %)**Default**|(% style="width:170px" %)**Unit**|**Notes** 213 -| |[[**LED** Color>>||anchor=" HLEDColor28LED29"]]|(% style="text-align:center" %)LED|(% style="text-align:center" %)QLED|(% style="text-align:center" %)CLED|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓| |0 to 7 integer|0=Off; 1=Red; 2=Green; 3=Blue; 4=Yellow; 5=Cyan; 6=Magenta; 7=White214 -| |[[**C**onfigure **L**ED **B**linking>>||anchor=" HConfigureLEDBlinking28CLB29"]]|(% style="text-align:center" %) |(% style="text-align:center" %)214 +| |[[**LED** Color>>||anchor="LED_COLOR"]]|(% style="text-align:center" %)LED|(% style="text-align:center" %)QLED|(% style="text-align:center" %)CLED|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓| |0 to 7 integer|0=Off; 1=Red; 2=Green; 3=Blue; 4=Yellow; 5=Cyan; 6=Magenta; 7=White 215 +| |[[**C**onfigure **L**ED **B**linking>>||anchor="LED_BLINK"]]|(% style="text-align:center" %) |(% style="text-align:center" %)QLB|(% style="text-align:center" %)CLB|(% style="text-align:center" %)✓|(% style="text-align:center" %)✓| |0 to 63 integer|Reset required after change. See command for details. 215 215 216 216 = (% style="color:inherit; font-family:inherit" %)Details(%%) = 217 217 219 +{{id name="COMMUNICATION_SETUP"/}} 220 + 218 218 == (% style="color:inherit; font-family:inherit" %)Communication Setup(%%) == 219 219 223 +{{id name="RESET"/}} 224 + 220 220 ====== __Reset__ ====== 221 221 222 222 {{html wiki="true" clean="false"}} 223 223 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 224 -Ex: #5RESET <cr><div class="wikimodel-emptyline"></div>229 +Ex: #5RESET<cr><div class="wikimodel-emptyline"></div> 225 225 This command does a "soft reset" and reverts all commands to those stored in EEPROM (i.e. configuration commands). 226 226 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>>||anchor="HSession"]], note #2 for more details.<div class="wikimodel-emptyline"></div> 227 227 </div></div> 228 228 {{/html}} 229 229 235 +{{id name="DEFAULT"/}} 236 + 230 230 ====== __Default & confirm__ ====== 231 231 232 232 {{html wiki="true" clean="false"}} 233 233 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 234 -Ex: #5DEFAULT <cr><div class="wikimodel-emptyline"></div>241 +Ex: #5DEFAULT<cr><div class="wikimodel-emptyline"></div> 235 235 236 236 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.<div class="wikimodel-emptyline"></div> 237 237 238 -EX: #5DEFAULT <cr>followed by #5CONFIRM<cr><div class="wikimodel-emptyline"></div>245 +EX: #5DEFAULT<cr> followed by #5CONFIRM<cr><div class="wikimodel-emptyline"></div> 239 239 240 240 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.<div class="wikimodel-emptyline"></div> 241 241 ... ... @@ -243,15 +243,17 @@ 243 243 </div></div> 244 244 {{/html}} 245 245 253 +{{id name="UPDATE_CONFIRM"/}} 254 + 246 246 ====== __Update & confirm__ ====== 247 247 248 248 {{html wiki="true" clean="false"}} 249 249 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 250 -Ex: #5UPDATE <cr><div class="wikimodel-emptyline"></div>259 +Ex: #5UPDATE<cr><div class="wikimodel-emptyline"></div> 251 251 252 252 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.<div class="wikimodel-emptyline"></div> 253 253 254 -EX: #5UPDATE <cr>followed by #5CONFIRM<cr><div class="wikimodel-emptyline"></div>263 +EX: #5UPDATE<cr> followed by #5CONFIRM<cr><div class="wikimodel-emptyline"></div> 255 255 256 256 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.<div class="wikimodel-emptyline"></div> 257 257 ... ... @@ -259,6 +259,8 @@ 259 259 </div></div> 260 260 {{/html}} 261 261 271 +{{id name="CONFIRM"/}} 272 + 262 262 ====== __Confirm__ ====== 263 263 264 264 {{html wiki="true" clean="false"}} ... ... @@ -271,6 +271,8 @@ 271 271 </div></div> 272 272 {{/html}} 273 273 285 +{{id name="CHANGE_RC"/}} 286 + 274 274 ====== __Configure RC Mode (**CRC**)__ ====== 275 275 276 276 {{html wiki="true" clean="false"}} ... ... @@ -278,18 +278,20 @@ 278 278 This command puts the servo into RC mode (position or continuous), where it will only respond to RC PWM signal on the servo's Rx pin. In this mode, the servo will no longer accept serial commands. The servo can be placed back into smart mode by using the button menu.<div class="wikimodel-emptyline"></div> 279 279 280 280 |**Command sent**|**Note** 281 -|ex: #5CRC1 <cr>|Change to RC position mode.282 -|ex: #5CRC2 <cr>|Change to RC continuous rotation (wheel) mode.283 -|ex: #5CRC* <cr>|Where * is any value other than 1 or 2 (or no value): stay in smart mode.<div class="wikimodel-emptyline"></div>294 +|ex: #5CRC1<cr>|Change to RC position mode. 295 +|ex: #5CRC2<cr>|Change to RC continuous rotation (wheel) mode. 296 +|ex: #5CRC*<cr>|Where * is any value other than 1 or 2 (or no value): stay in smart mode.<div class="wikimodel-emptyline"></div> 284 284 285 -EX: #5CRC2 <cr><div class="wikimodel-emptyline"></div>298 +EX: #5CRC2<cr><div class="wikimodel-emptyline"></div> 286 286 287 -This command would place the servo in RC wheel mode after a RESET or power cycle. Note that after a RESET or power cycle, the servo will be in RC mode and will not reply to serial commands. Using the command #5CRC <cr>or #5CRC3<cr>which requests that the servo remain in serial mode still requires a RESET command.<div class="wikimodel-emptyline"></div>300 +This command would place the servo in RC wheel mode after a RESET or power cycle. Note that after a RESET or power cycle, the servo will be in RC mode and will not reply to serial commands. Using the command #5CRC<cr> or #5CRC3<cr> which requests that the servo remain in serial mode still requires a RESET command.<div class="wikimodel-emptyline"></div> 288 288 289 289 **Important note: **To revert from RC mode back to serial mode, the [[LSS - Button Menu>>doc:lynxmotion-smart-servo.lss-button-menu.WebHome]] is required. Should the button be inaccessible (or broken) when the servo is in RC mode and the user needs to change to serial mode, a 5V constant HIGH needs to be sent to the servo's Rx pin (RC PWM pin), **ensuring a common GND** and wait for 30 seconds. Normal RC PWM pulses should not exceed 2500 milliseconds. After 30 seconds, the servo will interpret this as a desired mode change and change to serial mode. This has been implemented as a fail safe.<div class="wikimodel-emptyline"></div> 290 290 </div></div> 291 291 {{/html}} 292 292 306 +{{id name="ID"/}} 307 + 293 293 ====== __Identification Number (**ID**)__ ====== 294 294 295 295 {{html wiki="true" clean="false"}} ... ... @@ -298,27 +298,29 @@ 298 298 299 299 Query Identification (**QID**)<div class="wikimodel-emptyline"></div> 300 300 301 -EX: #254QID <cr>might return *QID5<cr><div class="wikimodel-emptyline"></div>316 +EX: #254QID<cr> might return *QID5<cr><div class="wikimodel-emptyline"></div> 302 302 303 303 When using the broadcast query ID command, it is best to only have one servo connected and thus receive only one reply. This is useful when you are not sure of the servo's ID, but don't want to change it. Using the broadcast command (ID 254) with only one servo will have that servo reply with its ID number. Alternatively, pushing the button upon startup and temporarily setting the servo ID to 255 will still result in the servo responding with its "real" ID.<div class="wikimodel-emptyline"></div> 304 304 305 305 Configure ID (**CID**)<div class="wikimodel-emptyline"></div> 306 306 307 -Ex: #4CID5 <cr><div class="wikimodel-emptyline"></div>322 +Ex: #4CID5<cr><div class="wikimodel-emptyline"></div> 308 308 309 309 Setting a servo's ID in EEPROM is done via the CID command. All servos connected to the same serial bus that have will be assigned that ID. In most situations each servo must be set a unique ID, which means each servo must be connected individually to the serial bus and receive a unique CID number. It is best to do this before the servos are added to an assembly. Numbered stickers are provided to distinguish each servo after their ID is set, though you are free to use whatever alternative method you like. The servo must be RESET or power cycled in order for the new ID to take effect.<div class="wikimodel-emptyline"></div> 310 310 </div></div> 311 311 {{/html}} 312 312 328 +{{id name="BAUDRATE"/}} 329 + 313 313 ====== __Baud Rate__ ====== 314 314 315 -{{html clean="false" wiki="true"}}332 +{{html wiki="true" clean="false"}} 316 316 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 317 -A servo's baud rate cannot be set "on the fly" and must be configured via the CB command described below. The factory default baud rate for all servos is 115200. Since smart servos are intended to be daisy chained, in order to respond to the same serial command, all servos in a project should be set to the same baud rate. Setting different baud rates will have the servos respond differently and may create issues. Available baud rates are: 9600 bps, 19200 bps, 38400 bps, 57600 bps, 115.2 kbps, 230.4 kbps, 250.0 kbps, 460.8 kbps, 500.0 kbps , 750.0kbps, 921.6 kbps.Servos are shipped with a baud rate set to 115200.<div class="wikimodel-emptyline"></div>334 +A servo's baud rate cannot be set "on the fly" and must be configured via the CB command described below. The factory default baud rate for all servos is 115200. Since smart servos are intended to be daisy chained, in order to respond to the same serial command, all servos in a project should be set to the same baud rate. Setting different baud rates will have the servos respond differently and may create issues. Available baud rates are: 9600 bps, 19200 bps, 38400 bps, 57600 bps, 115.2 kbps, 230.4 kbps, 250.0 kbps, 460.8 kbps, 500.0 kbps. Servos are shipped with a baud rate set to 115200.<div class="wikimodel-emptyline"></div> 318 318 319 319 Query Baud Rate (**QB**)<div class="wikimodel-emptyline"></div> 320 320 321 -Ex: #5QB <cr>might return *5QB115200<cr><div class="wikimodel-emptyline"></div>338 +Ex: #5QB<cr> might return *5QB115200<cr><div class="wikimodel-emptyline"></div> 322 322 323 323 Since the command to query the baud rate must be done at the servo's existing baud rate, it can simply be used to confirm the CB configuration command was correctly received before the servo is power cycled and the new baud rate takes effect.<div class="wikimodel-emptyline"></div> 324 324 ... ... @@ -326,36 +326,18 @@ 326 326 327 327 **Important Note:** the servo's current session retains the given baud rate and the new baud rate will only take effect when the servo is power cycled / RESET.<div class="wikimodel-emptyline"></div> 328 328 329 -Ex: #5CB9600 <cr><div class="wikimodel-emptyline"></div>346 +Ex: #5CB9600<cr><div class="wikimodel-emptyline"></div> 330 330 331 331 Sending this command will change the baud rate associated with servo ID 5 to 9600 bits per second.<div class="wikimodel-emptyline"></div> 332 332 </div></div> 333 333 {{/html}} 334 334 335 - ====== __Automatic BaudRate__======352 +{{id name="MOTION"/}} 336 336 337 -{{html clean="false" wiki="true"}} 338 -<div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 339 -This option allows the LSS to listen to it's serial input and select the right baudrate automatically.<div class="wikimodel-emptyline"></div> 340 - 341 -Query Automatic Baud Rate (**QABR**)<div class="wikimodel-emptyline"></div> 342 - 343 -Ex: #5QABR<cr> might return *5ABR0<cr><div class="wikimodel-emptyline"></div> 344 - 345 -Enable Baud Rate (**ABR**)<div class="wikimodel-emptyline"></div> 346 - 347 -Ex: #5QABR1<cr><div class="wikimodel-emptyline"></div> 348 -Enable baudrate detection on first byte received after power-up.<div class="wikimodel-emptyline"></div> 349 - 350 -Ex: #5QABR2,30<cr><div class="wikimodel-emptyline"></div> 351 -Enable baudrate detection on first byte received after power-up. If no data for 30 seconds enable detection again on next byte.<div class="wikimodel-emptyline"></div> 352 - 353 -Warning: ABR doesnt work well with LSS Config at the moment.<div class="wikimodel-emptyline"></div> 354 -</div></div> 355 -{{/html}} 356 - 357 357 == Motion == 358 358 356 +{{id name="POSITION_D"/}} 357 + 359 359 ====== __Position in Degrees (**D**)__ ====== 360 360 361 361 {{html wiki="true" clean="false"}} ... ... @@ -381,6 +381,8 @@ 381 381 <div class="wikimodel-emptyline"></div></div></div> 382 382 {{/html}} 383 383 383 +{{id name="MOVE_D"/}} 384 + 384 384 ====== __(Relative) Move in Degrees (**MD**)__ ====== 385 385 386 386 {{html wiki="true" clean="false"}} ... ... @@ -391,6 +391,8 @@ 391 391 <div class="wikimodel-emptyline"></div></div></div> 392 392 {{/html}} 393 393 395 +{{id name="WHEEL_D"/}} 396 + 394 394 ====== __Wheel Mode in Degrees (**WD**)__ ====== 395 395 396 396 {{html wiki="true" clean="false"}} ... ... @@ -407,6 +407,8 @@ 407 407 <div class="wikimodel-emptyline"></div></div></div> 408 408 {{/html}} 409 409 413 +{{id name="WHEEL_RPM"/}} 414 + 410 410 ====== __Wheel Mode in RPM (**WR**)__ ====== 411 411 412 412 {{html wiki="true" clean="false"}} ... ... @@ -423,6 +423,8 @@ 423 423 <div class="wikimodel-emptyline"></div></div></div> 424 424 {{/html}} 425 425 431 +{{id name="POSITION_PWM"/}} 432 + 426 426 ====== __Position in PWM (**P**)__ ====== 427 427 428 428 {{html wiki="true" clean="false"}} ... ... @@ -440,6 +440,8 @@ 440 440 <div class="wikimodel-emptyline"></div></div></div> 441 441 {{/html}} 442 442 450 +{{id name="MOVE_PWM"/}} 451 + 443 443 ====== __(Relative) Move in PWM (**M**)__ ====== 444 444 445 445 {{html wiki="true" clean="false"}} ... ... @@ -450,6 +450,8 @@ 450 450 <div class="wikimodel-emptyline"></div></div></div> 451 451 {{/html}} 452 452 462 +{{id name="MOVE_RAW"/}} 463 + 453 453 ====== __Raw Duty-cycle Move (**RDM**)__ ====== 454 454 455 455 {{html wiki="true" clean="false"}} ... ... @@ -468,6 +468,8 @@ 468 468 <div class="wikimodel-emptyline"></div></div></div> 469 469 {{/html}} 470 470 482 +{{id name="QUERY_STATUS"/}} 483 + 471 471 ====== __Query Status (**Q**)__ ====== 472 472 473 473 {{html wiki="true" clean="false"}} ... ... @@ -485,7 +485,7 @@ 485 485 | |ex: *5Q3<cr>|3: Accelerating|Increasing speed from rest (or previous speed) towards travel speed 486 486 | |ex: *5Q4<cr>|4: Traveling|Moving at a stable speed 487 487 | |ex: *5Q5<cr>|5: Decelerating|Decreasing from travel speed towards final position. 488 -| |ex: *5Q6<cr>|6: Holding|Keeping current position (in EM0 mode, return will nornally be holding)501 +| |ex: *5Q6<cr>|6: Holding|Keeping current position 489 489 | |ex: *5Q7<cr>|7: Outside limits|{More details coming soon} 490 490 | |ex: *5Q8<cr>|8: Stuck|Motor cannot perform request movement at current speed setting 491 491 | |ex: *5Q9<cr>|9: Blocked|Similar to stuck, but the motor is at maximum duty and still cannot move (i.e.: stalled) ... ... @@ -507,6 +507,8 @@ 507 507 | |ex: *5Q2<cr>|Input voltage detected is below or above acceptable range|Check the voltage of your batteries or power source 508 508 | |ex: *5Q3<cr>|Temperature limit has been reached|The servo is too hot to continue operating safely. 509 509 523 +{{id name="LIMP"/}} 524 + 510 510 ====== __Limp (**L**)__ ====== 511 511 512 512 {{html wiki="true" clean="false"}} ... ... @@ -517,6 +517,8 @@ 517 517 <div class="wikimodel-emptyline"></div></div></div> 518 518 {{/html}} 519 519 535 +{{id name="HALT_HOLD"/}} 536 + 520 520 ====== __Halt & Hold (**H**)__ ====== 521 521 522 522 {{html wiki="true" clean="false"}} ... ... @@ -527,24 +527,24 @@ 527 527 <div class="wikimodel-emptyline"></div></div></div> 528 528 {{/html}} 529 529 547 +{{id name="MOTION_SETUP"/}} 548 + 530 530 == Motion Setup == 531 531 551 +{{id name="MOTION_PROFILE"/}} 552 + 532 532 ====== __Enable Motion Profile (**EM**)__ ====== 533 533 534 -{{html clean="false" wiki="true"}}555 +{{html wiki="true" clean="false"}} 535 535 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 536 -EM1 (Enable Motion Profile #1) is the default mode of the LSS and is an easy way to control the servo's position with a single (serial) position command. This mode uses a trapezoidal motion profile which takes care of acceleration, constant speed travel and deceleration. Once the actual position is within a certain value of the target, it switches to a holding algorithm. The LSS commands for Angular Acceleration and Deceleration (AA/CAA/AD/CAD) Angular Stiffness (AS/CAS) and Angular holding stiffness (AH/CAH) affect this motion profile. Modifiers like SD/S and T can be used in EM1.<div class="wikimodel-emptyline"></div> 537 - 538 538 Ex: #5EM1<cr><div class="wikimodel-emptyline"></div> 539 539 540 -This command enables a trapezoidal motion profile for servo #5<div class="wikimodel-emptyline"></div>559 +This command enables a trapezoidal motion profile. By default, the trapezoidal motion profile is enabled. If the motion profile is enabled, angular acceleration (AA) and angular deceleration(AD) will have an effect on the motion. Also, SD/S and T modifiers can be used.<div class="wikimodel-emptyline"></div> 541 541 542 542 Ex: #5EM0<cr><div class="wikimodel-emptyline"></div> 543 543 544 -This command will disable the built-in trapezoidal motion profile. As such, the servo will move at full speedtothe targetposition using theD/MD action commands.Modifierslike SD/S orT cannot beused in EM0 mode. By default theFilterPositionCounter,or "FPC" isactive inEM0 modeto smooth out its operation. EM0 is suggested for applications wherean external controller will bedetermining all incrementalintermediate positionsoftheservo's motion,effectivelyreplacing a trajectory manager.Topreventhaving tosendpositioncommands continuouslytoreachthedesiredpositionin EM0/FPCactive(FPC>= 2),aninternal positionengine(IPE) repeatsthe last position command. Note that in EM0 mode, the servo willeffectivelyalways beinstatus: Holding (if using thequery status command).563 +This command will disable the trapezoidal motion profile. As such, the servo will move at full speed for D/MD action commands. Angular acceleration (AA) and angular deceleration(AD) won't have an effect on motion in this mode and modifiers SD/S or T cannot be used.<div class="wikimodel-emptyline"></div> 545 545 546 -<div class="wikimodel-emptyline"></div> 547 - 548 548 Query Motion Profile (**QEM**)<div class="wikimodel-emptyline"></div> 549 549 550 550 Ex: #5QEM<cr> might return *5QEM1<cr><div class="wikimodel-emptyline"></div> ... ... @@ -559,12 +559,12 @@ 559 559 <div class="wikimodel-emptyline"></div></div></div> 560 560 {{/html}} 561 561 579 +{{id name="FILTER_POSITION_COUNT"/}} 580 + 562 562 ====== __Filter Position Count (**FPC**)__ ====== 563 563 564 -{{html clean="false" wiki="true"}}583 +{{html wiki="true" clean="false"}} 565 565 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 566 -The FPC value relates to the depth of a first order filter (exponential weighted average) over the position change. This has the effect of slowing down both acceleration and deceleration while still allowing the LSS to try to reach the desired position at maximum power at all times. A smaller FPC value will reduce the smoothing effect and a larger value will increase it. To prevent having to send position commands continuously to reach the desired position in EM0/FPC active (FPC >= 2), an internal position engine (IPE) has been put in place, which is also active by default. 567 -<div class="wikimodel-emptyline"></div> 568 568 Ex: #5FPC10<cr><div class="wikimodel-emptyline"></div> 569 569 This command allows the user to change the Filter Position Count value for that session. <div class="wikimodel-emptyline"></div> 570 570 ... ... @@ -582,6 +582,8 @@ 582 582 <div class="wikimodel-emptyline"></div></div></div> 583 583 {{/html}} 584 584 602 +{{id name="ORIGIN_OFFSET"/}} 603 + 585 585 ====== __Origin Offset (**O**)__ ====== 586 586 587 587 {{html wiki="true" clean="false"}} ... ... @@ -610,6 +610,8 @@ 610 610 <div class="wikimodel-emptyline"></div></div></div> 611 611 {{/html}} 612 612 632 +{{id name="ANGULAR_RANGE"/}} 633 + 613 613 ====== __Angular Range (**AR**)__ ====== 614 614 615 615 {{html wiki="true" clean="false"}} ... ... @@ -638,6 +638,8 @@ 638 638 <div class="wikimodel-emptyline"></div></div></div> 639 639 {{/html}} 640 640 662 +{{id name="ANGULAR_STIFFNESS"/}} 663 + 641 641 ====== __Angular Stiffness (**AS**)__ ====== 642 642 643 643 {{html wiki="true" clean="false"}} ... ... @@ -670,6 +670,8 @@ 670 670 <div class="wikimodel-emptyline"></div></div></div> 671 671 {{/html}} 672 672 696 +{{id name="ANGULAR_HOLDING_STIFFNESS"/}} 697 + 673 673 ====== __Angular Holding Stiffness (**AH**)__ ====== 674 674 675 675 {{html wiki="true" clean="false"}} ... ... @@ -694,6 +694,8 @@ 694 694 <div class="wikimodel-emptyline"></div></div></div> 695 695 {{/html}} 696 696 722 +{{id name="ANGULAR_ACCELERATION"/}} 723 + 697 697 ====== __Angular Acceleration (**AA**)__ ====== 698 698 699 699 {{html wiki="true" clean="false"}} ... ... @@ -718,6 +718,8 @@ 718 718 <div class="wikimodel-emptyline"></div></div></div> 719 719 {{/html}} 720 720 748 +{{id name="ANGULAR_DECELERATION"/}} 749 + 721 721 ====== __Angular Deceleration (**AD**)__ ====== 722 722 723 723 {{html wiki="true" clean="false"}} ... ... @@ -742,6 +742,8 @@ 742 742 <div class="wikimodel-emptyline"></div></div></div> 743 743 {{/html}} 744 744 774 +{{id name="GYRE_DIRECTION"/}} 775 + 745 745 ====== __Gyre Direction (**G**)__ ====== 746 746 747 747 {{html wiki="true" clean="false"}} ... ... @@ -766,6 +766,8 @@ 766 766 <div class="wikimodel-emptyline"></div></div></div> 767 767 {{/html}} 768 768 800 +{{id name="FIRST_POSITION"/}} 801 + 769 769 ====== __First Position__ ====== 770 770 771 771 {{html wiki="true" clean="false"}} ... ... @@ -786,6 +786,8 @@ 786 786 <div class="wikimodel-emptyline"></div></div></div> 787 787 {{/html}} 788 788 822 +{{id name="MAXIMUM_RAW"/}} 823 + 789 789 ====== __Maximum Motor Duty (**MMD**)__ ====== 790 790 791 791 {{html wiki="true" clean="false"}} ... ... @@ -800,10 +800,12 @@ 800 800 801 801 Ex: #5QMMDD<cr> might return *5QMMD512<cr> <div class="wikimodel-emptyline"></div> 802 802 803 -This command returns theconfigured limit ofthedutycyclevaluesentfrom theservo'sMCUtotheMotorController.Thedefault valueis1023.838 +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> 804 804 <div class="wikimodel-emptyline"></div></div></div> 805 805 {{/html}} 806 806 842 +{{id name="MAXIMUM_SPEED_D"/}} 843 + 807 807 ====== __Maximum Speed in Degrees (**SD**)__ ====== 808 808 809 809 {{html wiki="true" clean="false"}} ... ... @@ -830,6 +830,8 @@ 830 830 </div></div> 831 831 {{/html}} 832 832 870 +{{id name="MAXIMUM_SPEED_RPM"/}} 871 + 833 833 ====== __Maximum Speed in RPM (**SR**)__ ====== 834 834 835 835 {{html wiki="true" clean="false"}} ... ... @@ -856,16 +856,20 @@ 856 856 </div></div> 857 857 {{/html}} 858 858 898 +{{id name="MODIFIERS"/}} 899 + 859 859 == Modifiers == 860 860 902 +{{id name="SPEEDS"/}} 903 + 861 861 ====== __Speed (**S**, **SD**) modifier__ ====== 862 862 863 -{{html clean="false" wiki="true"}}906 +{{html wiki="true" clean="false"}} 864 864 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 865 865 Example: #5P1500S750<cr><div class="wikimodel-emptyline"></div> 866 866 Modifier (S) is only for a position (P) action and determines the speed of the move in microseconds per second. A speed of 750 microseconds would cause the servo to rotate from its current position to the desired position at a speed of 750 microseconds per second. This command is in place to ensure backwards compatibility with the SSC-32 / 32U protocol.<div class="wikimodel-emptyline"></div> 867 867 Example: #5D0SD180<cr><div class="wikimodel-emptyline"></div> 868 -Modifier (SD) is only for a position (D) or relative position (MD) action and determines the speed of the move in tenths ofdegrees 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.<div class="wikimodel-emptyline"></div>911 +Modifier (SD) is only for a position (D) or relative position (MD) action and determines the speed of the move in 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 180 degrees per second.<div class="wikimodel-emptyline"></div> 869 869 Query Speed (**QS**)<div class="wikimodel-emptyline"></div> 870 870 Example: #5QS<cr> might return *5QS300<cr><div class="wikimodel-emptyline"></div> 871 871 This command queries the current speed in microseconds per second.<div class="wikimodel-emptyline"></div> ... ... @@ -872,6 +872,8 @@ 872 872 </div></div> 873 873 {{/html}} 874 874 918 +{{id name="TIMED_MOVE"/}} 919 + 875 875 ====== __Timed move (**T**) modifier__ ====== 876 876 877 877 {{html wiki="true" clean="false"}} ... ... @@ -883,6 +883,8 @@ 883 883 </div></div> 884 884 {{/html}} 885 885 931 +{{id name="CURRENT_HOLD"/}} 932 + 886 886 ====== __Current Halt & Hold (**CH**) modifier__ ====== 887 887 888 888 {{html wiki="true" clean="false"}} ... ... @@ -894,6 +894,8 @@ 894 894 </div></div> 895 895 {{/html}} 896 896 944 +{{id name="CURRENT_LIMP"/}} 945 + 897 897 ====== __Current Limp (**CL**) modifier__ ====== 898 898 899 899 {{html wiki="true" clean="false"}} ... ... @@ -905,8 +905,12 @@ 905 905 </div></div> 906 906 {{/html}} 907 907 957 +{{id name="TELEMETRY"/}} 958 + 908 908 == Telemetry == 909 909 961 +{{id name="QUERY_VOLTAGE"/}} 962 + 910 910 ====== __Query Voltage (**QV**)__ ====== 911 911 912 912 {{html wiki="true" clean="false"}} ... ... @@ -916,6 +916,8 @@ 916 916 </div></div> 917 917 {{/html}} 918 918 972 +{{id name="QUERY_TEMP"/}} 973 + 919 919 ====== __Query Temperature (**QT**)__ ====== 920 920 921 921 {{html wiki="true" clean="false"}} ... ... @@ -925,6 +925,8 @@ 925 925 </div></div> 926 926 {{/html}} 927 927 983 +{{id name="QUERY_CURRENT"/}} 984 + 928 928 ====== __Query Current (**QC**)__ ====== 929 929 930 930 {{html wiki="true" clean="false"}} ... ... @@ -934,6 +934,8 @@ 934 934 </div></div> 935 935 {{/html}} 936 936 994 +{{id name="QUERY_MODEL"/}} 995 + 937 937 ====== __Query Model String (**QMS**)__ ====== 938 938 939 939 {{html wiki="true" clean="false"}} ... ... @@ -943,6 +943,8 @@ 943 943 </div></div> 944 944 {{/html}} 945 945 1005 +{{id name="QUERY_FIRMWARE"/}} 1006 + 946 946 ====== __Query Firmware (**QF**)__ ====== 947 947 948 948 {{html wiki="true" clean="false"}} ... ... @@ -953,10 +953,23 @@ 953 953 </div></div> 954 954 {{/html}} 955 955 956 - ===========1017 +{{id name="QUERY_SERIAL"/}} 957 957 1019 +====== __Query Serial Number (**QN**)__ ====== 1020 + 1021 +{{html wiki="true" clean="false"}} 1022 +<div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 1023 +Ex: #5QN<cr> might return *5QN12345678<cr><div class="wikimodel-emptyline"></div> 1024 +The number in the response (12345678) would be the servo's serial number which is set and should not be changed by the user.<div class="wikimodel-emptyline"></div> 1025 +</div></div> 1026 +{{/html}} 1027 + 1028 +{{id name="RGB_LED"/}} 1029 + 958 958 == RGB LED == 959 959 1032 +{{id name="LED_COLOR"/}} 1033 + 960 960 ====== __LED Color (**LED**)__ ====== 961 961 962 962 {{html wiki="true" clean="false"}} ... ... @@ -973,6 +973,8 @@ 973 973 </div></div> 974 974 {{/html}} 975 975 1050 +{{id name="LED_BLINK"/}} 1051 + 976 976 ====== __Configure LED Blinking (**CLB**)__ ====== 977 977 978 978 {{html wiki="true" clean="false"}}