VGA-Adapter Manual v1 - CONRADT · 2011. 10. 27. · VGAAdapter-Manual, v1.4, 27/10/2011 P3/29...

VGAAdapter-Manual, v1.4, 27/10/2011

P1/29 ©2009 CONRADT Mess- und Regeltechnik

CONRADT Mess- und Regeltechnik

VGA-Adapter

Manual v1.4

Conradt Mess- und Regeltechnik

Lindenweg 2 D-78476 Allensbach

Tel.:+49(0)7533-97660, -97662 Fax.: +49(0)7533-97661

[email protected] www.conradt.com


Aktive Schwingungsdämpfung ? ?Die Kunst des Messens Physik für den Gebrauch

ToolNet

®




Contents1 Overview........................................................................................................................3

1.1 General Description ..................................................................................................3 1.2 Startup......................................................................................................................3 1.3 Features ....................................................................................................................3 1.4 Interfaces ..................................................................................................................3

2 Communication Interfaces ..............................................................................................4 2.1 Data Interface options...............................................................................................4

2.1.1 RS485 interface ...............................................................................................4 2.1.2 Ethernet interface ............................................................................................4 2.1.3 RS232 interface ...............................................................................................4 2.1.4 Radio interface – ToolNet................................................................................5

2.2 Monitorport Interface................................................................................................5 2.3 USB Interface ...........................................................................................................5

3 Software .........................................................................................................................6 4 Configuration .................................................................................................................7

4.1 Help function............................................................................................................7 4.2 The commands .........................................................................................................8

4.2.1 Overview.........................................................................................................8 4.2.2 Description ......................................................................................................8 4.2.3 Graphical commands .....................................................................................20

5 Update..........................................................................................................................23 5.1 Update with the Update Manager Software.............................................................23 5.2 Update with the Update Manager Software over USB.............................................24 5.3 Update with the Hyperterminal ...............................................................................24

6 Upload of background images or fonts..........................................................................25 7 Error Messages .............................................................................................................25

7.1 Error messages on the interfaces. ............................................................................25 7.2 Error messages .......................................................................................................27

8 Usefull features ............................................................................................................28 8.1 Read full configuration ...........................................................................................28

9 Specifications ...............................................................................................................28 9.1 Electrical characteristics: ........................................................................................28 9.2 Data interface specification:....................................................................................29

10 Revision history......................................................................................................29 11 Notes ......................................................................................................................29




1 Overview

1.1 General Description The VGA-Adapter provides an simple graphical user-interface for embedded devices. With the VGA-Adapter the user have the possibility to create visual display content for monitoring and signalling. Every VGA Display which supports the resolution of 800x600 @ 60 Hz can be attached to the Adapter. The following interfaces are available for the VGA-Adapter: ? RS232 ? RS485 Bus Mode / Plain text mode ? Ethernet ? Radio interface (ToolNet) Up to 15 background images and user defined fonts can be loaded on the VGAAdapter. With user defined textfields, graphical objects and diagrams a simple access to the VGA-Display is provided. On the other hand the user has also the possibility to access each pixel on the attached Display in text mode.

1.2 Startup Before starting up the device attach an appropriate display at the VGA connector and then switch on the power for the VGAAdapter. After that switch on the display.

1.3 Features - Supports SVGA 800x600 @ 60Hz. - 64 colours. - non volatile memory space for up to 15 background images (depends on the used

FlashRom; see options). - 512 kBytes non volatile memory space for user defined fonts. - Up to 20 graphical objects like circles, rectangles, lines and ellipses can be predefined. - Up to 20 textfields can be predefined. - Up to 4 diagrams can be predefined - RS485 connectivity. Bus mode or plain text mode. - Ethernet interface available - RS232 interface available - Radio interface available (ToolNet)

1.4 Interfaces - Data interface options

1. RS485 interface 2. Ethernet interface 3. RS232 interface 4. Radio interface (ToolNet)

- RS232 Monitor and configuration port - VGA interface - USB




2 Communication Interfaces

2.1 Data Interface options For the VGA-Adapter are several interfaces available. The commands for the interfaces are described in one of the following chapters.

2.1.1 RS485 interface The VGAAdapter can be accessed over the RS485 Bus. If the Bus protocol is active (busaddr != 00), all data received at the data port are confirmed with a handshake. Set all devices attached to the bus, in bus modus. The plain text modus on this interface is only workable with only one other device on the bus and is perhaps useful for configure the device and define the graphical objects and textfields. The parameters for this interface can be changed and have to be equal to the other devices on the bus.

2.1.2 Ethernet interface One of the VGA-Adapter interface options is an Ethernet adapter. The IP address can be set manually or obtained automatically over DHCP. The communication is performed over a free selectable TCP/IP port number. More information about the Ethernet adapter can be found in the LanAdapter Manual which can be downloaded from conradt.com.

2.1.3 RS232 interface A further interface option is the RS232 adapter. The communication with true RS232 levels can be performed over a 9-pin SUB-D connector and for a communication with TTL levels is a screw terminal mounted.

VGA-Adapter

VGA800x600 @60H

RS232 Data

VGA-AdapterRS485

MonitorPortVGA-Adapter

RS485InterfaceData

11pol plug

24VDC

PowerSupply

RS485Bus

12,2 Nm

USB

VGA-Adapter

VGA800x600 @60H

RS232 Data

VGA-AdapterEthernet


LanAdapterData

PowerSupply

12,2 Nm

USB

EthernetRJ45

5V-24VDC

CTS/RTS

MonitorPortLanAdapter

VGA-Adapter

VGA800x600 @60H

RS232 Data

VGA-AdapterRS232


RS232Level-

converterData

PowerSupply

12,2 Nm

USB

RS232

9polSUB-D

5V-24VDC

RS232TTL

Data




2.1.4 Radio interface – ToolNet To complete the interface options Conradt provide also a radio interface to the ToolNet. So every ToolNet Handheld device can directly communicate with a standard VGA Monitor to monitor measurements or status information.

2.2 Monitorport Interface The VGAAdapter monitorport interface can be connected with a standard Conradt programming adapter and any serial terminal. The standard parameters are: - Baudrate : 38400 - Databits : 8 - Parity : None - Stopbits: 1 The settings of the monitorport can’t be changed. The commands for this interface are described in one of the following chapters. If the user wants something to change or execute a command with an access level higher than 0 the user have to login on the system. This can be achieved by typing login <level> <pw>. Level is the access level which can be 1..3 and pw is your password. The password can be changed over the command chgp . The default password for level 1 and 2 is “123”. The command help shows you all available commands on the system.

2.3 USB Interface Over the USB Mini-B Connector the VGA-Adapter can be attached to a personal computer. This feature was tested under Windows 2000 and Windows XP. While the very first connecting, the System requires a device driver which you can obtain from Conradt. After installing the driver the VGA-Adapter USB port occurs in the Windows Device Manager as CDC Communication Port. Now with every comport terminal the VGA-Adapter can be accessed. The commands which are available for this interface are described in one of the following chapters.

Radio868/915 MHz

ToolNet

VGA-Adapter

VGA800x600 @60H

RS232 Data

VGA-AdapterRadio-Interface


RadioDeviceData

PowerSupply

12,2 Nm

USB

5V-24VDC

CTS/RTS

MonitorPortRadio Device




3 Software The user can obtain software from Conradt Mess- und Regeltechnik to create a background image from a bitmap or create user defined fonts for the VGAAdapter. To upload background images or fonts and update the VGA-Adapter a Update Manager software is available. For updating the VGA-Adapter login first and then enter update in the command field of the Update Manager software. To load a background image login first and then enter upload img <nr> while for <nr> you can insert the background image number under which the image is stored. To load a font selection login first and then enter upload font.




4 Configuration

4.1 Help function When you are connected with the VGAAdapter over a communication interface and you are searching for the right command or the correct syntax, type help followed by Enter into your console. Then you get a summary of all available commands. You can further type for example help config or help config gen etc. to look for the correct syntax of one command.




4.2 The commands If the user wants something to change or execute a command with an access level higher than 0 the user have to login on the system. This can be achieved by typing login <level> <pw>. Level is the access level which can be 1..3 and pw is your password. The password can be changed over the command chgp . The default password for level 1 and 2 is “123”. The command help shows you all available commands on the system.

4.2.1 Overview q Return ID, version and name quit Quits the connection (only tcp) login Login <level> <pw> (level=1..3) logout Logout chgp Change Password <level> <pw> <pw> (level=1..3; pw=new password) save Save [settings|resetconfig] (Save settings | Save settings as reset configuration) load Load [settings] reset Reset [settings|resetconfig] (Load the resetconfiguration | Load factory defaults) config Configure system setup ?config Query system setup restart Restart system test Test update Update security Security functions help Help ?error Return the error log upload upload [img,font] (Upload of an image or font file) print print text, lines, points, etc display display [screen|color|bgcolor|font|load|save] ?display ?display [screen|color|bgcolor|font] textfield textfield [new|change|delete|view|load|save] id (0<=id<=255,all) tf tf <id> "text"(0<=id<=255,all; write text into the formatted textfield) object object [new|change|delete|view|load|save|?states] id

(0<=id<=255,all) go go <id> <state> <ms> (0<=id<=255,all; print the formatted graphic object; ms on-time in milliseconds/ absence of ms=continuous) dgm dgm [new|change|delete|view|load|save|clear] id (0<=id<=255,all) dg dg <id> [<x>] <y> (0<=id<=255,all;

plot the next datapoint in the diagram; x is optional) ?colors ?colors (print some color information on the monitor screen) ?fonts ?fonts (return the availabe fonts; optional [all])

4.2.2 Description

Command "Q" Description Query AccLevel 0 Parameters - Reply VGA-Adapter va.b

xx xx xx xx xx xx xx




xx: Bytes of serial number

Command: "LOGIN <Level> <Code>" Description Login with access level <Level> AccLevel 0

- Level: accesslevel - Code:password (max. 10 characters) Parameter Valid data Description Level 1..3 (5) Access level

Parameters

Code Password for access level <Level> - "Hi ! Reply - "access denied !"

Note The standard password for level 1 and 2 is “123” e.g. "Login 2 MyPassword "

Command "LOGOUT" Description Logout (set access level to 0) AccLevel 0 Parameters - Reply “OK”

Command: "CHGP <Level> <NewPassword> <NewPassword>" Description Change password for access level <Level> AccLevel At least <Level>

- Level: Access level - NewPassword: New password for access level <Level> (max. 10 characters) Parameter Valid data Description Level 1..3 Access level

Parameters

NewPassword Up to 10 characters New password for access level <Level> - "password changed Reply - "access denied !"

Note Changes are NOT saved to flash. Use Command "SAVE <settings>" e.g. "Chgp 2 potato potato"

Command "RESTART" Description Restart Device (Software Reset) AccLevel 1 Parameters - Reply “Bye Bye”

Command: "SAVE <what to save>" Description Save something from RAM to EEPROM AccLevel 1

- Param: What to save

Parameter Description settings Save settings of the system from RAM to EEPROM

Parameters

resetconfig Save the actual settings as a reset configuration. This settings are restored when the command “reset settings” is entered.

Reply - "OK" - "error flash read", "error flash write"

Note




e.g. "Save settings

Command: "LOAD <what to read>" Description Load something from EEPROM to RAM AccLevel 1

- Param: What to load

Parameter Description

Parameters

settings Load settings of the system from EEPROM Reply - "OK"

- "error flash read", "error flash write" e.g. "Load settings

Command: "RESET <Param>" Description Reset something (in RAM) AccLevel 2

- Param: What to reset

Parameter Description settings Reset the settings of the system and load the reset configuration.

Parameters

resetconfig Reset the settings of the system and load the factory defaults. Reply "OK" Note Changes are NOT saved to flash. Use Command "SAVE <..>" e.g. "RESET settings

Command: “CONFIG <Type> <Param> <Data>” Description Configure system setup AccLevel 1

- Type: Type of control - Param: Parameter to configure - Data: Value

Type Param Data Description

Baud 48, 96, 192, 384, 576, 1152

Set baud rate of the standard RS232 port [100bit/s]

Parity none, odd, even

Set the parity of the standard RS232 port none: no Parity odd: odd Parity even: even Parity

Stopbits 0, 1, 2 Set the number of stopbits of the standard RS232 port 0 : 1 stopbit 1 : 1 ½ stobbits 2 : 2 stopbits

SERIAL

Echo 1/0 or On/Off

Switch automatic echo at the monitor port on or off Not available in bus mode.

Parameters

MONPORT

Baud 48, 96, 192, 384, 576, 1152

Set baud rate of the monitor port [100bit/s] !Parameter not changeable.





Set the parity of the monitor port none: no Parity odd: odd Parity even: even Parity !Parameter not changeable.

Stopbits 0, 1, 2 Set the number of stopbits of the monitor port 0 : 1 stopbit 1 : 1 ½ stobbits 2 : 2 stopbits !Parameter not changeable.

Echo 1/0 or On/Off

Switch automatic echo at the monitor port on or off !Parameter not changeable.

Baud 48, 96, 192, 384, 576, 1152

Set the baud rate of the USB cdc communcation port in [100bit/s] Parity none, odd,

even Set the parity of the USB cdc communication port none: no Parity odd: odd Parity Stopbits 0, 1, 2 Set the number of stopbits of the USB cdc communcation port 0 : 1 stopbit

USB

Echo 1/0 or On/Off

Switch automatic echo at the USB cdc communcation on or off Not available in bus mode.

PER x Set the blinking period in miliseconds for the graphical objects. 100<=x<=60000. e.g. 192.168.1.123 DUCY x Set the duty cyle of the blinking in percent 0<x<100.

BLINK

Busaddr Value 00 <=Value < FF 00 = Bus Protocol off; 01 = Bus Master; To receive Data from the SDM/FSB the busaddr should set to 01.

GEN

SILENT value Set the output mode of the data interface. value = 0 : all queries and commands will been confirmed and answered. value = 1 : only queries will been answered. value = 2 : no queries and no commands will been confirmed or answered

MODE

DEF x A background image can be set as default x = the number of the default background image which is load at startup.

SCREEN

Reply Note

e.g.




Command: “?CONFIG <Type> <Param>” Description Show system setup AccLevel 1

- Type: Type of control - Param: Parameter to show Type Param Returned

Data Description

ALL - Shows the full configuration of the module

Baud 48, 96, 192, 384, 576, 1152

Shows the baud rate of the standard RS232 port [100bit/s]


Shows the parity of the standard RS232 port none: no Parity odd: odd Parity even: even Parity

Stopbits 0, 1, 2 Shows the number of stopbits of the standard RS232 port 0 : 1 stopbit 1 : 1 ½ stobbits 2 : 2 stopbits

SERIAL

Baud 48, 96, 192, 384, 576, 1152

Shows the baud rate of the monitor port [100bit/s]


Shows the parity of the monitor port none: no Parity odd: odd Parity even: even Parity

