Changes for page LSS Configuration Software
Last modified by Eric Nantel on 2024/07/12 11:23
Change comment: Upload new image "lss-config-scan.jpg", version 1.1
Summary
-
Page properties (4 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 18 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -LSS Configuration Software 1 +LSS - Configuration Software - Parent
-
... ... @@ -1,1 +1,1 @@ 1 - ses-v2.lynxmotion-smart-servo.WebHome1 +lynxmotion-smart-servo.WebHome - Author
-
... ... @@ -1,1 +1,1 @@ 1 -xwiki:XWiki. ENantel1 +xwiki:XWiki.CBenson - Content
-
... ... @@ -1,6 +1,6 @@ 1 - {{lightbox image="lynxmotion-smart-servo.lss-configuration-software.WebHome@LSS Config - 20.7.3 - Screenshot.png" title="LSS Config - 20.7.3 - Screenshot" width="600"/}}1 +[[image:lynxmotion-smart-servo.lss-configuration-software.WebHome@LSS Config - 20.7.3 - Screenshot.png||alt="LSS Config - 20.7.3 - Screenshot" height="383" width="600"]] 2 2 3 -[[[[image:wiki-download.png]]>> attach:LSS_Config_Setup.zip]]3 +[[[[image:wiki-download.png]]>>https://www.robotshop.com/en/lynxmotion-smart-servo-lss-configuration-software.html||rel="noopener noreferrer" target="_blank"]] 4 4 5 5 **Table of Contents** 6 6 ... ... @@ -8,52 +8,37 @@ 8 8 9 9 = Description = 10 10 11 -The LSS Configuration software ("LSS Config" for short) is intended to provide easy access to the main features and functionality of the [[Lynxmotion Smart Servo Motors>>doc: ses-v2.lynxmotion-smart-servo.WebHome]], as well as providing access to firmware updates.11 +The LSS Configuration software ("LSS Config" for short) is intended to provide easy access to the main features and functionality of the [[Lynxmotion Smart Servo Motors>>doc:lynxmotion-smart-servo.WebHome]], as well as providing access to firmware updates. 12 12 13 -NOTE: The software can be connected to multiple servos, but the interface can only control one at any time. The servo(s) must be powered correctly and in serial mode. Should your servo(s) NOT be in serial mode, please refer to the [[button menu>>doc: ses-v2.lynxmotion-smart-servo.lss-button-menu.WebHome]].13 +NOTE: The software can be connected to multiple servos, but the interface can only control one at any time. The servo(s) must be powered correctly and in serial mode. Should your servo(s) NOT be in serial mode, please refer to the [[button menu>>doc:lynxmotion-smart-servo.lss-button-menu.WebHome]]. 14 14 15 -= User Guide =15 += Features = 16 16 17 17 == Connection == 18 18 19 - {{lightbox image="lynxmotion-smart-servo.lss-configuration-software.WebHome@lss-config-20.7.14.2-header-controls-not-connected.png" title="LSS Config-20.7.14.2 - Header controls (not connected)" width="552" group="header"/}}19 +[[image:lss-config-top-menu.jpg]] 20 20 21 -{{lightbox image="lynxmotion-smart-servo.lss-configuration-software.WebHome@lss-config-20.7.14.2-header-controls-connected.png" title="LSS Config - 20.7.14.2 - Header controls (connected, before scan)" width="552" group="header"/}} 22 - 23 -{{lightbox image="lynxmotion-smart-servo.lss-configuration-software.WebHome@lss-config-20.7.14.2-header-controls-lss-selected.png" title="LSS Config - 20.7.14.2 - Header controls (LSS selected, after scan)" width="552" group="header"/}} 24 - 25 - 26 -The headers above show the three main states (from top to bottom): 27 - 28 -* Before a connection is made 29 -* After a connection, before a scan 30 -* After a scan with a LSS selected 31 - 32 32 The header includes (left to right): 33 33 34 -* COM port selection 35 -* CONNECT / DISCONNECT (toggle ON / OFF) 36 -* SCAN: (popup) scans the bus for all available servo motors 23 +* WIKI (link to the LSS Config guide on the Lynxmotion Wiki) 37 37 * SERVO LIST: Servo selected via the dropdown menu 25 +* SCAN: (popup) scans the bus for all available servo motors 38 38 * FIRMWARE: (popup) used to update servo's firmware 39 -* WIKI (link to the LSS Config guide on the Lynxmotion Wiki) 27 +* COM port selection 28 +* CONNECT / DISCONNECT (toggle ON / OFF) 40 40 41 41 === COM Port === 42 42 43 -Connection to the servo is done automatically via any properly installed USB to serial interface like the [[LSS Adapter board>>doc:servo-erector-set-system.ses-electronics.ses-modules.lss-adapter-board.WebHome]]. Once the servo is powered and properly connected to the computer, the COM port should appear in the COM port list. Ensure the board is recognized by the computer and if not, install the proper drivers. If you have multiple communication ports active, go to Windows -> Device Manager to determine which is appropriate for the USB to serial adapter you are using. Click CONNECT to connect to the servo. If you wish to change the COM port selected you must disconnect, select the correct COM port and reconnect. 32 +Connection to the servo is done automatically via any properly installed USB to serial interface like the [[LSS Adapter board>>doc:servo-erector-set-system.ses-electronics.ses-modules.lss-adapter-board.WebHome]]. Once the servo is powered and properly connected to the computer, the COM port should appear in the COM port list. Ensure the board is recognized by the computer and if not, install the proper drivers. If you have multiple communication ports active, go to Windows -> Device Manager to determine which is appropriate for the USB to serial adapter you are using. Click CONNECT to connect to the servo. The software automatically scans all standard baud rates using ID254 (broadcast ID) and waits for a reply from the servo connected. Should an incorrect COM port be selected, the software will keep trying to connect. If you wish to change the COM port selected you must disconnect, select the correct COM port and reconnect. If you are not sure which COM port to select, in Windows, go to Device Manager -> Ports (COM & LPT) and select the port associated with the USB to serial device. 44 44 45 -If you are not sure which COM port to select, in Windows, go to Device Manager -> Ports (COM & LPT) and select the port associated with the USB to serial device. If it is still not clear which is the proper COM port, simply disconnect and reconnec the USB cable with Device Manager open. The proper COM port will disapear (when disconnecting the USB cable) and reappear (when connecting the USB cable). 46 - 47 47 === Scan === 48 48 49 - {{lightbox image="lynxmotion-smart-servo.lss-configuration-software.WebHome@lss-config-20.7.14.2-scan-options.png" title="LSS Config - 20.7.14.2 - Scan options" width="124"/}}36 +[[image:lss-config-scan.jpg||height="500" width="194"]] 50 50 51 -The next step once the COM port has been selected is to scan the port. The software can send commands to (and listen for a reply from) all servo IDs (0 to 250) at all standard baud rates on the selected COM port. In the pop-up, select the baud rates which you would like to scan .Youpressthe**ALL** buttontoselectall baudrates,pressthe individualcheckboxestoogglechselector pressthe**<<** buttontoselectonlythe correspondingbaudrate,deselecting allothers.Youmay alsolimittheIDstoscanfor.Whenin doubt,leaveallbaud ratesselected.38 +The next step once the COM port has been selected is to scan the port. The software can send commands to (and listen for a reply from) all servo IDs (0 to 250) at all standard baud rates on the selected COM port. In the pop-up, select the baud rates which you would like to scan, and the option of limited the IDs is also available. When in doubt, leave all baud rates selected. Once the scan starts, the command line interface will include messages for all servos found (or not found) at each baud rate, as well as any conflicts discovered. 52 52 53 - OnceyoupressOK,thescanwillstartby turningofftheLEDof all servosonthe selectedbaudrates(#254LED0\r).Then, each selectedbaudrate isscannedforservos.Thecommandline interfacewill include messagesforall servosfound (or notund)atchbaudrate,aswellasanyconflictsdiscovered(two or moreLSSatthe same location).In thiscase,alocationisdefined as abaudrate andIDpair.40 +This process may take a few seconds and once completed, a list of all available servos with which the software was able to communicate will appear in the list next to "Servo" (in the top orange Connection field of the interface) as a drop-down. All servos correctly identified on the BUS will have their LED turn green (session specific as opposed to configured) to indicate no conflict. If two or more servos have the same ID (regardless of whether or not they have different baud rates), those servo's LEDs will turn red for that session, indicating an issue or overlap in IDs. To resolve this, you will need to change the ID of those servos to be distinct. 54 54 55 -This process will take a few seconds and once completed, a list of all available servos with which the software was able to communicate will appear in the list next to "Servo" (in the top orange Connection field of the interface) as a drop-down. All servos correctly identified on the bus will have their LED turn green (session specific as opposed to configured) to indicate no conflict. If two or more servos have the same ID, those servo's LED will turn red for that session, indicating an issue or overlap in IDs. To resolve this, you will need to change the ID of those servos to be distinct (they will need to be connected individually/separately from the other conflicting servos). 56 - 57 57 **GREEN LED**: No Conflict 58 58 59 59 **RED LED**: Conflict Found ... ... @@ -62,40 +62,37 @@ 62 62 63 63 === Servo === 64 64 65 -The scan provides a list of all servos which have been detected on the bus and lists the following choices in the drop-down. Note that the last servo in the list is automatically selected for convenience. 50 +The scan provides a list of all servos which have been detected on the bus and lists the following choices in the drop-down. Note that the last servo in the list is automatically / arbitrarily selected for convenience. 66 66 67 - **LSS-None (???; ~-~--k)**52 +LSS-None (???; ~-~--k) 68 68 69 69 This first option is used only when a servo ("???" to signify "unknown servo") cannot be reached via the LSS Config software and needs to be manually set to bootloader mode via the button menu in order to re-flash the firmware. The telemetry graph and configurations are all greyed out when this is selected. Once the servo has been set manually to bootloader mode, select this option and go through the firmware update procedure. This normally only needs to be done as a "last resort". 70 70 71 - Note: You can use this specialfirmware recovery function with2or more servos simultaneously. Just make sure they are all in bootloader mode before stating the firmware update using this option.56 +LSS-All (254; ~-~--k) 72 72 73 - **LSS-All(254;~-~--k)**58 +This uses the "broadcast" ID (#254) which all servos are configured to respond to (along with their own ID). Since there is no particular servo being monitored, the telemetry graph and configurations are all greyed out. This is used to send the same firmware update to all servos on the bus, or to send the same action command to all servos on the bus via the Command line interface described below. 74 74 75 -Th isoptionallowsactionsthataffect alldetectedservos inthelist after auccessful scan.Sincethereis no particularservobeing monitored, the telemetry graph and configurations are allgreyedout. Thisisused tosendthesamefirmwareupdateto all detectedservosonthe busor tosendthe same actioncommand viathecommandlineinterface described below.60 +The drop-down list will be populated with all servos which the software has found on the bus, indicating their ID, servo model and firmware version. Each servo will then be listed in the following format: 76 76 77 -T hedrop-down list will be populated with all servos which the software has found on the bus, indicating their servo model, ID and firmware version.Eachservo will then be listed in the following format:62 +ST1 (0;115.2k [368]) 78 78 79 -**ST1 (0;115.2k [368])** 80 - 81 81 The servo model is displayed first (ST1, HS1, HT1), followed by its ID, the baud rate to which it has been st (ex. 115200, or 115.2k) and its firmware version in rectangular brackets. Selecting a servo from the list will allow the software to communicate with it. 82 82 83 83 == Firmware Update == 84 84 85 - {{lightbox image="lynxmotion-smart-servo.lss-configuration-software.WebHome@LSS Config - 20.7.3 - Firmware update.png" width="416"/}}68 +[[image:lynxmotion-smart-servo.lss-configuration-software.WebHome@LSS Config - 20.7.3 - Firmware update.png||height="295" width="400"]] 86 86 87 87 The firmware update option is a popup which includes: 88 88 89 -* Firmware version selectionin adropdownlist, including the current recommended version90 -* Experimental firmware ( optional)72 +* Firmware version in dropdown format, including the current recommended version 73 +* Experimental firmware (if available) 91 91 * Cancel firmware update 92 92 * OK to continue firmware update 93 -* Checkbox to try to save & restore the settings (config) 94 -* Notes regarding the selected firmware 76 +* Notes regarding the firmware 95 95 96 -The LSS Config serves as the main software used to update the servo's onboard firmware. An internet connection is needed in order for the software to check if an online update is available and obtain a cop y. When checked, the Exp. button will allow experimental versions of the firmware to be displayed in the list. It also allows to loada firmwaredirectly from a local file.78 +The LSS Config software serves as the main software used to update the servo's onboard firmware / programming. An internet connection is needed in order for the software to check if an online update is available. The servo's current firmware version is displayed to the left of the FIRMWARE button. Pressing the button will open a popup window which allows you to select the firmware version to upload to the servo. When checked, the Exp. button will allow experimental versions of the firmware to be displayed in the list. It also allows to load directly from a local file. 97 97 98 -Following this pop-up your servo will be restarted (unlessalready inbootloadermode, see LSS-Noneabove)and aprogress bar will be displayed in the command line. Do not disconnect the servo during a firmware update. If the process does get interrupted, you can still upload firmware to the LSS by going into bootloader mode by holding the button at power up.80 +Following this pop-up your servo will be restarted and a progress bar will be displayed in the command line. Do not disconnect the servo during a firmware update. If the process does get interrupted, you can still upload firmware to the LSS by going into bootloader mode by holding the button at power up. 99 99 100 100 __**NOTE: Before assembling the servos as part of a robot, check to see if there is a firmware update available.**__ 101 101 ... ... @@ -105,29 +105,23 @@ 105 105 106 106 The servo control section allows you to visually move the servo and change a variety of parameters, including: 107 107 108 -* [[image:lss-config-20.7.14.2-carets-position-64 .png]]Position: pale blue caret109 -* [[image:lss-config-20.7.14.2-carets-offset-64.png]]Origin offset: magenta caret110 -* [[image:lss-config-20.7.14.2-carets-angular-range-64.png]]Angular range: magenta square carets111 -* [[image:lss-config-20.7.14.2-carets-speed-64.png]]RPM: green arrow / indicator112 -* [[image:lss-config-20.7.14.2-carets-first-position-64.png]]Initial position: dark blue caret90 +* Position: pale blue caret 91 +* Origin offset: magenta caret 92 +* Angular range: magenta square carets 93 +* RPM: green arrow / indicator 94 +* Initial position: dark blue caret 113 113 114 -At the lower left the servo model and the LED color (session value) are shown.96 +At the lower left the servo model and the LED color are shown. 115 115 116 -To change a value, simple use the left mouse button to hold and drag the relevant caret around its ring. Letting go of the left mouse button will update the value right away. While holding the left mouse button you can also press the right mouse button to cancel the current change to that caret (happens after right mouse click and then letting go of the left mouse button). 117 - 118 -If the caret moved is position, this will send a position command in tenths of degrees right away to the servo (#[id]D[pos]\r). 119 -If the caret moved is first position, offset or angular range then it will update the appropiate configuration (see below for details), pending an update confirmation. 120 -The speed caret cannot be moved directly; it only serves only as a display of the current speed. 121 - 122 122 == Configurations == 123 123 124 124 {{lightbox image="lss-config-configurations.jpg" width="350"/}} 125 125 126 -Upon connection, the software will read all configuration values and update the values in the "configurations" section. Visit the [[doc: ses-v2.lynxmotion-smart-servo.lss-communication-protocol.WebHome]] page for more information about commands, actions and configurations.102 +Upon connection, the software will read all configuration values and update the values in the "configurations" section. Visit the [[doc:lynxmotion-smart-servo.lss-communication-protocol.WebHome]] page for more information about commands, actions and configurations. 127 127 128 128 Changing the values will not affect the session. Values which have been changed will have a yellow background. The values which can be entered are restricted to what the servo can accept; for example, servo IDs must be below 250. 129 129 130 -Each command is associated with the following protocol. Additional details for each can be found on the [[LSS Communication Protocol>>doc: ses-v2.lynxmotion-smart-servo.lss-communication-protocol.WebHome]] page.106 +Each command is associated with the following protocol. Additional details for each can be found on the [[LSS Communication Protocol>>doc:lynxmotion-smart-servo.lss-communication-protocol.WebHome]] page. 131 131 132 132 (% style="margin-right:auto" %) 133 133 |Field|Command|Update? ... ... @@ -188,11 +188,11 @@ 188 188 (% class="wikigeneratedid" %) 189 189 Occasionally the telemetry values may all simultaneously drop to zero for one reading, or skip a point due to other processes taking priority. 190 190 191 -== Command line ==167 +== Command Line == 192 192 193 193 {{lightbox image="lss-config-terminal-0001" width="521"/}} 194 194 195 -The command line interface both allows you to communicate directly with an individual servo, send commands to it and view replies to queries. When "LSS-All (254; ~-~--k)" is selected in the list of servos, the commandline is used to send the same action or configuration command to alldetectedservos. For example, typing D1800 and pressing enter will send that same position command to each of thedetectedservos.171 +The custom command line interface both allows you to communicate directly with an individual servo, send commands to it (and view replies), as well as get responses to queries from the software. When "LSS-All (254; ~-~--k)" is selected in the list of servos, the Command Line is used to send the same action or configuration command to all servos on the bus. For example, typing D1800 and pressing enter will send that same position command to each of the servos on the bus. 196 196 197 197 Within the command interface, you might see the following: 198 198 ... ... @@ -199,17 +199,16 @@ 199 199 |(% style="width:114px" %)**>>**|(% style="width:1364px" %)Command sent to the servo 200 200 |(% style="width:114px" %)**<<**|(% style="width:1364px" %)Reply from the servo 201 201 |(% style="width:114px" %)**INF ::**|(% style="width:1364px" %)Information 202 -|(% style="width:114px" %)**[bootloader]**|(% style="width:1364px" %)Information specific to bootloader mode & firmware updates178 +|(% style="width:114px" %)**[bootloader]**|(% style="width:1364px" %)Information specific to bootloader 203 203 |(% style="width:114px" %)**]]**|(% style="width:1364px" %)Failure 204 -|(% style="width:114px" %)[[image:lss-config-20.7.14.2-terminal-doublestar-bold.png]]|(% style="width:1364px" %)Configuration command redirected to config interface (left hand side) 205 205 206 -The command line also auto-completes each command by automatically inserting "#[ id]"before each commandfor you.Therefore, you only need to type the command itself, such as "D1000" and press [enter].For example, rather than typing #4D230<cr>, you need only type D230 and the software will automatically add #4& \r.181 +The command line also auto-completes each command by automatically inserting "#[ID] before each command. For example, rather than typing #4D230<cr>, you need only type D230 and the software will automatically add #4 207 207 208 -Left clicking a line within the command prompt andthen right clicking using your mouse highlights that line in a green border and allows it to be copied to the clipboard and pasted into another document. Scrolling is opposite that to browser navigation.183 +Left clicking a line within the command prompt, then right clicking using your mouse highlights that line in a green border and allows it to be copied to the clipboard and pasted into another document. Scrolling is opposite that to browser navigation. 209 209 210 -The mouse wheel can be used to scroll and the holding the middle mouse button down allows for panning over the command linearea (useful if text extends to the right).There are also two scrolling bars that can be used with the left mouse button as normal for panning the command line view.185 +The mouse wheel can be used to scroll and the holding the middle mouse button down allows for panning over the terminal area (useful if text extends to the right). 211 211 212 212 = Tutorials = 213 213 214 -* [[doc: ses-v2.lynxmotion-smart-servo.lss-configuration-software.lss-config-configure-ids.WebHome]]215 -* [[doc: ses-v2.lynxmotion-smart-servo.lss-configuration-software.lss-config-firmware-update.WebHome]]189 +* [[doc:lynxmotion-smart-servo.lss-configuration-software.lss-config-configure-ids.WebHome]] 190 +* [[doc:lynxmotion-smart-servo.lss-configuration-software.lss-config-firmware-update.WebHome]]
- LSS_Config_Setup.zip
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.ENantel - Size
-
... ... @@ -1,1 +1,0 @@ 1 -3.6 MB - Content
- lss-config-20.7.14.2-carets-angular-range-64.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -426 bytes - Content
- lss-config-20.7.14.2-carets-angular-range.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -400 bytes - Content
- lss-config-20.7.14.2-carets-first-position-64.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -348 bytes - Content
- lss-config-20.7.14.2-carets-first-position.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -322 bytes - Content
- lss-config-20.7.14.2-carets-offset-64.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -404 bytes - Content
- lss-config-20.7.14.2-carets-offset.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -362 bytes - Content
- lss-config-20.7.14.2-carets-position-64 .png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -420 bytes - Content
- lss-config-20.7.14.2-carets-position.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -390 bytes - Content
- lss-config-20.7.14.2-carets-speed-64.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -371 bytes - Content
- lss-config-20.7.14.2-carets-speed.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -334 bytes - Content
- lss-config-20.7.14.2-header-controls-connected.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -5.0 KB - Content
- lss-config-20.7.14.2-header-controls-lss-selected.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -5.2 KB - Content
- lss-config-20.7.14.2-header-controls-not-connected.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -4.7 KB - Content
- lss-config-20.7.14.2-popup-firmware-update-lss-none.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -10.1 KB - Content
- lss-config-20.7.14.2-scan-options.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -12.2 KB - Content
- lss-config-20.7.14.2-terminal-doublestar-bold.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.RB1 - Size
-
... ... @@ -1,1 +1,0 @@ 1 -289 bytes - Content
- lss-config-top-menu.jpg
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.CBenson - Size
-
... ... @@ -1,1 +1,0 @@ 1 -22.0 KB - Content