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,90 +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" %)✓| | |210 -| |[[**Q**uery Serial **N**umber>>||anchor=" HQuerySerialNumber28QN29"]]|(% 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 servo205 +| |[[**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 211 211 212 -|(% 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"]] 213 213 |(% 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** 214 -| |[[**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=White215 -| |[[**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. 216 216 217 217 = (% style="color:inherit; font-family:inherit" %)Details(%%) = 218 218 219 +{{id name="COMMUNICATION_SETUP"/}} 220 + 219 219 == (% style="color:inherit; font-family:inherit" %)Communication Setup(%%) == 220 220 223 +{{id name="RESET"/}} 224 + 221 221 ====== __Reset__ ====== 222 222 223 223 {{html wiki="true" clean="false"}} 224 224 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 225 -Ex: #5RESET <cr><div class="wikimodel-emptyline"></div>229 +Ex: #5RESET<cr><div class="wikimodel-emptyline"></div> 226 226 This command does a "soft reset" and reverts all commands to those stored in EEPROM (i.e. configuration commands). 227 227 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> 228 228 </div></div> 229 229 {{/html}} 230 230 235 +{{id name="DEFAULT"/}} 236 + 231 231 ====== __Default & confirm__ ====== 232 232 233 233 {{html wiki="true" clean="false"}} 234 234 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 235 -Ex: #5DEFAULT <cr><div class="wikimodel-emptyline"></div>241 +Ex: #5DEFAULT<cr><div class="wikimodel-emptyline"></div> 236 236 237 237 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> 238 238 239 -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> 240 240 241 241 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> 242 242 ... ... @@ -244,15 +244,17 @@ 244 244 </div></div> 245 245 {{/html}} 246 246 253 +{{id name="UPDATE_CONFIRM"/}} 254 + 247 247 ====== __Update & confirm__ ====== 248 248 249 249 {{html wiki="true" clean="false"}} 250 250 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 251 -Ex: #5UPDATE <cr><div class="wikimodel-emptyline"></div>259 +Ex: #5UPDATE<cr><div class="wikimodel-emptyline"></div> 252 252 253 253 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> 254 254 255 -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> 256 256 257 257 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> 258 258 ... ... @@ -260,6 +260,8 @@ 260 260 </div></div> 261 261 {{/html}} 262 262 271 +{{id name="CONFIRM"/}} 272 + 263 263 ====== __Confirm__ ====== 264 264 265 265 {{html wiki="true" clean="false"}} ... ... @@ -272,6 +272,8 @@ 272 272 </div></div> 273 273 {{/html}} 274 274 285 +{{id name="CHANGE_RC"/}} 286 + 275 275 ====== __Configure RC Mode (**CRC**)__ ====== 276 276 277 277 {{html wiki="true" clean="false"}} ... ... @@ -279,18 +279,20 @@ 279 279 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> 280 280 281 281 |**Command sent**|**Note** 282 -|ex: #5CRC1 <cr>|Change to RC position mode.283 -|ex: #5CRC2 <cr>|Change to RC continuous rotation (wheel) mode.284 -|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> 285 285 286 -EX: #5CRC2 <cr><div class="wikimodel-emptyline"></div>298 +EX: #5CRC2<cr><div class="wikimodel-emptyline"></div> 287 287 288 -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> 289 289 290 290 **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> 291 291 </div></div> 292 292 {{/html}} 293 293 306 +{{id name="ID"/}} 307 + 294 294 ====== __Identification Number (**ID**)__ ====== 295 295 296 296 {{html wiki="true" clean="false"}} ... ... @@ -299,27 +299,29 @@ 299 299 300 300 Query Identification (**QID**)<div class="wikimodel-emptyline"></div> 301 301 302 -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> 303 303 304 304 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> 305 305 306 306 Configure ID (**CID**)<div class="wikimodel-emptyline"></div> 307 307 308 -Ex: #4CID5 <cr><div class="wikimodel-emptyline"></div>322 +Ex: #4CID5<cr><div class="wikimodel-emptyline"></div> 309 309 310 310 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> 311 311 </div></div> 312 312 {{/html}} 313 313 328 +{{id name="BAUDRATE"/}} 329 + 314 314 ====== __Baud Rate__ ====== 315 315 316 -{{html clean="false" wiki="true"}}332 +{{html wiki="true" clean="false"}} 317 317 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 318 -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> 319 319 320 320 Query Baud Rate (**QB**)<div class="wikimodel-emptyline"></div> 321 321 322 -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> 323 323 324 324 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> 325 325 ... ... @@ -327,36 +327,18 @@ 327 327 328 328 **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> 329 329 330 -Ex: #5CB9600 <cr><div class="wikimodel-emptyline"></div>346 +Ex: #5CB9600<cr><div class="wikimodel-emptyline"></div> 331 331 332 332 Sending this command will change the baud rate associated with servo ID 5 to 9600 bits per second.<div class="wikimodel-emptyline"></div> 333 333 </div></div> 334 334 {{/html}} 335 335 336 - ====== __Automatic BaudRate__======352 +{{id name="MOTION"/}} 337 337 338 -{{html clean="false" wiki="true"}} 339 -<div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 340 -This option allows the LSS to listen to it's serial input and select the right baudrate automatically.<div class="wikimodel-emptyline"></div> 341 - 342 -Query Automatic Baud Rate (**QABR**)<div class="wikimodel-emptyline"></div> 343 - 344 -Ex: #5QABR<cr> might return *5ABR0<cr><div class="wikimodel-emptyline"></div> 345 - 346 -Enable Baud Rate (**ABR**)<div class="wikimodel-emptyline"></div> 347 - 348 -Ex: #5QABR1<cr><div class="wikimodel-emptyline"></div> 349 -Enable baudrate detection on first byte received after power-up.<div class="wikimodel-emptyline"></div> 350 - 351 -Ex: #5QABR2,30<cr><div class="wikimodel-emptyline"></div> 352 -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> 353 - 354 -Warning: ABR doesnt work well with LSS Config at the moment.<div class="wikimodel-emptyline"></div> 355 -</div></div> 356 -{{/html}} 357 - 358 358 == Motion == 359 359 356 +{{id name="POSITION_D"/}} 357 + 360 360 ====== __Position in Degrees (**D**)__ ====== 361 361 362 362 {{html wiki="true" clean="false"}} ... ... @@ -382,6 +382,8 @@ 382 382 <div class="wikimodel-emptyline"></div></div></div> 383 383 {{/html}} 384 384 383 +{{id name="MOVE_D"/}} 384 + 385 385 ====== __(Relative) Move in Degrees (**MD**)__ ====== 386 386 387 387 {{html wiki="true" clean="false"}} ... ... @@ -392,6 +392,8 @@ 392 392 <div class="wikimodel-emptyline"></div></div></div> 393 393 {{/html}} 394 394 395 +{{id name="WHEEL_D"/}} 396 + 395 395 ====== __Wheel Mode in Degrees (**WD**)__ ====== 396 396 397 397 {{html wiki="true" clean="false"}} ... ... @@ -408,6 +408,8 @@ 408 408 <div class="wikimodel-emptyline"></div></div></div> 409 409 {{/html}} 410 410 413 +{{id name="WHEEL_RPM"/}} 414 + 411 411 ====== __Wheel Mode in RPM (**WR**)__ ====== 412 412 413 413 {{html wiki="true" clean="false"}} ... ... @@ -424,6 +424,8 @@ 424 424 <div class="wikimodel-emptyline"></div></div></div> 425 425 {{/html}} 426 426 431 +{{id name="POSITION_PWM"/}} 432 + 427 427 ====== __Position in PWM (**P**)__ ====== 428 428 429 429 {{html wiki="true" clean="false"}} ... ... @@ -441,6 +441,8 @@ 441 441 <div class="wikimodel-emptyline"></div></div></div> 442 442 {{/html}} 443 443 450 +{{id name="MOVE_PWM"/}} 451 + 444 444 ====== __(Relative) Move in PWM (**M**)__ ====== 445 445 446 446 {{html wiki="true" clean="false"}} ... ... @@ -451,6 +451,8 @@ 451 451 <div class="wikimodel-emptyline"></div></div></div> 452 452 {{/html}} 453 453 462 +{{id name="MOVE_RAW"/}} 463 + 454 454 ====== __Raw Duty-cycle Move (**RDM**)__ ====== 455 455 456 456 {{html wiki="true" clean="false"}} ... ... @@ -469,6 +469,8 @@ 469 469 <div class="wikimodel-emptyline"></div></div></div> 470 470 {{/html}} 471 471 482 +{{id name="QUERY_STATUS"/}} 483 + 472 472 ====== __Query Status (**Q**)__ ====== 473 473 474 474 {{html wiki="true" clean="false"}} ... ... @@ -486,7 +486,7 @@ 486 486 | |ex: *5Q3<cr>|3: Accelerating|Increasing speed from rest (or previous speed) towards travel speed 487 487 | |ex: *5Q4<cr>|4: Traveling|Moving at a stable speed 488 488 | |ex: *5Q5<cr>|5: Decelerating|Decreasing from travel speed towards final position. 489 -| |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 490 490 | |ex: *5Q7<cr>|7: Outside limits|{More details coming soon} 491 491 | |ex: *5Q8<cr>|8: Stuck|Motor cannot perform request movement at current speed setting 492 492 | |ex: *5Q9<cr>|9: Blocked|Similar to stuck, but the motor is at maximum duty and still cannot move (i.e.: stalled) ... ... @@ -508,6 +508,8 @@ 508 508 | |ex: *5Q2<cr>|Input voltage detected is below or above acceptable range|Check the voltage of your batteries or power source 509 509 | |ex: *5Q3<cr>|Temperature limit has been reached|The servo is too hot to continue operating safely. 510 510 523 +{{id name="LIMP"/}} 524 + 511 511 ====== __Limp (**L**)__ ====== 512 512 513 513 {{html wiki="true" clean="false"}} ... ... @@ -518,6 +518,8 @@ 518 518 <div class="wikimodel-emptyline"></div></div></div> 519 519 {{/html}} 520 520 535 +{{id name="HALT_HOLD"/}} 536 + 521 521 ====== __Halt & Hold (**H**)__ ====== 522 522 523 523 {{html wiki="true" clean="false"}} ... ... @@ -528,24 +528,24 @@ 528 528 <div class="wikimodel-emptyline"></div></div></div> 529 529 {{/html}} 530 530 547 +{{id name="MOTION_SETUP"/}} 548 + 531 531 == Motion Setup == 532 532 551 +{{id name="MOTION_PROFILE"/}} 552 + 533 533 ====== __Enable Motion Profile (**EM**)__ ====== 534 534 535 -{{html clean="false" wiki="true"}}555 +{{html wiki="true" clean="false"}} 536 536 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 537 -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> 538 - 539 539 Ex: #5EM1<cr><div class="wikimodel-emptyline"></div> 540 540 541 -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> 542 542 543 543 Ex: #5EM0<cr><div class="wikimodel-emptyline"></div> 544 544 545 -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> 546 546 547 -<div class="wikimodel-emptyline"></div> 548 - 549 549 Query Motion Profile (**QEM**)<div class="wikimodel-emptyline"></div> 550 550 551 551 Ex: #5QEM<cr> might return *5QEM1<cr><div class="wikimodel-emptyline"></div> ... ... @@ -560,12 +560,12 @@ 560 560 <div class="wikimodel-emptyline"></div></div></div> 561 561 {{/html}} 562 562 579 +{{id name="FILTER_POSITION_COUNT"/}} 580 + 563 563 ====== __Filter Position Count (**FPC**)__ ====== 564 564 565 -{{html clean="false" wiki="true"}}583 +{{html wiki="true" clean="false"}} 566 566 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 567 -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. 568 -<div class="wikimodel-emptyline"></div> 569 569 Ex: #5FPC10<cr><div class="wikimodel-emptyline"></div> 570 570 This command allows the user to change the Filter Position Count value for that session. <div class="wikimodel-emptyline"></div> 571 571 ... ... @@ -583,6 +583,8 @@ 583 583 <div class="wikimodel-emptyline"></div></div></div> 584 584 {{/html}} 585 585 602 +{{id name="ORIGIN_OFFSET"/}} 603 + 586 586 ====== __Origin Offset (**O**)__ ====== 587 587 588 588 {{html wiki="true" clean="false"}} ... ... @@ -611,6 +611,8 @@ 611 611 <div class="wikimodel-emptyline"></div></div></div> 612 612 {{/html}} 613 613 632 +{{id name="ANGULAR_RANGE"/}} 633 + 614 614 ====== __Angular Range (**AR**)__ ====== 615 615 616 616 {{html wiki="true" clean="false"}} ... ... @@ -639,6 +639,8 @@ 639 639 <div class="wikimodel-emptyline"></div></div></div> 640 640 {{/html}} 641 641 662 +{{id name="ANGULAR_STIFFNESS"/}} 663 + 642 642 ====== __Angular Stiffness (**AS**)__ ====== 643 643 644 644 {{html wiki="true" clean="false"}} ... ... @@ -671,6 +671,8 @@ 671 671 <div class="wikimodel-emptyline"></div></div></div> 672 672 {{/html}} 673 673 696 +{{id name="ANGULAR_HOLDING_STIFFNESS"/}} 697 + 674 674 ====== __Angular Holding Stiffness (**AH**)__ ====== 675 675 676 676 {{html wiki="true" clean="false"}} ... ... @@ -695,6 +695,8 @@ 695 695 <div class="wikimodel-emptyline"></div></div></div> 696 696 {{/html}} 697 697 722 +{{id name="ANGULAR_ACCELERATION"/}} 723 + 698 698 ====== __Angular Acceleration (**AA**)__ ====== 699 699 700 700 {{html wiki="true" clean="false"}} ... ... @@ -719,6 +719,8 @@ 719 719 <div class="wikimodel-emptyline"></div></div></div> 720 720 {{/html}} 721 721 748 +{{id name="ANGULAR_DECELERATION"/}} 749 + 722 722 ====== __Angular Deceleration (**AD**)__ ====== 723 723 724 724 {{html wiki="true" clean="false"}} ... ... @@ -743,6 +743,8 @@ 743 743 <div class="wikimodel-emptyline"></div></div></div> 744 744 {{/html}} 745 745 774 +{{id name="GYRE_DIRECTION"/}} 775 + 746 746 ====== __Gyre Direction (**G**)__ ====== 747 747 748 748 {{html wiki="true" clean="false"}} ... ... @@ -767,6 +767,8 @@ 767 767 <div class="wikimodel-emptyline"></div></div></div> 768 768 {{/html}} 769 769 800 +{{id name="FIRST_POSITION"/}} 801 + 770 770 ====== __First Position__ ====== 771 771 772 772 {{html wiki="true" clean="false"}} ... ... @@ -787,6 +787,8 @@ 787 787 <div class="wikimodel-emptyline"></div></div></div> 788 788 {{/html}} 789 789 822 +{{id name="MAXIMUM_RAW"/}} 823 + 790 790 ====== __Maximum Motor Duty (**MMD**)__ ====== 791 791 792 792 {{html wiki="true" clean="false"}} ... ... @@ -801,10 +801,12 @@ 801 801 802 802 Ex: #5QMMDD<cr> might return *5QMMD512<cr> <div class="wikimodel-emptyline"></div> 803 803 804 -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> 805 805 <div class="wikimodel-emptyline"></div></div></div> 806 806 {{/html}} 807 807 842 +{{id name="MAXIMUM_SPEED_D"/}} 843 + 808 808 ====== __Maximum Speed in Degrees (**SD**)__ ====== 809 809 810 810 {{html wiki="true" clean="false"}} ... ... @@ -831,6 +831,8 @@ 831 831 </div></div> 832 832 {{/html}} 833 833 870 +{{id name="MAXIMUM_SPEED_RPM"/}} 871 + 834 834 ====== __Maximum Speed in RPM (**SR**)__ ====== 835 835 836 836 {{html wiki="true" clean="false"}} ... ... @@ -857,16 +857,20 @@ 857 857 </div></div> 858 858 {{/html}} 859 859 898 +{{id name="MODIFIERS"/}} 899 + 860 860 == Modifiers == 861 861 902 +{{id name="SPEEDS"/}} 903 + 862 862 ====== __Speed (**S**, **SD**) modifier__ ====== 863 863 864 -{{html clean="false" wiki="true"}}906 +{{html wiki="true" clean="false"}} 865 865 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 866 866 Example: #5P1500S750<cr><div class="wikimodel-emptyline"></div> 867 867 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> 868 868 Example: #5D0SD180<cr><div class="wikimodel-emptyline"></div> 869 -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> 870 870 Query Speed (**QS**)<div class="wikimodel-emptyline"></div> 871 871 Example: #5QS<cr> might return *5QS300<cr><div class="wikimodel-emptyline"></div> 872 872 This command queries the current speed in microseconds per second.<div class="wikimodel-emptyline"></div> ... ... @@ -873,6 +873,8 @@ 873 873 </div></div> 874 874 {{/html}} 875 875 918 +{{id name="TIMED_MOVE"/}} 919 + 876 876 ====== __Timed move (**T**) modifier__ ====== 877 877 878 878 {{html wiki="true" clean="false"}} ... ... @@ -884,6 +884,8 @@ 884 884 </div></div> 885 885 {{/html}} 886 886 931 +{{id name="CURRENT_HOLD"/}} 932 + 887 887 ====== __Current Halt & Hold (**CH**) modifier__ ====== 888 888 889 889 {{html wiki="true" clean="false"}} ... ... @@ -895,6 +895,8 @@ 895 895 </div></div> 896 896 {{/html}} 897 897 944 +{{id name="CURRENT_LIMP"/}} 945 + 898 898 ====== __Current Limp (**CL**) modifier__ ====== 899 899 900 900 {{html wiki="true" clean="false"}} ... ... @@ -906,8 +906,12 @@ 906 906 </div></div> 907 907 {{/html}} 908 908 957 +{{id name="TELEMETRY"/}} 958 + 909 909 == Telemetry == 910 910 961 +{{id name="QUERY_VOLTAGE"/}} 962 + 911 911 ====== __Query Voltage (**QV**)__ ====== 912 912 913 913 {{html wiki="true" clean="false"}} ... ... @@ -917,6 +917,8 @@ 917 917 </div></div> 918 918 {{/html}} 919 919 972 +{{id name="QUERY_TEMP"/}} 973 + 920 920 ====== __Query Temperature (**QT**)__ ====== 921 921 922 922 {{html wiki="true" clean="false"}} ... ... @@ -926,6 +926,8 @@ 926 926 </div></div> 927 927 {{/html}} 928 928 983 +{{id name="QUERY_CURRENT"/}} 984 + 929 929 ====== __Query Current (**QC**)__ ====== 930 930 931 931 {{html wiki="true" clean="false"}} ... ... @@ -935,6 +935,8 @@ 935 935 </div></div> 936 936 {{/html}} 937 937 994 +{{id name="QUERY_MODEL"/}} 995 + 938 938 ====== __Query Model String (**QMS**)__ ====== 939 939 940 940 {{html wiki="true" clean="false"}} ... ... @@ -944,6 +944,8 @@ 944 944 </div></div> 945 945 {{/html}} 946 946 1005 +{{id name="QUERY_FIRMWARE"/}} 1006 + 947 947 ====== __Query Firmware (**QF**)__ ====== 948 948 949 949 {{html wiki="true" clean="false"}} ... ... @@ -954,6 +954,8 @@ 954 954 </div></div> 955 955 {{/html}} 956 956 1017 +{{id name="QUERY_SERIAL"/}} 1018 + 957 957 ====== __Query Serial Number (**QN**)__ ====== 958 958 959 959 {{html wiki="true" clean="false"}} ... ... @@ -963,8 +963,12 @@ 963 963 </div></div> 964 964 {{/html}} 965 965 1028 +{{id name="RGB_LED"/}} 1029 + 966 966 == RGB LED == 967 967 1032 +{{id name="LED_COLOR"/}} 1033 + 968 968 ====== __LED Color (**LED**)__ ====== 969 969 970 970 {{html wiki="true" clean="false"}} ... ... @@ -981,6 +981,8 @@ 981 981 </div></div> 982 982 {{/html}} 983 983 1050 +{{id name="LED_BLINK"/}} 1051 + 984 984 ====== __Configure LED Blinking (**CLB**)__ ====== 985 985 986 986 {{html wiki="true" clean="false"}}