Stopbits 0, 1, 2 Shows the number of stopbits of the monitor port 0 : 1 stopbit 1 : 1 ½ stobbits 2 : 2 stopbits

MONPORT

Echo 1/0 or On/Off

Shows if the echo of the standard RS232 port is on or off

USB Baud 48, 96, 192, 384, 576, 1152

Shows the baud rate of the USB cdc communcation port [100bit/s]


Shows the parity of the USB cdc communcation port none: no Parity odd: odd Parity Stopbits 0, 1, 2 Shows the number of stopbits of the USB cdc communcation port 0 : 1 stopbit Echo 1/0 or

On/Off Shows if the echo of the standard USB cdc communcation port is on or off

PER Shows the blinking period in miliseconds for the graphical objects. 100<=x<=60000. e.g. 192.168.1.123

Parameters

BLINK

DUCY Shows the duty cyle of the blinking in percent 0<x<100.




Busaddr Value 00 <=Value < FF 00 = Bus Protocol off; 01 = Bus Master; To receive Data from the SDM/FSB the busaddr should set to 01.

GEN

SILENT value Shows the output mode of the data interface. value = 0 : all queries and commands will been confirmed and answered. value = 1 : only queries will been answered. value = 2 : no queries and no commands will been confirmed or answered

MODE

DEF x Shows the background image number which is set as default: x = the number of the default background image which is loaded at startup.

SCREEN

Reply “<Type> <Param > <Data>” Note The reply depends on the parameter “options configinfo”

Command Reply "?CONFIG gen busaddr" “config gen busaddr 20”

e.g.

“?CONFIG all”

Command "QUIT" Description Quits the active TCP Connection AccLevel - Parameters - Note Has only an affect while communicating with the system over a tcp-connection.

Command “UPDATE" Description Starts the update manager. Over the RS232 Interface and with the Updatemanager software, the

VGAAdapter can be updated. AccLevel 2 Parameters - Note You should know what you are doing!

Command “HELP" Description Prints a Help for using the commands on this interface AccLevel - Parameters - Note The help command can also be used in conjunction with another command.

e.g. “help ?measure” “help config” “help config control” “help config control p” “help config gen”

Command "SECURITY HWKEY <hwkey>"




Description Sets the hwkey of the device. When the hwkey is not set on a VGAAdapter only the monitorport is accessible.

AccLevel 0 Parameters - Note You should know what you are doing !

Command "?ERROR" Description Display all errors occurred since system start. AccLevel 1 Parameters - Note

Command "PRINT" Description Print this and that on the vga screen AccLevel 0

Object type Print parameter Description STR “text” x y color bgcolor font Print a string on the screen

“text” String to print x X-coordinate y Y-coordinate color The color for the text (optional) bgcolor The background color(optional) font The Font id (optional)

PNT x y color Print a point on the screen x X-coordinate y Y-coordinate color The color for the point (optional)

LNE x_from y_from x_to y_to color Print a line on the screen x_from Start X-coordinate for line y_from Start Y-coordinate for line x_to End X-coordinate for line y_to End Y-coordinate for line color The color for the Line (optional)

ELLIPSE x y a b color Print an ellipse on the screen x X-coordinate of ellipse center y Y-coordinate of ellipse center a horiz. radius of ellipse b vert. radius of ellipse color The color for the ellipse (optional)

FELLIPSE x y a b color Print a filled ellipse on the screen x X-coordinate of ellipse center y Y-coordinate of ellipse center a horiz. radius of ellipse b vert. radius of ellipse color The color for the ellipse (optional)

RECT x y w h color Print an rectangle on the screen x X-coordinate of left upper corner of rectangle y Y-coordinate of left upper corner of rectangle w width of the rectangle h height of the rectangle color The color for the rectangle (optional)

Parameters

FRECT x y w h color Print a filled rectangle on the screen x X-coordinate of left upper corner of rectangle y Y-coordinate of left upper corner of rectangle w width of the rectangle h height of the rectangle color The color for the rectangle (optional)

Note Coordinates, radius and geom. parameters of the object are in pixel. Available colors: 0..63 & 255 (255=transparent). Use command “?colors” to view the available colors.




Available fonts: On the system are three predefined fonts, others can be added by the user. Use command “?fonts” to view the available fonts.

Command "DISPLAY" Description Command for setting display parameters and display handling. AccLevel 1

type value Description

screen [on|off] Switch display on or off.

color [0..63|255] Default foreground color

bgcolor [0..63|255] Default background color

font font_id Default font

load [screen|content|all] [nr] Load background image and display content like textfields, graphic objects or diagrams for current use. [nr] is the screen number, it is optional and is the default screen number if nr is omitted(see config screen def). With the switch screen only the background image will be load, with content only the display content like textfields, graphig objects and diagrams will be load and with all both will be load.

Parameters

save [screen|content|all] [nr] Store the current background image and display content like textfields, graphic objects or diagrams. [nr] is the screen number, it is optional and is the default screen number if nr is omitted(see config screen def). With the switch screen only the background image will be stored, with content only the display content like textfields, graphig objects and diagrams will be stored and with all both will be stored.

Note

