Home

Workshop 4 - ViSi-Genie User Guide

1. u D J is t T N m C T I Object Inspector Form Formo Object Formo Properties Eyents Property Value Name Form0_ Batype Color Color Wac Image H Source Vi Menus Ribbon with icons List of open projects Form and WYSIWYG screen where to place the objects Object inspector where properties and events are defined Messages about errors warnings and notices n N eS a 2012 4D SYSTEMS Page 11 of 48 www 4dsystems com au u D J OD t T N m C T T Vi 4D SYSTEMS ViSi Genie User Guide 5 1 Area 1 Menus The menus include standard Windows options Each menu displays a specific ribbon The debugger called Genie Test Executor is located under the Tool menu Home View Tools Comms Project 5 2 Area 2 Ribbon with Icons For the Home menu the ribbon includes the file related buttons and the objects grouped in panes An New Open Save SaveAs Print Build File Build The icons related to the files include New project Open project Save project Save as project Print project and Build project The objects are grouped in seven panes with input objects output objects and composite objects Just click on an object to select it The Build button builds the project and uploads it to the screen 5 3 Area 3 List of Open Projects On top of the What You See Is What You Get WYSIWYG screen the open
2. C T VI 2012 4D Systems Page 45 of 48 www ddsustems com au 4D SYSTEMS ViSi Genie User Guide 11 Application Notes For a more detailed presentation of the objects with examples please refer to the corresponding application notes For an exhaustive reference on ViSi Genie objects please refer to the ViSi Genie Reference Manual u D J D l T N m C T T n gt 2012 AD Systems Page 46 of 48 www ddsustems com au 4D SYSTEMS ViSi Genie User Guide 12 Revision History First Release Nov 19 2012 Fixed protocol information which was incorrect Mar 21 2013 u D J D t T N m C T T Vi 2012 4D SYSTEMS Page 47 of 48 www 4dsystems com au u D J D t T N m C T T VI 4D SYSTEMS ViSi Genie User Guide 13 Legal Notice Proprietary Information The information contained in this document is the property of 4D Systems Pty Ltd and may be the subject of patents pending or granted and must not be copied or disclosed without prior written permission 4D Systems endeavours to ensure that the information in this document is correct and fairly stated but does not accept liability for any error or omission The development of 4D Systems products and services is continuous and published information may not be up to date It is important to check the current position with 4D Systems 4D Systems reserves the right to modify update or makes changes to Specifications
3. Ed es Fe New Open Save SaveAs Print Build N jer File Build db ENoname x Form0 3 Object Inspector o ey Form Forma Object Formo v Properties Events Property Value Name Formo Bgtype Color Color Wac Image Source Insert Workshop 4 displays an empty screen called Formo e A project consists of one or more forms e A form is like a page on the screen e The form includes objects like sliders displays or keyboards You are ready to start u D J is t T N C T T VI 2012 4D SYSTEMS Page 10 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 5 The Main Screen The main screen appears FT ree Workshop 4 NoNamel uLCD 32PT LANDSCAPE Home View Tools Comms Project oe New Open Save SaveAs Print Build P Twa File Build ee db ENoname x Form0 3 Object Inspector x g 4 J Form Form0 Object Formo a Properties Events Property Value Name Formo Batype Color Color Weck Image Source Let s detail the different areas There are six different areas from left to right for top to bottom Workshop 4 NoNamel uLCD 32PT LANDSCAPE U X File Home View Tools Comms Project a M pe Buttons Digits Gauges Primitives Inputs Labels System Sj Lig New Open Save SaveAs Print Build F TER Build
4. u D J O T N C T T Vi 4D SYSTEMS ViSi Genie User Guide To add a sound file click on Add the sound file is selected through an Open window eo a gt Libraries Music r Search Music Organize New folder a jr Favorites mm Music library BE Desktop Includes 2 locations Arrange by Folder W lae Name i Contributing artists Album Title 7 Dropbox S Recent Places No ttems match your search SkyDrive TV enregistr e a Libraries gt tal 4D Systems gt E Documents gt al Music gt kel Pictures gt BE Videos gt ea MI File name a Files can be sorted by clicking on Up or Down and removed by clicking on Delete Only one Sound object can be added per project but this sound object can contain multiple sound files For more information on the Sound object please refer to the application note 4D AN P4006 ViSi Genie Play Sound 7 7 5 Timer T Timer is an invisible object It raises an event here every 1000 ms Interval 1000 This object has one single event onTimer 2012 AD SYSTEMS Page 36 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 7 8 Selection Tool To select an object just click on it green or red dotted lines appear The arrow is used to deselect and object To deselect an object just click again the dotted lines disappear u D J is t T N C T I VI 2012 4D SYSTEMS P
5. u D J D l N C T T n gt 4D SYSTEMS ViSi Genie User Guide 10 Communication Terminal An alternative to the debugger is the Terminal To launch the Terminal select the Tools menu li N l Home View Tools Project iy Bi P GTX Ben A ha bod Boot PmmC Terminal Terminal Touch 4DGL uSD Loader 9600 115200 Calibration uga Link Da and Click Terminal connect 9600 to open the currently selected com port at 9600 baud in the Terminal program Click Terminal connect 115200 to open the currently selected com port at 115200 baud in the Terminal program A new screen appears Beri s b B Port com3 Speed 9600 x Wi Connect Send Hex X Clear To send the commands on hexadecimal format press The commands sent by the host and the messages sent by the screen are the same as with the Genie Test Executor debugger The white area on the right displays e n green the messages sent to the screen e And in red the messages received from the screen 2012 4D Systems Page 44 of 48 www ddsustems com au 4D SYSTEMS ViSi Genie User Guide Here the command Set SliderO to value 0x17 is sent or 04 00 17 displayed in green on the terminal window B ge Port com 3 Speed 3600 13 15 09 gt Di 04 00 OO FE FB 13 15 05 lt O06 And the screen answers with the 0x06 successful acknowledgement displayed on red on the terminal window u D J D l A N
6. 6 1 Label This object has no event 7 6 2 Static Text This object has no event 7 6 3 Strings StringO A ee ee mp Ha ml ane he BEE i This object displays a text 2012 AD SYSTEMS Page 31 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide The text is defined by amp Strings Editor Input Edit Strings Sample Message lof 1 l Lines Message 14 Width 200 Height 178 Strings Style Message Col 1 of Line 2 of Page 1 Object Attributes Font 40 Font3 8x12 Bold Italic Strikethrough Underline Size 12 ANSI Last Char 127 Fj Opaque OF x Cancel u D J is t T N C T T Font size ANSI or Unicode can be defined This object has no event Vi For more information on the Labels objects please refer to the application note 4D AN P4013 ViSi Genie Labels Texts and Strings 2012 4D SYSTEMS Page 32 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 7 7 System Media Objects The System pane includes the form image and video objects and two invisible objects timer and sound 7 7 1 Image The image is selected through an Open window Open GO di H Libraries Pictures O1 Getting Started Search O1 Getting Started Organize New folder Fr Favorites Pictur HE Desktop 01 Gettin p Downloads as Dropbox J ES EER a se E Recent Places f _ da SkyDrive TV e
7. T T Vi 4D SYSTEMS ViSi Genie User Guide 7 3 3 Angular Meter 80 00 GH fm dy N NN EN an NN Het EN oe 0 00 100 i OO The meter displays a value in a dial Minimun and maximum number of intervals scales and three zones all colours are fully configurable among other options The meter is an output object and can send a message when changed This object has one single event onChanged very useful to send the value received 7 3 4 Cool Gauge add Th SE The meter displays a value in a dial Minimun and maximum linear or logarithmic scales all colours are fully configurable among other options The meter is an output object and can send a message when changed This object has one single event onChanged very useful to send the value received 7 3 5 Thermometer o 80 70 50 This object offers no customisation This object has one single event onChanged very useful to send the value received For more information on the Gauge objects please refer to the application note 4D AN P4008 ViSi Genie Gauges 2012 AD SYSTEMS Page 24 of 48 www 4dsystems com au u D J O t T N m gt C T T Vi 4D SYSTEMS ViSi Genie User Guide 7 4 Primitives Objects The Primitives pane offers standard static drawings 7 4 1 Circle The colour and the option of empty or s
8. corm Start building a new program using the same o EE settings as vou last used Visi Genie uLCD 32PT AN13 LED Digits 4DGenie Notfound C Users 04D Dropbox 4D Projects ViSi Genie Application Notes 4D AN 1013 VG ViSi Genie Digital Displays AN13 LED Digits AN13 LED Digits 4DGenie To create a new program there are multiple options e Click on the top left most icon New u D is T n C T I n gt 2012 AD SYSTEMS Page 6 of 48 www 4dsystems com au u D J OD T N m C T T Vi 4D SYSTEMS ViSi Genie User Guide e Click on the icon close to Create a New Project on top or if the settings have been already defined click on the icon close to Create a New Project on bottom WO od KS H O D Version 4 0 2 1 Create a new Project Start building a new Visi Genie Designer or Serial program Create a new Project Start building a new program using the same settings as you last used Visi Genie uLCD 32PT All those options update the main window with the selection of the screen CHOOSE YOUR PRODUCT HOLED 96 G2 0 96 Intelligent OLED module HOLED 128 G2 128x128 Ei 1 5 Intelligent OLED module OR HOLED 160 6G2 1 7 Intelligent OLED module pLCD 144 G2 128x128 1 44 IntelligentLCD Module pLCD 24PTU 240x320 2 4 QVGA Intelligent Touch Screen LCD Module pLCD 28PT 240x320 2 8 QVGA Intelligent Touch Screen LCD Module pPLCD 2
9. projects are displayed Click on the tab to open it or on the cross to close it 5 4 Area 4 Form and WYSIWYG Screen The form represents a WYSIWYG screen The active form is displayed there with its objects Objects are picked from the panes and can be resized and moved Click on an object to select it 2012 AD SYSTEMS Page le of 48 www 4dsystems com au u D J is t T N m C T T Vi 4D SYSTEMS ViSi Genie User Guide 5 5 Area 5 Object Inspector The object inspector provides all the information on the selected object e properties as size and position e and events where actions are defined 5 6 Area 6 Message Window The message window displays errors warnings and notices after the project is built Before starting using the Workshop 4 we need to connect the screen and prepare a micro SD card For more information about connecting the screen please refer to the Workshop 4 User Guide The micro SD card shall be FAT16 formatted Partition can t exceed 2 GB For more information about formatting the micro SD card please check the details on chapter Format the Micro SD Card described in the document Workshop 4 Installation 2012 AD SYSTEMS Page 13 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 6 A First ViSi Genie Project Workshop 4 display an empty screen called Formo A form is like a page on the screen The form includes objects like slid
10. the thumb of the slider Each object has parameters which can be set and configurable events to animate and drive other objects or communicate with an external host Simply place an object on the screen position and size it to suit set the parameters such as colour range text and finally select the event you wish the object to be associated with it is that simple Objects are classified in three different groups INPUT OJECTS as a button or a keyboard OUTPUT OJECTS as a gauge or a meter and COMBINED OJECTS or INPUT OUTPUT OBJECTS as a slider which acts as both an input and an output In seconds you can transform a blank display into a fully animated GUI with moving meters animated press and release buttons and much more All without writing a single line of code ViSi Genie provides the user with a feature rich rapid development environment second to none This document should be used in conjunction with the ViSi Genie Reference Manual ViSi Genie is included in the integrated development environment Workshop 4 To install Workshop 4 please refer to the document Workshop 4 Installation ViSi Genie is currently only available for the Picaso platform attempting to build a ViSi Genie program for Goldelox will fail ANY HOST amp PROCESSOR amp Design these applications and many more in only a few minutes 4D DISPLAYS HOST CONTROLLER 2012 AD SYSTEMS Page 4 of 48 www 4dsystems com au 4D SYSTEMS ViSi Ge
11. 4PT 240x320 2 4 QVGA Intelligent Touch Screen LCD Module Select the screen here the uLCD 32PT 240x320 2012 AD SYSTEMS Page 7 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide The selected screen is displayed CHOOSE YOUR PRODUCT pLCD 24PT 240x320 2 4 QVGA Intelligent Touch Screen LCD Module HLCD 24PTU 240x320 2 4 QVGA Intelligent Touch Screen LCD Module pLCD 28PT 240x320 2 8 QVGA Intelligent Touch Screen LCD Module HLCD 28PTU 240x320 2 8 QVGA Intelligent Touch Screen LCD Module pLCD 32032 P1 240x320 3 2 QVGA Intelligent Touch Screen LCD Module Portrait Click image to rotate pLCD 32PTU 240x320 3 2 QVGA Intelligent Touch Screen LCD Module Orientation is portrait by default To set it to landscape just click on the image of the screen to rotate it CHOOSE YOUR PRODUCT pLCD 24PT 240x320 2 4 QVGA Intelligent Touch Screen LCD Module pLCD 24PTU 240x320 2 4 QVGA Intelligent Touch Screen LCD Module pLCD 28PT 240x320 2 8 QVGA Intelligent Touch Screen LCD Module u D is t T T m C T T n gt pLCD 28PTU 240x320 2 8 QVGA Intelligent Touch Screen LCD Module pLCD 32032 P1 240x320 3 2 QVGA Intelligent Touch Screen LCD Module Landscape Click image to rotate pLCD 32PTU 240x320 3 2 QVGA Intelligent Touch Screen LCD Module Press Next to proceed 2012 AD SYSTEMS Page 8 of 48 www 4dsystems com au u D is t T n C
12. 5 Checksum REPORT_EVENT 0x07 Checksum u D J D T N m x C T T n gt 2012 4D Systems Page 39 of 48 www 4dsystems com au u D is T T D C T T n gt 4D SYSTEMS ViSi Genie User Guide 8 1 3 Command Set Messages The ViSi Genie Reference Manual provides detailed information intended for programmers of the Host Controller It contains the message formats of the commands that comprise the ViSi Genie protocol New commands may be added in future to expand the protocol 8 1 4 Acknowledgement Bytes Table Acknowledge byte O6hex this byte is issued by the Display to the Host when the Display has correctly received the last message frame from the Host The transmission message for this is a single byte O6hex Not Acknowledge byte 15hex this byte is issued by the receiver Display or Host to the sender Host or Display when the receiver has not correctly received the last message frame from the sender The transmission message for this is a single byte 15hex 8 2 Genie Advanced Protocol Genie advanced protocol allows managing multiple screens will be released soon 2012 AD Systems Page 40 of 48 www ddsustems com au 4D SYSTEMS ViSi Genie User Guide 8 3 Object Types Table 18 0x1 19 0x1 Video 20 0x1 StaticText 21 0x1 Sound 22 0x16 Timer 23 0x17 Thermometer UserLed Displayed as part of form no method to alter __Dipswit
13. AD SYSTEMS TURNING TECHNOLOGY INTO ART aN Workshop 4 ViSi Genie User Guide Documen t Date 21 March 2013 Documen t Revision 1 1 W D tv W n Uncontrolled Copy when printed or downloaded Please refer to the 4D Systems website for the latest Revision of this document u D D l T N C T T Vi Contents 1 introduction to VIS GEISER N Ee AG De cee ED Ee EE So be Ge GE EG 4 2 Launch Workshop d i ee N EE Re ee ee GE ee GR Ee Ge Oe RD N Ge RO ee EE EE 5 AEieateaNaw Proie el siese ee N ER ee EG ae os ede N Ee ee EG ie Ge Ee EE ee GE ie od 6 4 Select ViS1 G CNG sasie ds EER See DEK GE Ed ee ee Ge Ge Pd EE Ge GE Ge EE Ke GE WE Ge ee 9 S The Ee ie AR EE EE EE OE RE EE N 11 eFC Ee Id OE EE EE EE E E 12 Die Aba does ne sel RE EE EE EE RE EE 12 Doe eSB list of Opern PiOlB SES or Ai ee ee ee ee ge Ge ee ER ge RE 12 5 4 Area 4 Form and WYSIWYG SEreeN sees SA RE SE se Re Dee ee NE Se GER N Ge Re se Ee ee se se es ee se 12 Ds Oe 5 Object MSC CON ie EE Se AR ER Re N EE ee AE N ee ee RE EE 13 5 6 Area 6 Message WiNdOW iese ee RE EE RE RE RERE ee EE ee Ee ee RE ee ee ERA Ee ee RE Ee ee ee ee Ee ee RE ee ee 13 6 A First ViSi Genie Project iese RE ee ke GE GE ie Ge GE NG de 14 GATE Obeets Ao nee ee n oe de ee EE eee ns ei oo Ge Ee ee eee 14 ME ds Olea N ER AE EER eves cla an EE N EE EE EEN 16 6 3 Controlling Multiple Objects soas ee see ee de Ge ie ie Ge de oe EG Re 16 6 4 Chaining QOjO CUS isi
14. EMS Page 17 of 48 www 4dsystems com au u D J is t T N C T I Vi 4D SYSTEMS ViSi Genie User Guide 6 4 Chaining Objects Combining the OnChanged and OnChanging events with sending messages from one object to another allows N a HHH multiple configurations OnChanging N Meteri Another configuration with the same result OnChanging OnChanged a gt D mm DEE A message is sent to the host controller once the track bar has been released OnChanged gt Report Message Un nengna a OnChanged l l N Meter 2012 4D SYSTEMS Page 18 of 48 www 4dsystems com au u D J is t T N C T T VI 4D SYSTEMS ViSi Genie User Guide Another configuration with the same result OnChanging gt OnChanged OnChanged m Report Message For more information on the interfacing of ViSi Genie with a host micro controller please refer to the application note 4D AN P4010 ViSi Genie Connection to a Host with Red Green Blue LED Control 2012 4D SYSTEMS Page 19 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 7 Objects ViSi Genie relies on three groups of objects e The INPUT OBJECTS produce stimuli data for INPUT type objects or directly to Serial output The animation for these objects is done under the hood for example the slider thumb movements etc A button press can launch a sub form or can send out serial data or cause another
15. Query Values reads the value from the screen s track bar gt E Genie Test eXecutor sel x Port COM 3 9600 Response size 2 Slider Change 12 28 03 285 07 04 00 00 38 3B Slider Change 12 28 03 316 07 04 00 00 39 3A Slider Change 12 28 03 379 07 04 00 00 3A 39 Slider Change 12 28 04 814 07 04 01 00 BO B2 Sliders Slid Ch 12 28 06 904 07 04 02 00 4D 4C Query Query Query ider Change Slider Change 12 28 06 936 07 04 02 OO 4E 4F Winbutton Change 12 28 10 024 07 06 00 OO OO 01 Set Form Value 12 28 16 280 01 OA 00 OO OO OB ACK 12 28 16 389 06 m set set ses WinButtons WinButtonD 2012 4D Systems Page 4e of 48 www ddsustems com au 4D SYSTEMS ViSi Genie User Guide The white area on the right displays e n green the messages sent to the screen e Andin red the messages received from the screen Slider Change 12 28 03 285 07 04 00 OO 38 3B Slider Change 12 28 03 316 07 04 00 OO 39 3A Slider Change 12 28 03 379 07 04 00 00 3A 39 Slider Change 12 28 04 814 07 04 01 00 BO Be Slider Change 12 28 06 904 07 04 O2 OO 4D 4C Slider Change 12 28 06 936 OT 04 O02 DON 4E 4F Winbutton Change 12 28 10 024 07 06 OO OO OO 01 Set Form Value 12 28 16 280 01 OA OO OO OO OB ACK 12 28 16 389 06 All values are in hexadecimal u D J D l A N C T T VI 2012 4D Systems Page 43 of 48 www 4dsystems com au
16. R N N OE OE OE Oe N EE N ONE N ON 31 1E SUAEIC Ted us N GR ek oe A Ge ee E E E EA N Ge dd 31 PE Ee e a a e o RE RE EN EE RE RE EE 31 7 7 stel Medi OD E oe ER EE EG EG ee Ee ee ee Ee ED ee ee ee ee 33 EE n UR RR AR OE OT N 33 Er ee RO EE EO EO EE OE EE OR OE EE OD 34 Td EO DI St oe PEE APENE E Cae EE enon GE AE AEE GE ee Ee ie E E EA 35 7 7 4 SoundS EE ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 35 na FR P I ai E AETI OO EEE ON N E A OO RE E EO EE 36 E DS a lee onr Fool EER EE ES Ee E E EG ee ED EE 37 LL 8 ViSi Genie Communications PLFOtOCOIS ccccccecccccsccsccscccccccccccccccccccccccccccccccscceccsccsccsccsccecs 38 T 54a We Gel p ser 118 2 6 Wel ea ea a EEE E EE EG ee ee EA E A 38 amp 1 1 Protocol DET AIR OS EE EE EER N EE GE AG GE OE EER ERG N SR GE RS Ge Ge OE DE RA Ge 38 8 1 2 Command and Parameters Table ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 39 o 8 L3 Command Set Messaf Ee es RE GE ee GOS Ee GN EG Ge GR Ne EG N SS GE NG DAG 40 5 8 1 4 Acknowledgement Bytes Table sees see ee EE RR ee EE ee ee ee RE ee ee ee ee ee ee ee 40 LI 8 2 GENIE Advanced Protocol SE EE EG Ee GE Ge EG Ee Ge Ge Ge Ee DE ER GE 40 e BB OD oe WY 96S Well RE EE N AE IE OE EE EN A1 gt 9 Integrated Debugger ssosossssosossssssososossssososossssososossssososossssosososessososossssosososessosososessososose 42 10 Communication Terminal ccc
17. Rd seed ed ee Di oe eg O se Ee n ed oe ee De ed ed DE EE 18 AE 9 ole eN EE EE EE EE EE EE EE 20 ER eo ODE N EE EE AE E EE OE OE EE EE EE OE 21 re Ae NY MA BA LOIN EE ET OE HE AE N 21 1 2 Diet Ok eelte EE N GE E N EE EE ee ER EE GO ee N n ee Ge 22 DZ MeN Bi RE EE RE RR EE EE EE deaieenen 22 7 24 CUSTOM DIES ED de EE ee EG RE Ge rd Oe de Ge Ge Ge 22 ee dee RR RE N ER ER RE EN 22 Ee RU od ab OT N ER OE OT E EN 22 EE ye oe N RE OE EE EO OE EE S 23 N EE EO E OE EO EE OE EE NE EE 23 ES AN E 1 RE A EO EN EA EE HE OE EEN 23 Ti se Meter as So AE N Ee EG ee Ee pat av E Ee So ede 24 TF ee ie OR RE RE OE EE HE EL ER AN 24 ie el ne OE EE EE E EN 24 TA PUSS ODE EES me edge ge ee ee or Ai ee oe ee n ee Re ge Ge ER ge ee N 25 EN ese ER EE OE 25 12 ROC UAVS as EER DE RE GE Ge GE OE AE Ge RE GEE 25 EEN AU OE EE EE EE EE E 25 AE E OE RE RE RR EE OE EE seaseenen 26 RM s o ER OE EE EA DI 26 TAG ER RE N ER ER RE RE EE 26 2012 4D SYSTEMS Page 2e of 48 www 4dsystems com au F 5s DUES ODIO CIS RR EE N N N EE N OE RR EE N EE 27 Fee de EE OE OE OE N EE RO EE OE ON ON 27 1 5 2 Rotary SIE EE GR ER nena ER N ee ee Ee ie ee RR RE Re ERG De 27 ASA RO EO EE OE EO OE OE EO N 27 ASEM oe oe RE EO ORE ES EE EE OR OE EE OE EE 28 AR K ele ie EE EE RE OE OE EE 28 4 G DIP SWI Se Ee EE Ed ee EE eer ree acre 30 7 5 7 RotkeEr SWEER N A egy ee eee ae em et Ee 30 7 6 Labels ObIEERS sd ie teen sud oo ee ee de ei bee ie De oe oe oe De ed RE ee DE eg 31 AE MR O
18. Standard Protocol This section describes the Genie Standard Protocol in detail 8 1 1 Protocol Definitions The commands and parameters are sent and received using a very simple messaging structure The message consists of a command byte command parameters and a checksum byte The checksum ensures some the integrity of the message The following figure shows the organisation of the message CHKSUM e CMD This byte indicates the command code Some commands will have more parameters than others The table below outlines the available commands and their relevant parameters e PARAM Parameter bytes variable a variable number of parameter bytes between 1 to N that contains information pertaining to the command Refer to the command table below e CHKSUM Checksum byte this byte is calculated by taking each byte and XOR ing all bytes in the message from and including the CMD byte to the last parameter byte Then the result is appended to the end to yield the checksum byte Note If is correct check byte plus the sum of all the other bytes in the message will give a result of 0 2012 AD SYSTEMS Page 38 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 8 1 2 Command and Parameters Table Command Code Checksum READ OB 0x00 Checksum WRITE OB 0x01 Checksum WRITE_STR 0x02 Checksum WRITE_ STRU 0x03 Checksum WRITE_ CONTRAST 0x04 Checksum REPORT_OBJ 0x0
19. T T Vi 4D SYSTEMS ViSi Genie User Guide 4 Select ViSi Genie The main window now asks for the kind of project CHOOSE YOUR ENVIRONMENT The Designer environment enables the user to write 4DGL code in its 4 visual programming experience suitable called ViSi enables drag and natural for to program the display module drop type placem ent of objects to assist with 4DGL code generation and allows the user to visualise how the display will look while deing developed ViSi Genie An advanced environment called ViSi Genie doesn t require any 4DGL coding at all it is all done for you Simply lay the display out with the objects you want set the events to drive them and the code is written for you automatically ViSi Genie provides the latest rapid development experience from 4D Systems To select ViSi Genie just click on the blue arrow ViSi Genie An advanced environment called ViSi Genie doesn t require any 4DGL coding at all itis all done for you Simply lay the display out with the objects you want set the events to drive them and the code is written for you automatically ViSi Genie provides the latest rapid development experience from 4D Systems 2012 AD SYSTEMS Page 9 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide The development environment is now displayed r i orkshop 4 NoNamel uLCD 32PT LANDSCAPE eR eS Home View Tools Comms Project Ls
20. Y 1 r 1 None 1 True Key Width Movement 40 Key Height Movement 40 1 None 1 True 1 True 1 True aL New Key fh Delete Key 1 True lt I Move all Left EF Move all Right 1 True 1 True gb Move all Up 8 Move all Down 1 True O oo ON DOD WH BL MH a 4 gt gw 2 1 True EE FF FF F FSS TE FF FF N N IE Change Matching column Colors 4 Mass The Keyboard Editor allows you to select and customise the keyboard Keyboard Type E QWERTY Numeric Cellphone Empty Custom For more information on the Keyboard object please refer to the application note 4D AN P4003 ViSi Genie Customised Keyboard 2012 AD SYSTEMS Page 29 of 48 www 4dsystems com au u D J is t T N m C T T VI 4D SYSTEMS ViSi Genie User Guide 7 5 6 DIP Switch The number of positions of the switch can be specified 2 as shown or more This object has two events onChanged and onChanging 7 5 7 Rocker Switch When on the red LED is turned on This object has two events onChanged and onChanging For more information on the Inputs objects please refer to the application note 4D AN P4009 ViSi Genie Inputs 2012 AD SYSTEMS Page 30 of 48 www 4dsystems com au u D J D t T N m gt C T T Vi 4D SYSTEMS ViSi Genie User Guide 7 6 Labels Objects The Labels pane offers three different objects to display text 7
21. age 37 of 48 www 4dsystems com au u D J O t T N m C T T Vi 4D SYSTEMS ViSi Genie User Guide 8 ViSi Genie Communications Protocols The ViSi Genie display platform offers a serial communications protocol called the Genie Standard Protocol The protocol provides access to a majority of the display s features and gives the host detailed information on the current state of all the objects used in the display application The Genie Standard Protocol provides a simple yet effective interface between the display and the host controller and all communications are reported over this bidirectional link The protocol utilises only a handful of commands and is simple and easy to implement Serial data settings are 8 Bits No Parity 1 Stop Bit The baud rate for the display is selected from the Workshop Genie project The user should match the same baud rate on the host side Note RS 232 handshaking signals i e RTS CTS DTR and DSR are not supported by the ViSi Genie protocols Instead only the RxD received data TxD transmitted data and signal ground are used Objects are drawn on the display in the order they are created in the Workshop project If Image objects are to be used for the background and other objects on top then the image objects must be created and added first Also note this only applies to non active Image objects other active objects should not be added on top of each other 8 1 Genie
22. cccccccccccccccccccccccccccsccscccccsccsccccccccccccccccccccccsccsccsccsccsccscees 44 Ti Application Notes ese EG EE RE Ne ER EEEREN REREN 46 12 Revistor HISTON oos ES Ge Ge ie ee Oe Ed Se SG EE DA ie Dee RE AG ee Ee oe DO ei 47 13 Legal NOHCO ie EE scapes se oe suse vans suas EEEE ED ae 48 14 Contact IntormatiOn dei idee Gis Ged in EG Go ed ig ee dd Ge id ee Ge Ge ge ki ee Ge Di Ge 48 2012 AD SYSTEMS Page 3 of 48 www 4dsystems com au u D J is t T N C T I Vi 4D SYSTEMS ViSi Genie User Guide 1 Introduction to ViSi Genie This user guide provides an introduction to ViSi Genie the codeless rapid development tool for designing and building graphic user interface on 4D Systems screens ViSi Genie is a breakthrough in the way 4D Systems graphic display modules are programmed it provides an easy method for designing complex Graphics User Interface applications without any coding It is an environment like no other a code less programming environment that provides the user with a rapid visual experience enabling a simple GUI application to be designed from scratch in literally seconds ViSi Genie does all the background coding no 4DGL to learn it does it all for you Pick and choose the relevant objects to place on the display much like the ViSi environment yet without having to write a single line of code The full animation of the objects is done under the hood such as pressing a button or moving
23. ch 0 0x00 Me Knob 0K TM _ RockerSwitch 2 0x02 MM nv _ RotarySwitch 3 0x03 Me je Side 4 004 MT 5 TrackBar 5 0X05 MO D _WinButton 6 0x06 MM AngularMeter 7 0x07 T CoolGauge 8 0x08 OV T CustomDigits 9 0x09 S Form 10 0x0A Y Usedtosetthe currentform gt o gt U Gauge 11 0x0B S T Image 12 0x0C _ Displayed as part of form no method to alter T 13 0x0D V _ Keyboard inputs are always single bytes and are unsolicited b 14 0x06 S 15 OROF A d 16 0x10 S gt WOK EE EN Thermometer _ MEE OE AE EE __Userled NE ae Ed Video NE N EE Ed ___ StaticText Displayed as part of form no method toalter _ Sound NE ae Ed Timer NE a EE 2012 4D Systems Page 41 of 48 www ddsustems com au u D J D l T N C T T n gt 4D SYSTEMS ViSi Genie User Guide 9 Integrated Debugger The integrated debugger of Workshop 4 is called Genie Test Executor or GTX To launch the debugger click on the GTX button available on the menu Tools T a Home View Tools Project Bi 3 r GTX Fa a a Boot PmmC Terminal Terminal Touch 4DGL uSD Loader 9600 115200 Calibration uga Link k A new screen appears with the form and objects we have defined previously Fase Contro 9600 Response size 2 Just try to move the track bar and press Set the value is sent to the screen Pressing
24. e control equipment in hazardous environments requiring fail safe performance such as in the operation of nuclear facilities aircraft navigation or communication systems air traffic control direct life support machines or weapons systems in which the failure of the product could lead directly to death personal injury or severe physical or environmental damage High Risk Activities 4D Systems and its suppliers specifically disclaim any expressed or implied warranty of fitness for High Risk Activities Use of 4D Systems products and devices in High Risk Activities and in any other application is entirely at the buyer s risk and the buyer agrees to defend indemnify and hold harmless 4D Systems from any and all damages claims suits or expenses resulting from such use No licenses are conveyed implicitly or otherwise under any 4D Systems intellectual property rights 14 Contact Information For Technical Support support 4dsystems com au For Sales Support sales 4dsystems com au Website www 4dsystems com au Copyright 4D Systems Pty Ltd 2000 2012 2012 4D SYSTEMS Page 48 of 48 www 4dsystems com au
25. ers displays or keyboards A project consists of one or more forms orkshop 4 NoNamel uLCD 32PT LANDSCAPE Po eE File Home View Tools Comms Project A I Lo z i bere New Open Save SaveAs Print Build N Tr File Build di NoName1 x Form0 sa Object Inspector xa i J Form Formo i Object Formo Properties Events Property Value Name Formo Bgtype Color Color Wac Image Source Insert The form is empty We are going to build a form with two objets a track bar that updates a meter u D J is t T N m C T T 6 1 Adding Objects The track bar is an input object and the meter is an output object Vi Select the Inputs pane LU then the Track bar object 2012 AD SYSTEMS Page 14 of 48 www 4dsystems com au u D J OD t T N m C T T Vi 4D SYSTEMS ViSi Genie User Guide and then click on the desired location on the form to place it Workshop 42 NoNamel uLCD 32PT LANDSCAPE aa ms Ld GE Home View Tools Comms Project Buttons Digits Gauges Primitives ts labes System witha 6 e D 2 df d al E coo New Open Save SaveAs Print Build File Build 1 NeName1 x Object Inspector Form Formo 7 l Object Trackbaro Properties Events Property Value Name TrackbarO_ BorderWidth 10 Color _ dBtnFace Freque
26. event to occur Example a button e The OUTPUT OBJECTS only react to OUTPUT stimuli The stimulus data can come from the Serial port or an INPUT object They produce no input data or stimuli The animation for these objects is performed under the hood for example incoming serial data can move the needle of the meter etc OUTPUTs can be set regardless of whether they are displayed on the current form when the form containing them is displayed they are displayed with their current value Example a meter e Actually most objects are COMBINED OJECTS or INPUT OUTPUT OBJECTS Most input objects can also function as outputs with the notable exception of Keyboards Certain objects need both an input stimuli as well as produce an output event For example a slider thumb position may need to be remotely controlled from incoming serial data A button may need to be animated not only using the touch screen but via serial data Example a slider Here is the summary of the input output and combined objects A combined object is ticked both as input and output Pane Object ii salib se we o EE N EN ZN mememe Object Input Output C ems O wale tne ie EE N lt T D J is T N C T I Vi lt S a aa EE a a a 2012 AD SYSTEMS Page 20 of da www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide Pane Object Input Output Labels Static Text System Media Each object is presented with
27. ing Multiple Objects As described in the previous section an object sends a message to another single object Select the Digits pane Buttons Digits Gauges arimitive LED then the LedDigits object and place it on the form The final form looks like 2012 AD SYSTEMS Page 16 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide As previously moving the track bar raises the OnChanging event which sends a message to Meter0 with the value Object Inspector Form Form Object Trackbar Event Handler OnChanged OnChanging Meter0Set Now the meter has the event OnChanged raised when the meter receives a new value Object Inspector Form Formi Object Meter Event Handler OnChanged An action can be associated to that event to send the value to the LedDigitsO object Object Inspector Form Formo S Object Meterd Events Event Handler OnChanged Leddigits0Set u D J D t T N C T T Summarising Vi Iri mi mji m m i LI le Sa E 7 ri m m Par Fr 4 Lal LI Irr mA N A a N ar pen N al ELE LI N onChanging onChanged e Moving the track bar raises the OnChanging event which sends a message to Meter0 with the value e The meter Meter0 displays the new value and raises the OnChanged event which sends a message to LefDigitsO with the value That way multiple objects can be controlled 2012 AD SYST
28. its button on the left and an example on the right when used on a form Objects are drawn on the display in the order they are created in the Workshop project If Image objects are to be used for the background and other objects on top then the image objects must be created and added first Also note this only applies to non active Image objects other active objects should not be added on top of each other 7 1 Buttons Object u D is t T N m C T T Vi The Buttons pane contains only one object the WinButton 7 1 1 Win Button This object has one single event onChanged Buttons can be linked together to from a group through a matrix When one button of the matrix is pressed the previous one is released For more information on the Button object please refer to the application note 4D AN P4004 ViSi Genie Advanced Buttons 2012 AD SYSTEMS Page 21 of 48 www 4dsystems com au u D J OD t T N m C T T VI 4D SYSTEMS ViSi Genie User Guide 7 2 Digits Objects aE rm ra Ed Q hd The Digits pane contains 4 different displays The number of digits the decimal place the size the leading zeros can be customised 7 2 1 LED Digits This object has one single event onChanged very useful to send the value received 7 2 2 Custom Digits This object offers no customisation This object has one single event onChanged very useful to send
29. m values the vertical or horizontal orientations the colours can be customised This object has two events onChanged and onChanging 2012 AD SYSTEMS Page 27 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 7 5 4 Track bar The minimum and maximum values the vertical or horizontal orientations the frequency and ticks the colours can be customised This object has two events onChanged and onChanging 7 5 5 Keyboard a amp ans 3 cl gt gt tee Di u D J O t T N m C T T Vi ViSi Genie comes with various defined keyboards e QWERTY keyboard by default 2012 AD SYSTEMS Page 28 of 48 www 4dsystems com au u D J D t T N C T T Vi 4D SYSTEMS ViSi Genie User Guide e Cell phone keyboard e Numeric keyboard e And even a customised keyboard This object has one single event onChanged and sends the key pressed The different keyboards are selected by clicking on the KeyboardType property KeyboardType ktQWERTY ss Click on the button m to launch the Keyboard Editor Q Keyboard Editor coa x Keyboard Width 602 Keyboard Height 202 All images must be the same size Delete all entries to reset the size Only Bitmaps can be used gt Key ShKey Special Image Show Value Value Key Index Key Position of Next X 1 g 5 1 None 1 True An 1 True Position of Next
30. ncy 10 GutterBevel GutterColor Weck GutterWidth 9 Height 175 Left 88 Maxvalue 100 Minvalue 0 Orientation Vertical ScaleOffset 5 TickColor Wac TickMarks Both Top 36 Visible Yes m Now the same applies for the meter Select the Gauges pane Buttons Digits Gauges Primitives Inputs Labels System B HOE then the Meter object and place it on the form The final form looks like For a step by step example of a project please refer to the application note 4D AN P4001 Getting Started First Project with ViSi Genie 2012 4D SYSTEMS Page 15 of 48 www 4dsystems com au u D J D t T N m C T T Vi 4D SYSTEMS ViSi Genie User Guide 6 2 Linking Objects Now the objects need to be linked moving the track bar updates the meter Moving the track bar raises an event called OnChanging When an OnChanging event arises a message is sent to the meter with the value Object Inspector Form Formo Object Trackbar0 Event Handler OnChanged OnChanging Meter0Set For the end user each time he moves the track bar the meter is updated accordingly This example is detailed step by step on the application note 4D AN P4001 Getting Started First Project with ViSi Genie For a detailed presentation of the onChanging and onChanged events please refer to the application note 4D AN P4002 ViSi Genie onChanging and onChanged Events 6 3 Controll
31. nie User Guide 2 Launch Workshop 4 There is an alias for Workshop 4 on the desktop u D is t T n C T T n gt 2012 AD SYSTEMS Page 5 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 3 Create a New Project Workshop 4 opens and displays the Recent page C Users 04D Dropbox 4D Projects ViSi Genie Application Notes 4D AN P4010ViSi Genie ConnectiontoaHostwith Red Green Blue LED Control 4D AN P4010 ViSi Genie AN11 ViSi Genie RGB 4DGenie Notfound C Users O4D Dropbox 4D Projects ViSi Genie Application Notes 4D AN 1011 VG ViSi Genie Connection to a Host with Red Green Blue LED Control AN11 ViSi Genie RGB AN11 ViSi GenieRGB 4DGenie AN13 LED 4DGenie Not found C Users 04D Dropbox 4D Projects ViSi Genie Application Notes 4D AN 1013 VG ViSi Genie Digital Displays AN13 LED AN13 LED 4DGenie WoO R KS H O p ii de FITRA AN13 User LED 4DGenie Not found Version 4 0 2 1 C Users 04D Dropbox 4D Projects ViSi Genie Application Notes 4D AN 1013 VG ViSi Genie Digital Displays AN13 User LED AN13 User LED 4DGenie ROCKERPOSN 4dGenie 08 11 2012 10 12 Create a new Project C ProgramData Documents 4D Labs Picaso VS Start building a new Visi Genie Designer or Genie ROCKERPOSN 4dGenie Serial program NoName1 4DGenie Notfound E C Users 04D Desktop NoName NoName1 4DGenie NoN 1 4DGeni found Create a new Project RS Sa
32. nregistr e Arrange by Folder u D J is t T N m C T T Vi Libraries si 4D Systems E Documents a Music Pictures E Videos File name 01 This object has no event For more information on the Image object please refer to the application note 4D AN P4005 ViSi Genie Show Image 2012 AD SYSTEMS Page 33 of 48 www 4dsystems com au 4D SYSTEMS ViSi Genie User Guide 7 7 2 Video Organize New folder HE Desktop a E Jonak Arrange by Folder 7 Dropbox El Recent Places f SkyDrive TV enregistr e Libraries 2012 08 30 1910 tall 4D Systems EA Documents a Music sel Pictures Ed Videos fm Filename AD u D J D t T N C T T This object has one single event onChanged Vi For more information on the Video object please refer to the application note 4D AN P4007 ViSi Genie Play Video 2012 AD SYSTEMS Page 34 of 48 www 4dsystems com au u D J is T N C T T Vi 4D SYSTEMS ViSi Genie User Guide 7 7 3 Form CJ The Form creates a new empty form and adds it to the project This object has one single event onActivate 7 7 4 Sounds Sound is an invisible object This object has two events onPlayingChanged and onVolumeChanged The Sound object contains a list of sound files oown Sr Delete 2012 AD SYSTEMS Page 35 of 48 www 4dsystems com au
33. olid can be customised This object has no event 7 4 2 Rectangle The colour the outline and the option of empty or solid can be customised This object has no event 7 4 3 Triangle A The colour the outline and the option of empty or solid can be customised This object has no event 2012 4D SYSTEMS Page 25 of 48 www 4dsystems com au u D J D t T N C T T Vi 4D SYSTEMS ViSi Genie User Guide The colour and the pattern can be customised The colour and the option of empty or solid can be customised 7 4 4 Line This object has no event 7 4 5 Ellipse This object has no event 7 4 6 Panel _ The colour the outline the state lowered or raised can be customised This object has no event 2012 AD SYSTEMS Page 26 of 48 www 4dsystems com au u D J is t T N C T I Vi 4D SYSTEMS ViSi Genie User Guide 7 5 Inputs Objects The Inputs pane contains rotary selectors linear selectors keyboards and switches 7 5 1 Knob The minimum and maximum angles the back and the handle can be customised This object has two events onChanged and onChanging 7 5 2 Rotary Switch The minimum and maximum angles the positions and labels the switch and the winch colours can be customised This object has two events onChanged and onChanging 7 5 3 Slider The minimum and maximu
34. or written material without prior notice at any time All trademarks belong to their respective owners and are recognised and acknowledged Disclaimer of Warranties amp Limitation of Liability 4D Systems makes no warranty either expressed or implied with respect to any product and specifically disclaims all other warranties including without limitation warranties for merchantability non infringement and fitness for any particular purpose Information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates It is your responsibility to ensure that your application meets with your specifications Images and graphics used throughout this document are for illustrative purposes only All images and graphics used are possible to be displayed on the 4D Systems range of products however the quality may vary In no event shall 4D Systems be liable to the buyer or to any third party for any indirect incidental special consequential punitive or exemplary damages including without limitation lost profits lost savings or loss of business opportunity arising out of or relating to any product or service provided or to be provided by 4D Systems or the use or inability to use the same even if 4D Systems has been advised of the possibility of such damages 4D Systems products are not fault tolerant nor designed manufactured or intended for use or resale as on lin
35. the value received 7 2 3 LED The size the label the font and the colour can be customised This object has one single event onChanged very useful to send the value received 7 2 4 User LED f The size and the colour can be customised This object has one single event onChanged very useful to send the value received For more information on the Digits objects please refer to the application note 4D AN P4012 ViSi Genie Digital Displays 2012 AD SYSTEMS Page ee of da www 4dsystems com au u D J is T N C T T VI 4D SYSTEMS ViSi Genie User Guide 7 3 Gauges Objects The Gauges pane contains 5 specialised displays 7 3 1 Meter The meter displays a value in a dial Minimum and maximum number of intervals and scales all colours are fully configurable among other options The meter is an output object and can send a message when changed This object has one single event onChanged very useful to send the value received 7 3 2 Gauge The meter displays a value in a dial Minimun and maximum number of intervals scales and three palettes all colours are fully configurable among other options The meter is an output object and can send a message when changed This object has one single event onChanged very useful to send the value received 2012 4D SYSTEMS Page 23 of 48 www 4dsystems com au u D J O t T N m C

Workshop 4 - ViSi-Genie User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents