Wiki source code of LSS-PRO Configuration Software

Version 66.1 by Eric Nantel on 2024/07/11 15:07

Hide last authors
Eric Nantel 21.1 1 [[image:LSS-P-Configuration-Software.png||width="350"]]
Eric Nantel 12.1 2
Eric Nantel 21.1 3 [[image:[email protected]]]
Eric Nantel 1.2 4
5 **Table of Contents**
6
7 {{toc/}}
8
9 = Description =
Eric Nantel 21.1 10
Eric Nantel 48.1 11 The Lynxmotion Smart Servo PRO Configuration Software (“LSS PRO Config” for short) is intended to be a tool to quickly interact with the Lynxmotion Professional Smart Servos (LSS-P) loaded with our Lynxmotion firmware. Features include sending action and configuration commands, queries (and receiving the reply), updating the firmware, monitoring sensor data and more. The software works on Windows 7 operating systems and above.
Eric Nantel 21.1 12
Eric Nantel 48.1 13
Eric Nantel 44.2 14 Note: The software can be connected to multiple servos, but the interface can only control and communicate with one at any time (unless using the free format commands described below). Each servo must have a unique ID. The servo(s) must be powered correctly and connected to the computer via USB from the first servo in the BUS.
Eric Nantel 23.1 15
Eric Nantel 44.2 16 = Features =
17
18 * Send action, configuration and query commands to an individual PRO servo
19 * Obtain visual feedback from various onboard sensors
20 * Create custom actions for testing purpose
21 * Update PRO servo’s firmware
22 * Auto-Update if connected to Internet
23
Eric Nantel 24.1 24 = User Guide =
25
Eric Nantel 26.1 26 [lorren Ipsum]
Eric Nantel 24.1 27
Eric Nantel 44.2 28 == Information ==
29
30 [[image:LSS-P-Config-Info.png]]
31
32 1. The Information (capital I) button at the top right of the interface leads to this user guide.
33
Eric Nantel 26.1 34 == Connection ==
35
Eric Nantel 44.2 36 In order for the LSS PRO Config software to detect the servos, the correct USB to serial drivers must be installed on the computer. Windows will automatically detect and install the drivers.
37
38
Eric Nantel 32.1 39 [[image:LSS-P-Config-Connection.png]]
Eric Nantel 26.1 40
Eric Nantel 44.2 41 1. Select the appropriate COM port
42 1. Click on the "Connect" button (All servos in the communication BUS should be detected)
43 1. Select a particular servo from the list
Eric Nantel 30.1 44
Eric Nantel 44.2 45 Note: The interface will then display and control that single actuator.
Eric Nantel 30.1 46
Eric Nantel 26.1 47 == Status ==
48
Eric Nantel 34.1 49 [[image:LSS-P-Config-Status.png]]
Eric Nantel 26.1 50
Eric Nantel 34.1 51 This is a section to directly give information to the user on what's happening with their actuator.
52
53 1. Position of the actuator including any adjustment to the Origin Offset.
54 1. Status of what the actuator is currently doing. (A list of the different statuses is available HERE)
55 1. Errors that are happening. (A list of the different errors is available HERE)
56
Eric Nantel 44.2 57 Note: Most errors will require the problem to be solved & the servo either Reset or set Limp.
58
Eric Nantel 49.2 59 == Servo Control ==
Eric Nantel 48.1 60
Eric Nantel 65.2 61 In order to view the various commands available for each drop-down, a PRO servo needs to be properly connected to the computer, powered, turned on and detected.
Eric Nantel 48.1 62
Eric Nantel 65.2 63 [[image:LSS-P-Config-ServoControl.png]]Query
Eric Nantel 48.1 64
Eric Nantel 26.1 65
Eric Nantel 38.1 66 [[image:LSS-P-Config-Query.png]]
Eric Nantel 26.1 67
Eric Nantel 65.2 68 1. The drop down list below Query provides a list of most query commands possible. More information click HERE
Eric Nantel 38.1 69 1. Click the "Send" button to initiate the Query.
70 1. The Query protocol command will be displayed here as well as the answer from the actuator. (ex: #1QID / *1QID1)
71
Eric Nantel 49.2 72 === Action ===
Eric Nantel 26.1 73
Eric Nantel 48.1 74 The drop down list below Action provides a list of most action commands used with the LSS PRO servos.
75
Eric Nantel 38.1 76 [[image:LSS-P-Config-Action.png]]
Eric Nantel 26.1 77
Eric Nantel 65.2 78 1. The drop down list below Action provides a list of most action commands possible. More information click HERE.
Eric Nantel 38.1 79 1. Input the value of the Action required in the text input field. (ex: 9000 for a 90deg move)
80 1. Click the "Send" button to initiate the Action.
81 1. The Action protocol command will be displayed here and the actuator should be doing it.
82
Eric Nantel 49.2 83 === Configuration ===
Eric Nantel 26.1 84
Eric Nantel 48.1 85 The drop down list below Configuration provides a list of most configuration commands used with the LSS PRO servos.
86
Eric Nantel 38.1 87 [[image:LSS-P-Config-Config.png]]
Eric Nantel 26.1 88
Eric Nantel 65.2 89 1. The drop down list below Configuration provides a list of most configuration commands possible. More information click HERE.
Eric Nantel 49.1 90 1. Input the value of the Configuration required in the text input field. (ex: 1 for an ID change to 1)
Eric Nantel 38.1 91 1. Click the "Send" button to initiate the Configuration.
92 1. The Configuration protocol command will be displayed here.
93
Eric Nantel 48.1 94 === Free format command ===
95
Eric Nantel 65.2 96 This command line interface allows the user to send commands, including those not otherwise found in the drop-down list, as well as any special commands provided by Lynxmotion staff. Once sent the commands will be displayed in the area bellow (like a terminal) and can be cleared if required. This can help with debugging or better understanding the communication protocol.
Eric Nantel 48.1 97
98 [[image:LSS-P-Config-Free-Cmd.png]]
99
Eric Nantel 26.1 100 == Telemetry ==
101
Eric Nantel 53.1 102 A graph within the software is used to display output of any query commands, which can include sensor data or calculated data.
Eric Nantel 26.1 103
Eric Nantel 53.1 104 [[image:LSS-P-Config-Telemetry.png]]
Eric Nantel 52.1 105
Eric Nantel 53.1 106 1. To activate a specific value, click on the button and click again to disable it. he software start memorizing the data as soon as one query is activated.
107 1. Pause will stop recording until you click back on it.
108 1. Restart will wipe all the recorded values.
109 1. The Y-axis of the graph auto-scales depending on what output is selected. To switch between traces, use the mouse wheel and confirm that the y axis label is the one you selected.
110 1. The X-axis display the time & expands up to 20 minutes then scrolls a 20 minute time window.
Eric Nantel 54.2 111 1. Saving the data is possible by doing a right click on the graph and select Copy, it's then possible to paste them in a spreadsheet application (Excel / Google Sheets)
Eric Nantel 52.1 112
Eric Nantel 53.1 113 === Personalize Query ===
Eric Nantel 52.1 114
Eric Nantel 40.1 115 To change the query for a specific button, you have to do a "CTRL + CLICK" on the desired button, this interface will then be displayed.
116
117 [[image:LSS-P-Config-Telemetry-Custom.png]]
118
119 1. Trace Name: Displayed name for that particular query.
120 1. Two separate "Add" button and drop down are present, they are shortcuts to add to the query bellow.
Eric Nantel 64.1 121 1. Query that will be sent to the actuator plus displayed units for the interface.
Eric Nantel 40.1 122
Eric Nantel 43.1 123 === Saving Data ===
124
Eric Nantel 52.1 125
Eric Nantel 26.1 126 == Custom Actions ==
127
Eric Nantel 64.1 128 This list of assignable buttons allows the user to select specific commands to send to the servo. These can be used to quickly position the servo to specific angles, experiment with different speeds and more.
Eric Nantel 26.1 129
Eric Nantel 64.1 130 [[image:LSS-P-Config-Custom-Actions.png]]
131
132 1. All of those buttons can be set to trigger any action required.
133 1. Save will let you do a backup of the current Custom Actions.
134 1. Load will let you select and load a previously saved Custom Action file.
135
Eric Nantel 65.1 136 === Personalize Action ===
137
Eric Nantel 64.1 138 To change the Action for a specific button, you have to do a "CTRL + CLICK" on the desired button, this interface will then be displayed.
139
140 [[image:LSS-P-Config-Custom-Actions-Custom.png]]
141
142 1. Action Name: Displayed name for that particular action.
143 1. Two separate "Add" button and drop down are present, they are shortcuts to add to the action bellow.
144 1. Action command that will be sent to the actuator plus displayed units for the interface.
145
Eric Nantel 28.1 146 == Firmware Update ==
147
148 [lorren Ipsum]
Eric Nantel 61.1 149
150
151 [[image:LSS-P-Config-Firmware-Available.png]]
152
153 [[image:LSS-P-Config-Firmware-Download.png]]
154
155 [[image:LSS-P-Config-Firmware-Local.png]]
156
157 [[image:LSS-P-Config-Firmware-Success.png]]
158
159
Copyright RobotShop 2018