Command "?DISPLAY" Description query the display parameters AccLevel 1

type Description screen Show the state of the display: on or off. color Show the default foreground color bgcolor Show the default background color

Parameters

font Show the default font Note

Command "TEXTFIELD" Description Command for creating and handling predefined textfields. AccLevel 1 Parameters action textfield parameter Description




new id [xbg ybg wbg hbg xtxt ytxt nchar color bgcolor font]

create a new textfield, only the id is necessary the other parameters can be added in this order or changed later. id Textfield ID (0<=id<=254) xbg X-Coordinate of background field ybg Y-Coordinate of background field wbg Width of background field hbg height of background field xtxt X-Coordinate of Text ytxt Y-Coordinate of Text nchar Number of characters to show in the textfield color Text color bgcolor color of background field font Font id

change id [xbg|ybg|wbg|hbg| xtxt|ytxt|nchar|color| bgcolor|font] value

change one of the textfield parameters example: textfield change 2 xbg 200

delete id Delete the Textfield with the given id (0<=id<=254|all) view id View the Textfield with the given id (0<=id<=254|all) load all Load all Textfields

save id Save the Textfield with the given id (0<=id<=254|all) Note

Command "TF" Description Command for printing the predefined textfields. AccLevel 0 Parameters id text Print the text into the predefined textfield with the given id.

ex.: tf 1 “1234” Note

Command "OBJECT" Description Command for creating and handling predefined graphical objects. AccLevel 1

action object parameter Description new id [x y wa hb color1

color2 color3 bgcolor type]

create a new graphical object, only the id is necessary the other parameters can be added in this order or changed later. id object ID (0<=id<=254) x X-Coordinate of object (ellipse=center; rectangle=upper left corner) y Y-Coordinate of object (ellipse=center; rectangle=upper left corner) wa width/horiz. radius of object hb height/vert. radius of object color1 object color 1 color1 object color 2 color1 object color 3 type available types: 0=rectangle, 1=filled rectangle, 2=ellipse, 3=filled ellipse, 4=line

change id [x|y|wa|hb|color1| color2|color3| bgcolor|type] value

change one of the object parameters example: object change 2 x 200

delete id Delete the object with the given id (0<=id<=254|all) view id View the object with the given id (0<=id<=254|all) load all Load all graphical objects

Parameters

save id Save the graphical objects with the given id (0<=id<=254|all)




Note

Command "GO" Description Command for printing the predefined graphical objects. AccLevel 0 Parameters id state ms Print the predefined graphical object with the given id.

id the object id state available states: 0 show background color 1 show color 1 2 show color 2 3 show color 3 4 blinking: color1/background color 5 blinking: color2/background color 6 blinking: color3/background color 7 blinking: color1/color2 8 blinking: color1/color3 9 blinking: color2/color3 ms OnTime of the object in milliseconds. If no ms parameter is given the object is viewed continous.

Note

Command "DGM" Description Command to administrate diagram objects. AccLevel 1

action object parameter Description Parameters new id [x y w h xstart

ystart xend yend] create a new diagram object, only the id is necessary the other parameters can be added in this order or changed later. id =diagram ID (0<=id<=254) x = X-Coordinate of diagram (upper left corner) y = Y-Coordinate of diagram (upper left corner) w = width of diagram h = height of diagram xstart = start value of x axes ystart = start value of y axes xend = end value of x axes yend = end value of y axes




change id [x|y|w|h|color1|color2|color3|bgcolor|gridcolor|type|points|xstart|ystart|xend|yend| xgrids|ygrids|xheader|yheader|font] value

change one of the object parameters example: dgm change 2 x 300 x = X-Coordinate of diagram (upper left corner) y = Y-Coordinate of diagram (upper left corner) w = width of diagram h = height of diagram color1 = color of trace one color2 = color of trace two color3 = color of trace three bgcolor = background color gridcolor = grid color type = diagram type; possible values: ? 0(default)|2 = plot lines ? 1=plot points ? 10 = hor. progress bar ? 11 = ver. progress bar points = number of points on the x axes (type = progress bar; parameter not used) xstart = start value of x axes(type = progress bar; start value) ystart = start value of y axes(type = progress bar; start value of middle region) xend = end value of x axes(type = progress bar; end value) yend = end value of y axes(type = progress bar; start value of upper region) xgrids = number of grids on the x axes. (type = progress bar; parameter not used) ygrids = number of grids on the x axes. (type = progress bar; parameter not used) xheader = header of x axes (type=progress bar; header of progress bar) yheader = header(type = progress bar; parameter not used) font = diagram font.

delete id [screen_number] Delete the diagram with the given id belonging to the screen with the number <screen_number> (0<=id<=254|all); if the screen number is missing the default screen number is used.

view id View the diagram with the given id which are currently loaded (0<=id<=254|all);

load all [screen_number] Load all diagram objects belonging to the screen with the number <screen_number>; if the screen number is missing the default screen number is used.

save id [screen_number] Save the graphical objects with the given id belonging to the screen with the number <screen_number> (0<=id<=254|all) if the screen number is missing the default screen number is used.

