Wiki source code of LSS FlowArm

Version 45.1 by Coleman Benson on 2019/09/09 13:59

14.1	1	[[image:LSS-FlowArm.png\|\|width="350"]]
	2
34.1	3	[[image:wiki-download.png]]
30.1	4
16.1	5	Page Contents
	6
14.1	7	{{toc/}}
	8
15.1	9	= Description =
14.1	10
16.1	11	{Coming soon}
	12
30.1	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.
	14
45.1	15
	16	FlowBotics Studio includes hundreds of built-in components that allow you to interface your PC to many of the standard computer peripherals and you can quickly create new components for new hardware. You can also 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.
	17
	18	The FlowBotics Studio programming language 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 for your projects and integrate photographs, drawings, and graphs.
	19
15.1	20	= Features =
4.2	21
30.1	22	* Graphical interface for the Lynxmotion SES V2 articulated robot arm
	23	* Full featured sequencer allows recording and playback of many sequences via keyboard input
	24	* Teach mode allows the user to move the arm and have the virtual arm follow
	25	* Position the arm using rectangular or cylindrical coordinates, virtual joysticks or mouse drag
	26	* Application can be modified via FlowBotics Studio
45.1	27	* LSS FlowArm is intended only for Windows operating systems 7 or higher.
16.1	28
15.1	29	= Initial Setup =
9.1	30
30.1	31	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.
	32
	33	Before assembling the arm, each of the IDs assigned to the servos must correspond with what is needed in the software.
3.1	34
4.1	35	* Base: 1
	36	* Shoulder: 2
	37	* Elbow: 3
	38	* Wrist: 4
	39	* Gripper: 5
3.1	40
34.1	41	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]]
30.1	42
34.1	43	Important note: The software does not take into consideration if a servo has been improperly assembled. If you see that your arm moves differently than the arm on screen, be sure to check the following:
	44
	45	* Servo ID is correctly assigned to each servo and there are no duplicate IDs
	46	* Servos have been assembled in correct orientation (as per assembly manual)
	47	* Servo offsets have been updated if necessary (see procedure below).
	48
15.1	49	= Interface =
3.1	50
15.1	51	== Header ==
	52
30.1	53	[[image:lss-flowarm-header.jpg]]
3.1	54
30.1	55	STORE OFFSETS
3.1	56
45.1	57	During the assembly process, if the servo's driving output horn was not rotated (they are shipped with the servo driving horn centered at 0 degrees), and was connected to the brackets at the correct angle (parallel or perpendicular depending on the servo being assembled), there should not be any significant servo offset needed and the arm should match what is displayed on screen. However, should the driving horn have rotated and/or the brackets were not connected at optimal angles, the "STORE OFFSETS" button configures 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]]). Before pressing the button, be sure to orient the arm as follows (with the gripper closed), and only then click the STORE OFFSETS button.
3.1	58
34.1	59	[[image:lss-flowarm-offsets.jpg]]
	60
30.1	61	LIMP
3.1	62
45.1	63	Causes all servos to go LIMP (i.e. lose torque). The arm will collapse.
3.1	64
45.1	65	Important note: The software will not constantly query all servos for their position, and as such the virtual arm on screen will not update. If you want the arm on screen to update, use the TEACH mode described below.
	66
30.1	67	STOP
	68
	69	Causes all servos to stop their motion and hold their position.
	70
	71	TEACH
	72
45.1	73	Teach mode allows a user to physically move the arm to a designed locations and have the virtual arm on screen follow. This is used primarily to manually add frames to the sequence.
30.1	74
	75	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.
	76
	77	When in teach mode, an orange outline appears over all on-screen fields which would cause a conflict and therefore cannot be used.
	78
	79	CAREFUL: Do not move the servos too quickly. We suggest moving the gripper servo, or temporarily removing the aesthetic shell.
	80
	81	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.
	82
	83	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.
	84
	85
	86	GRID / Units
	87
