Wiki source code of LSS-PRO Configuration Software

Version 65.2 by Eric Nantel on 2024/07/11 14:56

Show last authors
1 [[image:LSS-P-Configuration-Software.png||width="350"]]
2
3 [[image:[email protected]]]
4
5 **Table of Contents**
6
7 {{toc/}}
8
9 = Description =
10
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.
12
13
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.
15
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
24 = User Guide =
25
26 [lorren Ipsum]
27
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
34 == Connection ==
35
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
39 [[image:LSS-P-Config-Connection.png]]
40
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
44
45 Note: The interface will then display and control that single actuator.
46
47 == Status ==
48
49 [[image:LSS-P-Config-Status.png]]
50
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
57 Note: Most errors will require the problem to be solved & the servo either Reset or set Limp.
58
59 == Servo Control ==
60
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.
62
63 [[image:LSS-P-Config-ServoControl.png]]Query
64
65
66 [[image:LSS-P-Config-Query.png]]
67
68 1. The drop down list below Query provides a list of most query commands possible. More information click HERE
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
72 === Action ===
73
74 The drop down list below Action provides a list of most action commands used with the LSS PRO servos.
75
76 [[image:LSS-P-Config-Action.png]]
77
78 1. The drop down list below Action provides a list of most action commands possible. More information click HERE.
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
83 === Configuration ===
84
85 The drop down list below Configuration provides a list of most configuration commands used with the LSS PRO servos.
86
87 [[image:LSS-P-Config-Config.png]]
88
89 1. The drop down list below Configuration provides a list of most configuration commands possible. More information click HERE.
90 1. Input the value of the Configuration required in the text input field. (ex: 1 for an ID change to 1)
91 1. Click the "Send" button to initiate the Configuration.
92 1. The Configuration protocol command will be displayed here.
93
94 === Free format command ===
95
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.
97
98 [[image:LSS-P-Config-Free-Cmd.png]]
99
100 == Telemetry ==
101
102 A graph within the software is used to display output of any query commands, which can include sensor data or calculated data.
103
104 [[image:LSS-P-Config-Telemetry.png]]
105
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.
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)
112
113 === Personalize Query ===
114
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.
121 1. Query that will be sent to the actuator plus displayed units for the interface.
122
123 === Saving Data ===
124
125
126 == Custom Actions ==
127
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.
129
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
136 === Personalize Action ===
137
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
146 == Firmware Update ==
147
148 [lorren Ipsum]
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