Changes for page FlowArm LSS

Last modified by Eric Nantel on 2024/07/03 09:39

From version < 33.1 >
edited by Coleman Benson
on 2019/09/09 12:22
To version < 53.2 >
edited by Coleman Benson
on 2019/09/16 13:34
< >
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,6 +1,6 @@
1 1  [[image:LSS-FlowArm.png||width="350"]]
2 2  
3 -[[[[image:wiki-download.png]]>>https://www.robotshop.com/en/lynxmotion-smart-servo-lss-configuration-software.html||rel="noopener noreferrer" target="_blank"]]
3 +[[image:wiki-download.png]]
4 4  
5 5  **Page Contents**
6 6  
... ... @@ -8,9 +8,9 @@
8 8  
9 9  = Description =
10 10  
11 -{Coming soon}
11 +The LSS FlowArm application is intended to allow easy control of the standard Lynxmotion Servo Erector Set (S.E.S.) v2 articulated robotic arm. The graphical interface shows multiple views of the arm which can be controlled via drag and drop, as well as by manually inputting coordinates. The full-featured built-in sequencer allows you create sequences which have the arm move automatically from one position ("frame") to the next. Make use of the "teach mode" to position the arm where you want and record frames which can be modified and played back. Associating each pattern with input keys means you can easily play back and test multiple sequences.
12 12  
13 -The LSS FlowArm application was created using FlowBotics Studio software and is intended to allow easy control of the standard configuration Lynxmotion Servo Erector Set (S.E.S.) v2 articulated robotic arm. The graphical interface shows a side and top view of the arm, as well as the gripper and wrist. The full-featured built-in sequencer allows you create sequences which have the arm move automatically from one position ("frame") to the next.
13 +FlowBotics Studio was used to create this app and includes hundreds of built-in components that allow you to interface your PC to many standard computer peripherals and robotics components, and you can quickly design new components for new hardware. Easily create new projects with custom GUI screens, knobs, buttons, switches, etc. that will run live from within FlowBotics Studio without needing to wait for compilation, or export as stand-alone executable files. FlowBotics Studio includes a powerful graphics engine that allows you to make custom graphical objects by using standard bitmaps or by drawing your own shapes on the screen. Using this system, you can build entirely custom interfaces like this onfor your projects and integrate photographs, drawings, and graphs.
14 14  
15 15  = Features =
16 16  
... ... @@ -19,13 +19,13 @@
19 19  * Teach mode allows the user to move the arm and have the virtual arm follow
20 20  * Position the arm using rectangular or cylindrical coordinates, virtual joysticks or mouse drag
21 21  * Application can be modified via FlowBotics Studio
22 +* Optional data log shows what commands are sent and received and can be saved as a .csv file.
23 +* LSS FlowArm is intended only for Windows operating systems 7 or higher.
22 22  
23 23  = Initial Setup =
24 24  
25 25  In order to understand the features, functionality and nuances of the Lynxmotion smart servos, it is suggested to read through the [[doc:lynxmotion-smart-servo.WebHome]] section of the wiki.
26 26  
27 -= Servo IDs =
28 -
29 29  Before assembling the arm, each of the IDs assigned to the servos must correspond with what is needed in the software.
30 30  
31 31  * Base: 1
... ... @@ -34,8 +34,14 @@
34 34  * Wrist: 4
35 35  * Gripper: 5
36 36  
37 -To do so, the [[LSS Configuration Software>>doc:lynxmotion-smart-servo.lss-configuration-software.WebHome]] is used. Follow the procedure outlined here
37 +To do so, the [[LSS Configuration Software>>doc:lynxmotion-smart-servo.lss-configuration-software.WebHome]] is used. Follow the procedure outlined here: [[doc:lynxmotion-smart-servo.lss-configuration-software.lss-config-configure-ids.WebHome]]
38 38  
39 +* Servo ID is correctly assigned to each servo and there are no duplicate IDs
40 +* Servos have been assembled in correct orientation (as per assembly manual)
41 +* Servo offsets have been updated if necessary (see procedure below).
42 +
43 +The next important step is "STORE OFFSETS" explained below.
44 +
39 39  = Interface =
40 40  
41 41  == Header ==
... ... @@ -44,119 +44,129 @@
44 44  
45 45  **STORE OFFSETS**
46 46  
47 -Press the "Store offsets" button to change the all of the servo offsets (this makes use of the CO command as part of the [[LSS Communication Protocol>>doc:lynxmotion-smart-servo.lss-communication-protocol.WebHome]]).
53 +The "STORE OFFSETS" button configureall of the servo offsets (this makes use of the CO command as part of the [[LSS Communication Protocol>>doc:lynxmotion-smart-servo.lss-communication-protocol.WebHome]]). Before pressing the button, orient the arm as shown below (with the gripper closed), and only then click the STORE OFFSETS button.
48 48  
55 +* Base servo aligned with the x axis
56 +* Shoulder to elbow along z axis (straight up)
57 +* Elbow to wrist along R axis (horizontal at 90 degrees to shoulder to elbow)
58 +* Wrist servo along R axis (parallel to elbow to wrist)
59 +* Gripper servo closed
60 +
61 +[[image:lss-flowarm-offsets.jpg]]
62 +
49 49  **LIMP**
50 50  
51 -Causes all servos to go LIMP (i.e. lose torque). The arm will collapse.
65 +Causes all servos to immediately go LIMP (i.e. lose torque). The arm will collapse. It's important to note that the software will not constantly query all servos for their position, and as such the virtual arm on screen will not update frequently if at all. If you want the virtual arm on screen to update as you move the real arm, use TEACH mode described below.
52 52  
53 53  **STOP**
54 54  
55 -Causes all servos to stop their motion and hold their position.
69 +Causes all servos to immediately stop their motion and hold their position.
56 56  
57 57  **TEACH**
58 58  
59 -Teach mode allows a user to physically move the arm to a designed location
73 +Teach mode allows a user to physically move the arm and have the virtual arm on screen follow. This is used primarily to manually add frames to sequences, determine the optimal closed position for the gripper etc. In order to ensure the arm does not collapse, pressing the TEACH button will start a 5 second countdown during which the arm will slowly lose torque (angular force) until all servos are limp. When in teach mode, an orange outline appears over all on-screen fields which would cause a conflict and therefore cannot be used.
60 60  
61 -In order to ensure the arm does not collapse, pressing the TEACH button will start a 5 second countdown during which the arm will slowly lose torque (angular force) until all servos are limp.
75 +CAREFUL: Do not move the servos or the arm too quickly. We suggest holding the gripper servo to move the arm, or temporarily removing the arm's aesthetic shell.
62 62  
63 -When in teach mode, an orange outline appears over all on-screen fields which would cause a conflict and therefore cannot be used.
77 +Once the arm is limp, it can be moved physically, and the application will regularly send position query commands to all of the servos and update the virtual arm on screen to match the servo's responses. Use the sequencer to record each position (frame) while in teach mode. For more information on the sequencer, refer to the sequencer section below.
64 64  
65 -CAREFUL: Do not move the servos too quickly. We suggest moving the gripper servo, or temporarily removing the aesthetic shell.
66 -
67 -Once the arm is limp, it can be moved physically, and the application will regularly read the physical position of each of the servos and move the virtual arm on screen to match.
68 -
69 -Use the sequencer to save each position (frame). Intermediate frames can be added as needed. For more information on the sequencer, refer to the sequencer section below.
70 -
71 -
72 72  **GRID / Units**
73 73  
74 -Units can be toggled between Metric or Imperial
81 +Grid spacing can be toggled between Metric or Imperial. Options include 2cm, 3cm, 5cm and 1in, 2in and 3in.
75 75  
76 76  **BAUD**
77 77  
78 -The baud rate suggested is 115200, which is the default baud rate of the servos. Should a user have changed the baud rate on the servos, it can be selcted using the drop down. Note that the baud rate must be configured to the same value for all servos in order to work.
85 +The default (and suggested) baud rate is 115200, which is the baud rate at which the servos are shipped. Should a user have changed the baud rate on the servos, it can be selected using the drop down. Note that the baud rate must be configured to the same value for all servos in order to work.
79 79  
80 80  **COM**
81 81  
82 -This field selects which of your computer's COM ports is connected to the LSS Adapter, which is provided with the standard SES v2 articulated robot arm. Be sure to select the appropriate COM port to which the LSS adapter is connected. If you are unsure, go to Device Manager in Windows, and view the list of USB devices connected. The LSS Adapter uses an FTDI USB to serial chip.
89 +When the software is opened, a scan of all of your computer's COM ports is done automatically and a list of all available COM ports will be found in the drop down menu, along with OFF (stop searching for a COM port), and AUTO (the application tries to automatically find the correct COM port by sending a query command at the corresponding BAUD rate). Select which of your computer's COM ports is connected to the [[LSS Adapter>>doc:servo-erector-set-system.ses-electronics.ses-modules.lss-adapter-board.WebHome]] (which is provided with the standard SES v2 articulated robot arm). If you have a list of available COM ports and are unsure which is associated with the LSS Adapter, go to Device Manager in Windows, and view the list of USB devices connected. The LSS Adapter uses an FTDI USB to serial chip. Alternatively, simply unplug the USB from the arm and see which of the COM ports disappears from the list.
83 83  
84 -When the software is opened, a scan of all COM ports is done automatically and list of all available COM ports will be found in the drop down menu, along with OFF (stop searching for a COM port), and AUTO (the application tries to automatically find the correct COM port by sending a query command at the corresponding BAUD rate).
91 +* If the red and green lights next to the field are flashing, the correct COM port has not yet been found, and the user may need to manually select the correct COM port.
92 +* If the red light is solid, then no correct COM port has been located.
93 +* If the green light is solid, the a COM port has been located.
85 85  
86 -If the red and green lights next to the field are flashing, the correct COM port has not yet been found, and the user may need to manually select the correct CIM port.
87 -
88 -If the red light is solid, then no correct COM port has been located.
89 -
90 -If the green light is solid, the a COM port has been located.
91 -
92 92  **Window Size**
93 93  
94 94  **[[image:lss-flowarm-size.jpg]]**
95 95  
96 -A the top right of the window, there are three dark rectangles representing the window size.
99 +A the top right of the window, there are three dark rectangles allowing you to change the application's window size.
97 97  
98 -== 2D Views & Grid ==
101 +== Virtual Arm ==
99 99  
100 -== Arm Configuration ==
103 +(% class="wikigeneratedid" id="HArmConfiguration" %)
104 +The arm shown on screen is based on the assembly guide. The aesthetics of the arms will be changing for the next release version of the LSS Flowarm software.
101 101  
102 -The arm shown on screen is based on the assembly guide. BETA testers have been encouraged to use the 3:1 gear ratio in the shoulder and as such should have toggled switch 1 in the header.
103 -
104 -The aesthetics of the arms will be changing for the final / release version of the LSS Flowarm software.
105 -
106 106  **Side View**
107 107  
108 +The left view is a representation of the arm, where the orange circles represent the location of each axis of rotation. You can move the arm in this view by clicking on and dragging the wrist rotation servo.
109 +
108 108  [[image:lss-flowarm-side-view.jpg]]
109 109  
110 -The left view is a representation {more to come|
111 -
112 112  **Top View**
113 113  
114 +The top view shows the arm top down. You can move the arm within this view by clicking on and dragging the wrist rotation servo.
115 +
114 114  **[[image:lss-flowarm-top-view.jpg]]**
115 115  
116 -The top view shows the arm {more to come}
117 -
118 118  == Left Menu ==
119 119  
120 120  **Gripper**
121 121  
122 -[[image:lss-flowarm-gripper-view.jpg]]
122 +Assuming the gripper has been properly calibrated, The number below represents the opening at the tip. Fully closed should correspond to 0 degrees. In order to grasp an object, DO NOT have the servo rotate to a position which it cannot reach. In order to ensure the gripper servo does not go into error mode, the gripper should not exert much force on the object.
123 123  
124 -The gripper and wrist rotate can be controlled from this menu
124 +1. Close the gripper to a position just slightly larger than the object
125 +1. Using the arrows, close the gripper until friction between the foam and the object prevent the object from falling out or moving.
126 +1. DO NOT apply too much pressure, or else the servo's current will spike and it will go into error mode and need to be reset.
127 +1. Use the last position as the "fully closed" position for the gripper for that object, in that specific orientation.
125 125  
129 +[[image:lss-flowarm-gripper-view.jpg]]
130 +
126 126  **Wrist**
127 127  
133 +The wrist angle can be locked or unlocked. The field allows for user input (click the numbers) or fine adjustments using the arrows.
134 +
128 128  [[image:lss-flowarm-wrist-view.jpg]]
129 129  
130 130  **End Effector Position**
131 131  
139 +The position of the end effector can be controlled either by manually entering the information for R (radius), or the Cartesian x, y, z coordinates, or using the arrows.
140 +
132 132  [[image:lss-flowarm-positioning.jpg]]
133 133  
134 -The position of the end effector can be controlled either by manually entering the information for R (radius), or x,y,z coordinate, or using the arrows.
143 +== **Data Log** ==
135 135  
136 -Data Log
145 +The optional Data log can be toggled on or off and allows the user to see all commands being sent to and received from the smart servos. The data can be saved to a file in a Comma Separated Values (.csv) format.
137 137  
138 138  [[image:lss-flowarm-data-log.jpg]]
139 139  
140 -The console will be used as a serial command interface to manually send commands to the bus.
141 -
142 142  == Sequencer ==
143 143  
144 144  [[image:lss-flowarm-sequencer.jpg]]
145 145  
146 -The sequencer allows the user to record sequences. From left to right:
153 +LSS FlowArm has a powerful pattern sequencer component (normally found only in the full version of FlowBotics Studio) that is used to create reusable patterns within minutes, instead of hours or days. From left to right:
147 147  
148 -Sequence association
155 +(% style="width:1303px" %)
156 +|(% style="width:257px" %)[[image:lss-flowarm-association.jpg]]|(% style="width:306px" %)Keyboard Association|(% style="width:758px" %)Patterns can be associated to keyboard keys F1 to F12, and keys E, F, G, and H
157 +|(% style="width:257px" %)[[image:lss-flowarm-pattern-list.jpg]]|(% style="width:306px" %)Active Pattern Name|(% style="width:758px" %)Click on the text to change the pattern name. Use the arrows to navigate between patterns
158 +|(% style="width:257px" %)[[image:lss-flowarm-patterns.jpg]]|(% style="width:306px" %)Pattern Options|(% style="width:758px" %)Add, remove, copy, save, open and delete patterns.
159 +|(% style="width:257px" %)[[image:lss-flowarm-frames.jpg]]|(% style="width:306px" %)Frame Options|(% style="width:758px" %)Adding a frame adds a blank frame to the list. The drop-down list gives "useful" pre-made frames. Recording a frame copies the arm's current on-screen position. The X removes a selected frame.
160 +|(% style="width:257px" %)[[image:lss-flowarm-copy-paste.jpg]]|(% style="width:306px" %)Copy / Paste Frame|(% style="width:758px" %)Copy and paste a frame
161 +|(% style="width:257px" %)[[image:lss-flowarm-settings.jpg]]|(% style="width:306px" %)Settings|(% style="width:758px" %)Useful features include: Toggle pause before frame; Remove gaps between frames; Reverse frames
162 +|(% style="width:257px" %)[[image:lss-flowarm-lock.jpg]]|(% style="width:306px" %)Lock |(% style="width:758px" %)
163 +|(% style="width:257px" %)[[image:lss-flowarm-loop.jpg]]|(% style="width:306px" %)Repeat / Loop Pattern|(% style="width:758px" %)Play once or loop; Set the playback speed using the up and down arrows.
164 +|(% style="width:257px" %)[[image:lss-flowarm-play.jpg]]|(% style="width:306px" %)Playback Options|(% style="width:758px" %)Restart sequence, play or stop
149 149  
150 -{Work in progress}
151 -
152 152  [[image:lss-flowarm-keyboard-liveupdate.jpg]]
153 153  
154 -= Downloads =
168 +Just above the sequencer, you can find the following:
155 155  
156 -Download LSS Flowarm 3.0.8.12 [[here>>http://www.lynxmotion.com/tools/LSS%20FlowArm%20BETA%20(3.0.8.12).rar]].
170 +Keyboard: {More to come}
157 157  
158 -Password: beta
172 +Live Update:{More to come}
159 159  
160 -BETA: Note that information described here is subject to change, and is available for BETA testers.
174 += Troubleshooting =
161 161  
176 +If you encounter any bugs or issues when installing or using the LSS FlowArm application, please submit a new post on the Lynxmotion community sub-forum here: [[https:~~/~~/www.robotshop.com/community/forum/c/lynxmotion/electronics-software>>url:https://www.robotshop.com/community/forum/c/lynxmotion/electronics-software]]
177 +
162 162  {Work in progress}
lss-flowarm-association.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +813 bytes
Content
lss-flowarm-copy-paste.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +1.3 KB
Content
lss-flowarm-frames.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +1.8 KB
Content
lss-flowarm-lock.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +883 bytes
Content
lss-flowarm-loop.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +1.2 KB
Content
lss-flowarm-pattern-list.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +1.5 KB
Content
lss-flowarm-patterns.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +2.7 KB
Content
lss-flowarm-play.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +1.6 KB
Content
lss-flowarm-settings.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.CBenson
Size
... ... @@ -1,0 +1,1 @@
1 +1.0 KB
Content
Copyright RobotShop 2018