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,22 +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 -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.0 kbps, 921.6 kbps. Servos are shipped with a baud rate set to 115200.<div class="wikimodel-emptyline"></div> 341 -</div></div> 342 -{{/html} 343 - 344 344 == Motion == 345 345 356 +{{id name="POSITION_D"/}} 357 + 346 346 ====== __Position in Degrees (**D**)__ ====== 347 347 348 348 {{html wiki="true" clean="false"}} ... ... @@ -368,6 +368,8 @@ 368 368 <div class="wikimodel-emptyline"></div></div></div> 369 369 {{/html}} 370 370 383 +{{id name="MOVE_D"/}} 384 + 371 371 ====== __(Relative) Move in Degrees (**MD**)__ ====== 372 372 373 373 {{html wiki="true" clean="false"}} ... ... @@ -378,6 +378,8 @@ 378 378 <div class="wikimodel-emptyline"></div></div></div> 379 379 {{/html}} 380 380 395 +{{id name="WHEEL_D"/}} 396 + 381 381 ====== __Wheel Mode in Degrees (**WD**)__ ====== 382 382 383 383 {{html wiki="true" clean="false"}} ... ... @@ -394,6 +394,8 @@ 394 394 <div class="wikimodel-emptyline"></div></div></div> 395 395 {{/html}} 396 396 413 +{{id name="WHEEL_RPM"/}} 414 + 397 397 ====== __Wheel Mode in RPM (**WR**)__ ====== 398 398 399 399 {{html wiki="true" clean="false"}} ... ... @@ -410,6 +410,8 @@ 410 410 <div class="wikimodel-emptyline"></div></div></div> 411 411 {{/html}} 412 412 431 +{{id name="POSITION_PWM"/}} 432 + 413 413 ====== __Position in PWM (**P**)__ ====== 414 414 415 415 {{html wiki="true" clean="false"}} ... ... @@ -427,6 +427,8 @@ 427 427 <div class="wikimodel-emptyline"></div></div></div> 428 428 {{/html}} 429 429 450 +{{id name="MOVE_PWM"/}} 451 + 430 430 ====== __(Relative) Move in PWM (**M**)__ ====== 431 431 432 432 {{html wiki="true" clean="false"}} ... ... @@ -437,6 +437,8 @@ 437 437 <div class="wikimodel-emptyline"></div></div></div> 438 438 {{/html}} 439 439 462 +{{id name="MOVE_RAW"/}} 463 + 440 440 ====== __Raw Duty-cycle Move (**RDM**)__ ====== 441 441 442 442 {{html wiki="true" clean="false"}} ... ... @@ -455,6 +455,8 @@ 455 455 <div class="wikimodel-emptyline"></div></div></div> 456 456 {{/html}} 457 457 482 +{{id name="QUERY_STATUS"/}} 483 + 458 458 ====== __Query Status (**Q**)__ ====== 459 459 460 460 {{html wiki="true" clean="false"}} ... ... @@ -472,7 +472,7 @@ 472 472 | |ex: *5Q3<cr>|3: Accelerating|Increasing speed from rest (or previous speed) towards travel speed 473 473 | |ex: *5Q4<cr>|4: Traveling|Moving at a stable speed 474 474 | |ex: *5Q5<cr>|5: Decelerating|Decreasing from travel speed towards final position. 475 -| |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 476 476 | |ex: *5Q7<cr>|7: Outside limits|{More details coming soon} 477 477 | |ex: *5Q8<cr>|8: Stuck|Motor cannot perform request movement at current speed setting 478 478 | |ex: *5Q9<cr>|9: Blocked|Similar to stuck, but the motor is at maximum duty and still cannot move (i.e.: stalled) ... ... @@ -494,6 +494,8 @@ 494 494 | |ex: *5Q2<cr>|Input voltage detected is below or above acceptable range|Check the voltage of your batteries or power source 495 495 | |ex: *5Q3<cr>|Temperature limit has been reached|The servo is too hot to continue operating safely. 496 496 523 +{{id name="LIMP"/}} 524 + 497 497 ====== __Limp (**L**)__ ====== 498 498 499 499 {{html wiki="true" clean="false"}} ... ... @@ -504,6 +504,8 @@ 504 504 <div class="wikimodel-emptyline"></div></div></div> 505 505 {{/html}} 506 506 535 +{{id name="HALT_HOLD"/}} 536 + 507 507 ====== __Halt & Hold (**H**)__ ====== 508 508 509 509 {{html wiki="true" clean="false"}} ... ... @@ -514,24 +514,24 @@ 514 514 <div class="wikimodel-emptyline"></div></div></div> 515 515 {{/html}} 516 516 547 +{{id name="MOTION_SETUP"/}} 548 + 517 517 == Motion Setup == 518 518 551 +{{id name="MOTION_PROFILE"/}} 552 + 519 519 ====== __Enable Motion Profile (**EM**)__ ====== 520 520 521 -{{html clean="false" wiki="true"}}555 +{{html wiki="true" clean="false"}} 522 522 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 523 -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> 524 - 525 525 Ex: #5EM1<cr><div class="wikimodel-emptyline"></div> 526 526 527 -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> 528 528 529 529 Ex: #5EM0<cr><div class="wikimodel-emptyline"></div> 530 530 531 -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> 532 532 533 -<div class="wikimodel-emptyline"></div> 534 - 535 535 Query Motion Profile (**QEM**)<div class="wikimodel-emptyline"></div> 536 536 537 537 Ex: #5QEM<cr> might return *5QEM1<cr><div class="wikimodel-emptyline"></div> ... ... @@ -546,12 +546,12 @@ 546 546 <div class="wikimodel-emptyline"></div></div></div> 547 547 {{/html}} 548 548 579 +{{id name="FILTER_POSITION_COUNT"/}} 580 + 549 549 ====== __Filter Position Count (**FPC**)__ ====== 550 550 551 -{{html clean="false" wiki="true"}}583 +{{html wiki="true" clean="false"}} 552 552 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 553 -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. 554 -<div class="wikimodel-emptyline"></div> 555 555 Ex: #5FPC10<cr><div class="wikimodel-emptyline"></div> 556 556 This command allows the user to change the Filter Position Count value for that session. <div class="wikimodel-emptyline"></div> 557 557 ... ... @@ -569,6 +569,8 @@ 569 569 <div class="wikimodel-emptyline"></div></div></div> 570 570 {{/html}} 571 571 602 +{{id name="ORIGIN_OFFSET"/}} 603 + 572 572 ====== __Origin Offset (**O**)__ ====== 573 573 574 574 {{html wiki="true" clean="false"}} ... ... @@ -597,6 +597,8 @@ 597 597 <div class="wikimodel-emptyline"></div></div></div> 598 598 {{/html}} 599 599 632 +{{id name="ANGULAR_RANGE"/}} 633 + 600 600 ====== __Angular Range (**AR**)__ ====== 601 601 602 602 {{html wiki="true" clean="false"}} ... ... @@ -625,6 +625,8 @@ 625 625 <div class="wikimodel-emptyline"></div></div></div> 626 626 {{/html}} 627 627 662 +{{id name="ANGULAR_STIFFNESS"/}} 663 + 628 628 ====== __Angular Stiffness (**AS**)__ ====== 629 629 630 630 {{html wiki="true" clean="false"}} ... ... @@ -657,6 +657,8 @@ 657 657 <div class="wikimodel-emptyline"></div></div></div> 658 658 {{/html}} 659 659 696 +{{id name="ANGULAR_HOLDING_STIFFNESS"/}} 697 + 660 660 ====== __Angular Holding Stiffness (**AH**)__ ====== 661 661 662 662 {{html wiki="true" clean="false"}} ... ... @@ -681,6 +681,8 @@ 681 681 <div class="wikimodel-emptyline"></div></div></div> 682 682 {{/html}} 683 683 722 +{{id name="ANGULAR_ACCELERATION"/}} 723 + 684 684 ====== __Angular Acceleration (**AA**)__ ====== 685 685 686 686 {{html wiki="true" clean="false"}} ... ... @@ -705,6 +705,8 @@ 705 705 <div class="wikimodel-emptyline"></div></div></div> 706 706 {{/html}} 707 707 748 +{{id name="ANGULAR_DECELERATION"/}} 749 + 708 708 ====== __Angular Deceleration (**AD**)__ ====== 709 709 710 710 {{html wiki="true" clean="false"}} ... ... @@ -729,6 +729,8 @@ 729 729 <div class="wikimodel-emptyline"></div></div></div> 730 730 {{/html}} 731 731 774 +{{id name="GYRE_DIRECTION"/}} 775 + 732 732 ====== __Gyre Direction (**G**)__ ====== 733 733 734 734 {{html wiki="true" clean="false"}} ... ... @@ -753,6 +753,8 @@ 753 753 <div class="wikimodel-emptyline"></div></div></div> 754 754 {{/html}} 755 755 800 +{{id name="FIRST_POSITION"/}} 801 + 756 756 ====== __First Position__ ====== 757 757 758 758 {{html wiki="true" clean="false"}} ... ... @@ -773,6 +773,8 @@ 773 773 <div class="wikimodel-emptyline"></div></div></div> 774 774 {{/html}} 775 775 822 +{{id name="MAXIMUM_RAW"/}} 823 + 776 776 ====== __Maximum Motor Duty (**MMD**)__ ====== 777 777 778 778 {{html wiki="true" clean="false"}} ... ... @@ -787,10 +787,12 @@ 787 787 788 788 Ex: #5QMMDD<cr> might return *5QMMD512<cr> <div class="wikimodel-emptyline"></div> 789 789 790 -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> 791 791 <div class="wikimodel-emptyline"></div></div></div> 792 792 {{/html}} 793 793 842 +{{id name="MAXIMUM_SPEED_D"/}} 843 + 794 794 ====== __Maximum Speed in Degrees (**SD**)__ ====== 795 795 796 796 {{html wiki="true" clean="false"}} ... ... @@ -817,6 +817,8 @@ 817 817 </div></div> 818 818 {{/html}} 819 819 870 +{{id name="MAXIMUM_SPEED_RPM"/}} 871 + 820 820 ====== __Maximum Speed in RPM (**SR**)__ ====== 821 821 822 822 {{html wiki="true" clean="false"}} ... ... @@ -843,16 +843,20 @@ 843 843 </div></div> 844 844 {{/html}} 845 845 898 +{{id name="MODIFIERS"/}} 899 + 846 846 == Modifiers == 847 847 902 +{{id name="SPEEDS"/}} 903 + 848 848 ====== __Speed (**S**, **SD**) modifier__ ====== 849 849 850 -{{html clean="false" wiki="true"}}906 +{{html wiki="true" clean="false"}} 851 851 <div class="cmdcnt"><div class="cmdpad"></div><div class="cmdtxt"> 852 852 Example: #5P1500S750<cr><div class="wikimodel-emptyline"></div> 853 853 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> 854 854 Example: #5D0SD180<cr><div class="wikimodel-emptyline"></div> 855 -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> 856 856 Query Speed (**QS**)<div class="wikimodel-emptyline"></div> 857 857 Example: #5QS<cr> might return *5QS300<cr><div class="wikimodel-emptyline"></div> 858 858 This command queries the current speed in microseconds per second.<div class="wikimodel-emptyline"></div> ... ... @@ -859,6 +859,8 @@ 859 859 </div></div> 860 860 {{/html}} 861 861 918 +{{id name="TIMED_MOVE"/}} 919 + 862 862 ====== __Timed move (**T**) modifier__ ====== 863 863 864 864 {{html wiki="true" clean="false"}} ... ... @@ -870,6 +870,8 @@ 870 870 </div></div> 871 871 {{/html}} 872 872 931 +{{id name="CURRENT_HOLD"/}} 932 + 873 873 ====== __Current Halt & Hold (**CH**) modifier__ ====== 874 874 875 875 {{html wiki="true" clean="false"}} ... ... @@ -881,6 +881,8 @@ 881 881 </div></div> 882 882 {{/html}} 883 883 944 +{{id name="CURRENT_LIMP"/}} 945 + 884 884 ====== __Current Limp (**CL**) modifier__ ====== 885 885 886 886 {{html wiki="true" clean="false"}} ... ... @@ -892,8 +892,12 @@ 892 892 </div></div> 893 893 {{/html}} 894 894 957 +{{id name="TELEMETRY"/}} 958 + 895 895 == Telemetry == 896 896 961 +{{id name="QUERY_VOLTAGE"/}} 962 + 897 897 ====== __Query Voltage (**QV**)__ ====== 898 898 899 899 {{html wiki="true" clean="false"}} ... ... @@ -903,6 +903,8 @@ 903 903 </div></div> 904 904 {{/html}} 905 905 972 +{{id name="QUERY_TEMP"/}} 973 + 906 906 ====== __Query Temperature (**QT**)__ ====== 907 907 908 908 {{html wiki="true" clean="false"}} ... ... @@ -912,6 +912,8 @@ 912 912 </div></div> 913 913 {{/html}} 914 914 983 +{{id name="QUERY_CURRENT"/}} 984 + 915 915 ====== __Query Current (**QC**)__ ====== 916 916 917 917 {{html wiki="true" clean="false"}} ... ... @@ -921,6 +921,8 @@ 921 921 </div></div> 922 922 {{/html}} 923 923 994 +{{id name="QUERY_MODEL"/}} 995 + 924 924 ====== __Query Model String (**QMS**)__ ====== 925 925 926 926 {{html wiki="true" clean="false"}} ... ... @@ -930,6 +930,8 @@ 930 930 </div></div> 931 931 {{/html}} 932 932 1005 +{{id name="QUERY_FIRMWARE"/}} 1006 + 933 933 ====== __Query Firmware (**QF**)__ ====== 934 934 935 935 {{html wiki="true" clean="false"}} ... ... @@ -940,6 +940,8 @@ 940 940 </div></div> 941 941 {{/html}} 942 942 1017 +{{id name="QUERY_SERIAL"/}} 1018 + 943 943 ====== __Query Serial Number (**QN**)__ ====== 944 944 945 945 {{html wiki="true" clean="false"}} ... ... @@ -949,8 +949,12 @@ 949 949 </div></div> 950 950 {{/html}} 951 951 1028 +{{id name="RGB_LED"/}} 1029 + 952 952 == RGB LED == 953 953 1032 +{{id name="LED_COLOR"/}} 1033 + 954 954 ====== __LED Color (**LED**)__ ====== 955 955 956 956 {{html wiki="true" clean="false"}} ... ... @@ -967,6 +967,8 @@ 967 967 </div></div> 968 968 {{/html}} 969 969 1050 +{{id name="LED_BLINK"/}} 1051 + 970 970 ====== __Configure LED Blinking (**CLB**)__ ====== 971 971 972 972 {{html wiki="true" clean="false"}}