clear id clears the diagram view.(prints the background, grids and headers) (0<=id<=254,all)

trace id switch to the next trace; start point is again at xstart and the next colour is selected. (0<=id<=254,all)

Note

Command "DG" Description Command for printing data into the diagrams. AccLevel 0




Parameters id [x] y plot the data point to the diagram with the given id. id the object id x x value of the data point. If x value is missing x is increased by (xend-xstart)/points one after every invocation of this command. Points (see command dgm) is then the maximal number of point s on the x axes. This is useful for continuous measurements to simplify the command. y The y value of the data point Note: Both x and y have to be inside the regions x-, y-start and x-,y-end of the diagram.

Note

Command "?colors" Description return the available colors and view a color table on the attached vga screen.

color region [0..63, 255] some available colors: 0 black 1 darkblue 3 blue 4 darkgreen 5 darkcyan 8 green 12 brightgreen 15 cyan 20 olive 21 darkgrey 42 grey 48 red 51 magenta 52 orangered 56 orange 60 yellow 63 white 255 transparent

AccLevel 1 Parameters - Note

Command "?FONTS" Description return the available fonts.

example: ?fonts id name size 01 Arial_8 8 02 Arial_16 16 10 arial_32 32 11 arial_48 48 df Fonts 1,2 are predefined fonts on the system. fonts 10 and 11 are user defined fonts. Size is the font height in pixel.

AccLevel 1 Parameters all show some additional info about the fonts Note

Command "UPLOAD" Description Command for uploading background image and user defined fonts.

Use in combination with the conradt update manager software v1.95 or higher. Start the update manager software connect it to the VGAAdapter and type this command into the input field. Then wait for the request to upload the image or font, choose a file and press update.

AccLevel 1




img [nr] upload of a background image to flash. [nr] is the screen number, it is optional and is the default screen number if nr is omitted(see config screen def).

|Parameters

font upload of user defined fonts to flash. Note

Command "TEST" Description For test purpose only AccLevel - Parameters - Note You should know what you are doing !

4.2.3 Graphical commands

4.2.3.1 Command print

With the print command points, strings, lines, ellipses, filled ellipses, rectangles and filled rectangles can be displayed on the attached screen. The parameters color, bgcolor and font are optional and if they are missing the default values (cmd:display [color|bgcolor|font]) are used.

4.2.3.2 Command object and textfield

800 pixel

600

pixe

l

[0|0]

110 V / 20 mA[xbg|ybg] wbg

hbg[xtxt|ytxt]

nchar = 15

color bgcolor

font

Define Textfield:

Write to Textfield:

Define Object:

Print Object:

textfield new <id> <xbg> <ybg> <wbg> <hbg> <xtxt> <ytxt> <nchar> <color> <bgcolor> <font>

tf <id> “110 V / 20 mA”

object new <id> <x> <y> <wa> <hb> <color1> <color2> <color3> <type>

go <id> <state> <ms>

hb

wa[x|y]color1color2color3bgcolor

type

800 pixel

600

pixe

l

Hallo Welt!

[0|0][x|y]

[fr_x|fr_y]

[to_x|to_y]

[x|y][x|y]+

+a

abb

[x|y]w

h

h

w

color

bgcolor

print str “Hallo Welt!” <x> <y> <color> <bgcolor> <font>print lne <fr_x> <fr_y> <to_x> <to_y> <width> <color>print ellipse <x> <y> <a> <b> <color>print fellipse <x> <y> <a> <b> <color>

print frect <x> <y> <w> <h> <color>print rect <x> <y> <w> <h> <color>

[x|y]




On the VGA-Adapter 20 textfields and 20 graphical can be defined. With this predefined objects only with a short command strings or objects can be displayed. The objects definition has the parameter type which define the kind of graphical object

type graphical object 0 rectangle 1 filled rectangle 2 ellipse 3 filled ellipse 4 line

The command go need the parameter <state>. With <state> the object can be displayed in different ways:

state 0 show object colored in the background color 1 show object colored in color1 2 show object colored in color2 3 show object colored in color3 4 blinking between color1 / background color 5 blinking between color2 / background color 6 blinking between color3 / background color 7 blinking between color1 / color2 8 blinking between color1 / color3 9 blinking between color2 / color3

If in the command go the parameter <ms> is given the graphical object is displayed or is blinking for <ms> milliseconds. The blink period and the blink duty cycle can be set with config blink [per|ducy].

4.2.3.3 Command diagram

Up to four different diagrams can be defined on the VGA-Adapter. With the dgm new command the standard parameters can be set. After that further parameters can be set or changed with the command dgm change. To show up an diagram use the command dgm clear <id>. After that the diagram can be filled with data. When with the dg command only the value y is provided than the plotting starts at xstart and increases the x position by (xend-xstart)/points). To start a new plot in a different color enter the command dgm trace <id>. After reaching color3 the next trace is plotted again in color1.

800 pixel

600

pixe

l

[0|0]

P/W

time/ms0 2 4 6 8

25

50

75

0

[x|y] w

h

yheader

xheader

yend

ystart

xstart

xend

xgrids=5

ygrids=4

bgcolor