3.1	88	Units can be toggled between Metric or Imperial
	89
30.1	90	BAUD
3.1	91
31.1	92	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.
3.1	93
	94	COM
	95
30.1	96	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.
3.1	97
30.1	98	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).
	99
	100	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.
	101
	102	If the red light is solid, then no correct COM port has been located.
	103
	104	If the green light is solid, the a COM port has been located.
	105
3.1	106	Window Size
	107
30.1	108	[[image:lss-flowarm-size.jpg]]
3.1	109
30.1	110	A the top right of the window, there are three dark rectangles representing the window size.
	111
15.1	112	== 2D Views & Grid ==
3.1	113
15.1	114	== Arm Configuration ==
3.1	115
	116	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.
	117
	118	The aesthetics of the arms will be changing for the final / release version of the LSS Flowarm software.
	119
30.1	120	Side View
3.1	121
30.1	122	[[image:lss-flowarm-side-view.jpg]]
	123
3.1	124	The left view is a representation {more to come\|
	125
	126	Top View
	127
30.1	128	[[image:lss-flowarm-top-view.jpg]]
	129
3.1	130	The top view shows the arm {more to come}
	131
15.1	132	== Left Menu ==
3.1	133
30.1	134	Gripper
3.1	135
45.1	136	Assuming the gripper has been properly calibrated, The number below represents the opening at the tip.
	137
30.1	138	[[image:lss-flowarm-gripper-view.jpg]]
	139
3.1	140
30.1	141	Wrist
	142
45.1	143	The wrist angle can be locked or unlocked. The field allows for user input (click the numbers) or fine adjustments using the arrows.
	144
30.1	145	[[image:lss-flowarm-wrist-view.jpg]]
	146
3.1	147	End Effector Position
	148
30.1	149	[[image:lss-flowarm-positioning.jpg]]
	150
3.1	151	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.
	152
30.1	153	Data Log
3.1	154
30.1	155	[[image:lss-flowarm-data-log.jpg]]
3.1	156
	157	The console will be used as a serial command interface to manually send commands to the bus.
	158
15.1	159	== Sequencer ==
3.1	160
30.1	161	[[image:lss-flowarm-sequencer.jpg]]
3.1	162
45.1	163	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. The sequencer also allows you to vary the speed of playback of a routine. From left to right:
30.1	164
45.1	165	(% style="width:1303px" %)
	166	\|(% 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
	167	\|(% 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
	168	\|(% style="width:257px" %)[[image:lss-flowarm-patterns.jpg]]\|(% style="width:306px" %)Pattern Options\|(% style="width:758px" %)Add, remove, copy, save, open and delete patterns.
	169	\|(% 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.
	170	\|(% style="width:257px" %)[[image:lss-flowarm-copy-paste.jpg]]\|(% style="width:306px" %)Copy / Paste Frame\|(% style="width:758px" %)Copy and paste a frame
	171	\|(% 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
	172	\|(% style="width:257px" %)[[image:lss-flowarm-lock.jpg]]\|(% style="width:306px" %)Lock \|(% style="width:758px" %)
	173	\|(% 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.
	174	\|(% style="width:257px" %)[[image:lss-flowarm-play.jpg]]\|(% style="width:306px" %)Playback Options\|(% style="width:758px" %)Restart sequence, play or stop
30.1	175
15.1	176
30.1	177	[[image:lss-flowarm-keyboard-liveupdate.jpg]]
	178
15.1	179	= Downloads =
	180
	181	Download LSS Flowarm 3.0.8.12 [[here>>http://www.lynxmotion.com/tools/LSS%20FlowArm%20BETA%20(3.0.8.12).rar]].
	182
	183	Password: beta
	184
	185	BETA: Note that information described here is subject to change, and is available for BETA testers.
	186
	187	{Work in progress}

Wiki source code of LSS FlowArm

Navigation

Recently Visited