gridcolor

font

color1color2color3

F/N0

100

50

xstart

xend

ystart

yend

xgrids=2

[x|y] w

h

Define Diagram:

Print diagram:

Fill diagram with data:

Print progress bar:

dgm new <id> <x> <y> <w> <h> <xstart> <ystart> <xend> <yend>

dgm clear <id>

dg <id> [<x>] <y>

go <id> <y>




The progress bar has three data regions. Is the value <y> in the region xstart – ystart the bar is viewed in color1. Is value <y> between ystart-yend than the bar is colored in color2 and in color3 if the <y> is in the region yend – xend. There are different types of diagrams available:

type kind of diagram/plot 0 (default) diagram with lines (connected datapoints) 1 diagram with datapoints 2 diagram with lines (like 0)

10 horizontal progress bar 11 vertical progress bar




5 Update The VGAAdapter has installed an Update Manager (below VGAAdapter_UDM) to update the firmware of the device. The update is thereby processed by a Hyperterminal or by a Update Manager Software (below Software_UDM). Here we use the .Net Update Manager.

5.1 Update with the Update Manager Software 1. Connect a Standard Conradt programming adapter to the monitorport and start the Update Manager Software and configure under „settings“ the Port and the suitable baud rates. The baud rate of the Communication have to be 38400. The best baud rate for the file transfer is 57600 bit/s. When all settings are done press the connect button.




2. In the text field below the output field type a “q” and enter to test the communication and

then login. The default login is “login 2 123”. 3. If you want to update the main firmware (VGAAdapter) you can continue with point 4. If

you want to update the VGAAdapter_UDM itself you have to mark the check box at “UDM-Update”.

4. Then enter “update” and the System starts the VGAAdapter_UDM. The VGAAdapter_UDM has a baudrate of 38400 bit/s for the communication. In the message field appears some strings and ends with “Main” the request to transfer the main file or “UDM” the VGAAdapter_UDM update file.

5. Choose the firmware file. 6. Press update. Note: Press the Update button not before the String “Main” or “UDM” is

printed into the output textfield. 7. Wait until the update and the verify is ready. 8. After finishing the update the system executes a restart.

5.2 Update with the Update Manager Software over USB Connect the VGA-Adapter over an USB cable to the PC. The USB interface of the VGA-Adapter is registered in the windows device manager of your system as CDC Communication Port under ports. Select in the Update Manager software the Comport for the CDC connection and check the box USB CDC. Then press connect. The baud rates settings have no effect. Then enter “q”, “login 2 123” and “update”. Press the Disconnect button and wait till the amber led in the front is on. Press the Connect button and wait till the String “Main” or “UDM” appears in the output text field. Now you can press the Update button. When the update was successful the system restarts. If the device is not registered as CDC Communication Port in your System it helps to disconnect and connect it again.

5.3 Update with the Hyperterminal You have also the possibility to update the VGAAdapter over a Hyperterminal. 1. Open a Hyperterminal and connect it with the serial port of the VGAAdapter. 2. Under Hyperterminal properties->settings->ASCII-Configuration you have to set the line

delay to 10 ms. 3. Type “q” followed by “ENTER” to check the communication. Login at the system, default

is “login 2 123”. 4. Type “update” followed by “ENTER” to start the VGAAdapter_UDM. 5. The VGAAdapter_UDM prints the message (with a baudrate of 38400):

Ecog1X14Z update manager v1.0 Enter key or 'q'

6. Now enter the key followed by enter: For the main firmware: 110000000000000000000000000000ef For the udm firmware: 220000000000000000000000000000de

This are 28 zeroes. 7. Now the VGAAdapter_UDM asks for the baud rate to transfer the file:

Speed ? Enter “2” followed by “ENTER” to choose 57600 bit/s. Other baud rates are:

0: 9600 bits/s 1: 38400 bits/s

2: 57600 bits/s 3: 115200 bits/s 8. The VGAAdapter_UDM request now the firmware file with the message:




Please transfer file: Main for the VGAAdapter main update file. or UDM for the udm update file. Remember to change the baudrate of the terminal to the selected speed.

9. The progress is shown by asterisks which are send from the VGAAdapter_UDM. 10. After finishing the update the system executes a restart.

6 Upload of background images or fonts It is possible to load user defined fonts or background images on the VGAAdapter. The process of the uploading is similar to the update process described in the previous chapter. Instead of enter “update” type for an image upload “upload img [nr]” and for a font upload “upload font”. See also in the chapter with the command description. It is recommended to use the USB CDC interface since it is the fastest way to upload the background images. Note: Check the “USB-CDC” check box in the settings window of the update manager software.

7 Error Messages

7.1 Error messages on the interfaces. Error message Comment Error 001: Syntax error Error 002: Too few parameters Error 003: Out of range Error 004: Invalid value Error 005: Not available Error 006: Password too long Error 007: Invalid ID Error 008: Reached max. number of textfields Error 009: Textfield error Error 010: Access denied ! Error 011: Invalid key Error 012: Textfield not available Error 013: No Textfields defined Error 014: Reached max. number of graphic objects Error 015: Graphic object error Error 016: Graphic object not available Error 017: No graphic objects defined Error 021: Reset configuration not available. Defaults set.

Error 031: EEPROM read Error 032: EEPROM write Error 041: Flash read Error 042: Flash write Error 043: Verify




Error 050: Error in ow device Error 131: Command queue overflow Error 100: UART collision Error 101: UART buffer overflow Error 102: UART string too long Error 110: CRC Error 140: Key mismatch Error 180: Memory allocation error Error 190: No step response data available Error 195: Parameter can only be queried Error 197: Command not available on this port. Error 198: Error while loading image




7.2 Error messages Over the command ?error all errors occured since system start can be displayed. They are coded in the following way. nr : error_id # error_loc 001: 0023 # 0045 The first figure is the numbering of the errors, the second indicates the error identification and the last the location where the error has occurred. Error_id ID Text

0 ERROR_NONE 1 I2C_ERROR_IN_USE 2 I2C_ERROR_TOO_BIG 3 I2C_ERROR_INVALID_ADDRESS 4 I2C_ERROR_TIMEOUT 5 ADC_IN_USE_ERROR 6 ADC_ERROR_UNVALID_CHANNEL 7 SYST_PARAM_CRC_ERROR 8 SYST_PARAM_VERSION_ERROR 9 MAC_ADDRESS_ERROR 10 ONE_WIRE_ERROR 11 EXT_MEM_ERROR 12 EXT_MEM_ADDRESS_ERROR 13 EXT_MEM_OVERFLOW_ERROR 14 DIG_POTI_WRITE_ERROR 15 NO_STEP_RESPONSE_DATA_AVAILABLE 16 STEP_RESPONSE_DATA_INVALID 17 EXT_FLASH_ERROR 18 EXT_FLASH_ADDRESS_ERROR 19 ERROR_IMAGE_UPLOAD 20 MEM_MALLOC_ERROR 21 VERIFY_ERROR 22 CORRUPTED_FILE_ERROR 23 EXT_FLASH_ERASE_ERROR 24 CHECKSUM_ERROR 25 EXT_FLASH_WRITE_ERROR 26 USB_ERROR 27 ERROR 28 ERROR_FONT_UPLOAD

7.2.1.1 Error_id ID Text

0 ERROR_LOC_DEF 1 I2C_EEPROM_WRITE 2 I2C_EEPROM_READ 3 I2C_POTI_OFFSET_CHX_COMPA 4 I2C_POTI_OFFSET_CHX_COMPB 5 I2C_POTI_OFFSET_CHY_COMPA




6 I2C_POTI_OFFSET_CHY_COMPB 7 I2C_POTI_MULTIP_CHX_COMPA 8 I2C_POTI_MULTIP_CHX_COMPB 9 I2C_POTI_MULTIP_CHY_COMPA 10 I2C_POTI_MULTIP_CHY_COMPB 11 ONE_WIRE_NET_ADDRESS 12 ONE_WIRE_MAC_ADDRESS 13 I2C_POTI_OUTPUT_AMP_CHX 14 I2C_POTI_OUTPUT_AMP_CHY 15 CALIB_OUTPUT_AMP_CHX 16 CALIB_OUTPUT_AMP_CHY 17 INIT_EXT_MEM 18 CALIB_OUTPUT_DAC_CHX 19 CALIB_OUTPUT_DAC_CHY 20 IMAGE_UPLOAD 21 IMAGE_LOAD 22 IMAGE_SAVE 23 CREATE_TEXT_FIELD 24 INIT_SYSTEM 25 EXT_FONT 26 CREATE_GAPHIC_OBJECT 27 PRINT_GRAPHIC_OBJECT 28 FONT_UPLOAD 29 CREATE_DIAGRAM_OBJECT 30 PRINT_DIAGRAM_OBJECT

8 Usefull features

8.1 Read full configuration The command “?CONFIG ALL” shows the full configuration of the LanAdapter. You immediately see the possible parameters as well as the correct syntax.

9 Specifications

9.1 Electrical characteristics:

Standard Symbol Parameter Condition Min Typ Max

Unit

Vcc Supply voltage DC (interface option : Ethernet-, RS232-, Radio-interface)

5 30 V

Vcc Supply voltage DC (interface option RS485 interface)

18 25 V




Icc Power supply current Vsupply = 24V 30 mA VGA resolution 800x600 screen refresh rate 60Hz vertical refresh rate 37,8kHz

9.2 Data interface specification:

Standard Symbol Parameter Condition Min Typ Max

Unit

f(UART) Datarate in UART mode (asynchronous) 4800 115200 bit/s

10 Revision history 21.04.09 Manual created

11 Notes „Conradt Mess und Regeltechnik“ reserves the right to change the circuitry and specifications without notice at any time.

VGA-Adapter Manual v1 - CONRADT · 2011. 10. 27. · VGAAdapter-Manual, v1.4, 27/10/2011 P3/29...

Documents

Transcript of VGA-Adapter Manual v1 - CONRADT · 2011. 10. 27. · VGAAdapter-Manual, v1.4, 27/10/2011 P3/29...