command description v1.43 of software development package ... · command description v1.43 of...

Command Description V1.43

of

Software Development Package

for

ECOMIX TerminalSpeedMix

PMA.World / PMA.Net

Ecomix / Speedmix Command Description V 1.43 page 1/27 09/06/08

Data Communication Library

Contents1 Ecomix / Speedmix Software Development Package ..................................................3

1.1 Compatibility.....................................................................................................................................3

2 General Information for the Application Programmer ..................................................42.1 Command Syntax.............................................................................................................................42.2 Error Messages.................................................................................................................................42.3 Graphic display parameters..............................................................................................................52.4 Fonts.................................................................................................................................................52.5 Country specific fonts .......................................................................................................................52.6 Key- Codes.......................................................................................................................................72.7 Command Overview.........................................................................................................................8

3 High Level Commands for Ecomix and Speedmix .......................................................8

4 Medium Level Commands ............................................................................................94.1 Edit....................................................................................................................................................94.2 Select Box.......................................................................................................................................104.3 Bitmap Functions ...........................................................................................................................12

5 Low Level Commands ................................................................................................165.1 Clear-Commands............................................................................................................................165.2 Text-Commands.............................................................................................................................165.3 Unicode Text-Commands...............................................................................................................165.4 Cursor-Commands..........................................................................................................................165.5 Graphic Commands........................................................................................................................175.6 Scale Display Commands...............................................................................................................175.7 Read/Write Setup...........................................................................................................................185.8 Special Key Commands..................................................................................................................185.9 Beep Commands............................................................................................................................185.10 System Information Commands...................................................................................................195.11 Balance Information Commands..................................................................................................195.12 Flush Commands..........................................................................................................................195.13 Transparent mode commands......................................................................................................205.14 Timer Commands.........................................................................................................................205.15 Filesystem Commands.................................................................................................................205.16 OPC Server Memory Commands.................................................................................................215.17 Standard Scale Commands .........................................................................................................21

6 Version Changes.........................................................................................................226.1 Version Changes of the unified description for Ecomix and Speedmix..........................................226.2 Version Changes of Ecomix Description ........................................................................................246.3 Version Changes of Speedmix Description.....................................................................................27


1 Ecomix / Speedmix Software Development Package

1.1 CompatibilityThis documentation describes how to use the software package for Ecomix, Speedmix and PMA7501 series with graphical display (Later in this document referenced as PMA7501). It is identical for all devices unless separate noted.

This Software- Package is available for two different operation systems:

DOS- based System

Windows based System

The Driver and the DLL are „API- compatible“ to the existing Driver/DLL version for the pma7200/7500 and the Colormix. For more details see:

Windows Version:

Documents for: “Paint Mixing Windows Data Communication Library”• WindowsDriverDescription.pdf• ToolDescription.pdf

DOS and Windows Version

• ScaleCmdTable.pdf

The driver for the ECOMIX and the paint mixing scales supports the application programmer to create easily applications for the paint mixing market.In addition to the existing commands there are several new commands for the Ecomix Terminal and the Speedmix and PMA7501 scales available (Graphic- functions, select box, input box...), this new commands are described in this documentation.


2 General Information for the Application Programmer

2.1 Command SyntaxAll functions obey the following syntax: • The commands and all parameters are written down as ASCII sequence. As well the answer is

returned. All parts of a sequence (command, sub command, parameter 1..n) are separated by colons.• Floating point parameters use the decimal point (not comma). A thousand separator comma is not

allowed.• Any command sequence must be terminated by a carriage return (ASCII code 13 / 0DH)• Spaces in the command sequence are trimmed (except string parameters, which are double quoted).• String parameters, which contain special characters (e.g.: like the colon) or spaces, should be double

quoted.• The structure of the return sequence is like the command sequence. If the command has been

executed without errors, the response starts with a repetition of the command (part in front of the first colon) and if necessary followed by answer parameters, otherwise an error message starting with “EF” is returned. Spaces between command and parameters are allowed and should be trimmed before parsing the response.

• An example:Send: W;S;<CR> Send command: Get next stable weight.Receive: W;S;+100;g;<CR> Received stable weight with 100.0 grams.

2.2 Error MessagesIf an error occurred, the response does not repeat the command, but starts using an error identifying code and following syntax:

• ED;F;<no> Fatal error on communication between driver and Ecomix.• ED;I Ecomix cannot get weight values from connected scale.• EF;<Error type>;<Command>;<No> Several different errors determined by <Error type>

Possible EF;<Error Type> codes, depending on the command, which caused the error:

Type Meaning Example Result

‘-‘ Parameter missing DS EF;-;DS

‘<’ Value too small (e.g.: TP;W;-1) TP;W;-1.0 EF;<;TP;2

‘>’ Value too big (e.g.:) TP;W;10000 EF;>;TP;2

‘B’ Function is blocked T;S EF;B;T (If a preset tare is set)

‘C’ Communication error if using the Transparent Mode (e.g.: no response)

DT;TM;R EF;C;DT;<Errno>

‘P’ Protocol error (Using Windows DLL and protocol file functions)

PO;FILE EF;P;PO (if FILE doesn't exist)

‘T’ Timeout error T;S;3 EF;T;T (after 3 seconds instability)

‘U’ Unknown command AB;XDT;SB;X

EF;U;ABEF;U;DT;77

'W' Parameter error (EF;W;<Cmd>;<No of wrong parameter)

T;XT;S;X

EF;W;T;1 (1st parameter wrong)EF;W;T;2 (2nd parameter wrong)

All commands starting with ‘DT’ show a special behaviour: On all errors you get an error response like ‘EF;U;<Command>;<ErrNo>. The different possible errors can be distinguished by the error number <ErrNo> at the end:

List of possible DT command error codes:• 77 Unknown DT function• 78 Unknown function using Transparent Mode (DT;TM;…)• 100..109, 111 Different protocol errors (between driver and Ecomix)• 110 DOS driver communication error• 4096 Win DLL communication error


2.3 Graphic display parametersThe Ecomix has a full graphic oriented display with 320 * 240 pixels; the Speedmix contains an identical display but 90° rotated. The PMA graphic display has the size of 192x64 pixels. So all x and y positions described in this documentation have to be in the following range:

Axis Ecomix Speedmix PMA7501x 0 .. 319 0 .. 239 0 .. 191y 0 .. 239 0 .. 319 0 .. 63

2.4 FontsThe Ecomix / Speedmix / PMA7501 internal software supports different sized fonts, which can be selected by the application programmer via the font- number. It is possible to switch between different fonts on one screen.The following table shows the different fonts with their character size and the maximum number of characters and lines for the selected font. Remark: Only the smaller fonts are full implemented. The greater ones only support ISO646-us (Character codes 20H to 7EH).

Font No.

Fonts([n]: PMA7501)

Ecomixline length

Ecomixlines

Speedmixline length

Speedmixlines

PMA7501line length

PMA7501lines

Full implemented fonts

0 9*7[6] (7*5) 45 26 34 35 32 7 *2 25*20(21*13) 16 9 12 123 32*21(28*14) 15 7 11 104 23*19(21*15) 16 10 10 166 16*12(14*10) 26 15 20 20 16 4 *24 13*8 40 18 30 24 24 4 *

For example: All characters of Font 0 (Ecomix/Speedmix) PMA7501

2.5 Country specific fonts The Ecomix / Speedmix internal software supports country specific download fonts, which can substitute the built in standard fonts. Only full implemented fonts (0, 6, 24) are affected. The PMA7501 doesn't support font reloading.

The number of the actual loaded font file is displayed during Ecomix / Speedmix startup procedure and in the SETUP-INFO field.

Available font files

Number Type Description00 Standard Superset of ISO646-us, s.a.11 ISO8859-1 Latin 1, Europe (west)12 ISO8859-2 Latin 2, Europe (east)14 ISO8859-4 Latin 4, Europe (north)


15 ISO8859-5 Cyrillic19 ISO8859-9 Latin 5, Turkish1a CP1250 Windows-EE standard font (Europe, east)1b CP1251 Windows-Cyrillic standard font (Russian)1c CP1253 Windows-Greek standard font (Greece)1d CP1254 Windows-Turkish standard font (Turkey)1e CP1257 Windows-Baltic standard font (Baltic states)

Remark: The font files are – exactly like the firmware – different for Ecomix and Speedmix! It is not allowed to swap them.


2.6 Key- CodesThe scrolling wheel of the Speedmix sends the same key codes like the Ecomix cursor -up and -down keys and the usage is identical. Every time when Ecomix key usage is described in this documentation, the usage of the Speedmix scroll wheel is similar and not mentioned specially.

The PMA7501 key codes are compatible to the PMA7500 codes and described in the document ScaleCommandTable.pdf.

2.6.1 Ecomix

KEY Code Shift Key Code Shift Key Code Chift Key Code ShiftESC 27 27 TAB 177 177 CTRL SHIFTLF1 128 182 Q 81 113 A 65 97 Z 90 122F2 129 183 W 87 119 S 83 115 X 88 120F3 130 184 E 69 101 D 68 100 C 67 99F4 131 185 R 82 114 F 70 102 V 86 118F5 132 186 T 84 116 G 71 103 SPACE 32F6 133 187 Y 89 121 H 72 104F7 160 188 U 85 117 J 74 106F8 161 189 I 73 105 K 75 107 B 66 98F9 162 190 O 79 111 L 76 108 N 78 110F10 163 191 P 80 112 ALT 179 M 77 109

Key Code Shift Key Code Shift Key Code Shift ScaleKey

Code

0 48 41 -/_ 45 95 UP 166 166 Tara 1921 49 63 =/+ 61 43 <- 167 167 F1 1932 50 64 <- 174 174 -> 169 169 -> <- 1953 51 35 */: 42 58 DOWN 168 168 REC 1964 52 60 ./’ 46 39 ENTER 10 10 MEM 1975 53 62 INSERT 176 176 UP 1986 54 59 HOME 170 170 Down 1997 55 38 PAGE

UP173 173

8 56 47 DEL 175 1759 57 40 END 171 171

PAGE DN

172 172

2.6.2 Speedmix

KEY Code Code HexScroll-UP 166 0xA6Scroll-DOWN 168 0xA8ENTER 10 0x0AC (BS) 174 0xAEESC 27 0x1BLong-ENTER 163 0xA3Long-C (DEL) 175 0xAFLong-ESC 162 0xA2

Long-Key codes are returned if key was pressed and hold for more than about ½ second.


2.7 Command Overview

The Command set is divided into three levels:

HIGH- LEVEL- COMMANDS ( e.g. Ecomix Recipe Module )MEDIUM- LEVEL- COMMANDS ( e.g. Select Box, Edit ...)LOW- LEVEL- COMMANDS ( e.g. Text, Cursor ..)

3 High Level Commands for Ecomix and Speedmix

The Ecomix recipe module ERM supports the application programmer by a module which handles the complete weigh procedure of a recipe especially in the paint mixing market. The ERM- Module also handles job- queue-features with up to 20 different recipes.

The ERM module can be configured in different ways, therefore it is widely adaptable to an application. It gives the user a great flexibility without the knowledge of the whole Data- Communication- Library.

See separate description (“The Ecomix Recipe Module“)


ANSI

SBI/BPI

ECOMIX SARTOCOM INTERPRETER Software Customer

Sartorius Scale Command Set or Transparent Mode RS232

RS232/RS422

Scale

Display Keyboard

Software Sartorius

Software available

ECOMIX WEIGHING APPLICATION.

WINDOWS/DOS Paint Mixing Application

DATABASE

Customer PC

ECOMIX

ECOMIX- DRV ECOMIX- DLL

XBPI

XBPI

ECOMIX SARTOCOM COMMANDS

ANSI LOW-LEVEL- COMMANDS

HIGH-LEVEL- COMMANDS MEDIUM-LEVEL- COMMANDS

4 Medium Level Commands

4.1 EditUsing the EDIT- command, the application programmer is able to create and display a „Edit Box“ with or without a pre selected text. All the handling of the Edit- Box is done by the driver software, the user has only to wait for the result string.

Insertion of characters on the Speedmix is managed by either opening a additional box (the overlapped area is restored after closing) or by editing the character under the cursor directly in the edit field, where letters can be chosen using the scrolling wheel. A short ENTER will accept the chosen character, a long ENTER will confirm the whole string. The PMA7501 supports only the editing in the edit line.

The command ‘ED’ puts the additional box automatically whereas the command ‘EP’ allows manually positioning.

There is only one „Edit- Box“ available at a time.

4.1.1 Overview Edit Command

Display Terminal EDit DT;ED;x;y;len;Default;EdMode;InpMode;Frame;Font;Timeout

x = Position x of Edit Box y = Position y of Edit Box len = length of Edit Box (number of visible characters,

must be >=2)Default =default string Edmode :1=Overwrite,0=Insert InpMode:1=Numbers (0..9+-.)2=Text(A-Z,a-z,)4=special Character (SPACE*#?...)any combination (1+2+4)=7 = all characters and numbersFrame : 0 = No Frame / 1 = Frame Font: selected Font Timeout : (ms) / ;=no timeout valid editor keys : BS, CURSOR_LEFT, CURSOR_RIGHT, POS1,END,DELvalid confirmation keys:ENTER, TAB, ESCall other keys (application specified)Return Valuekey;stringkey: 10 = ENTER, 177 = TAB, 27 = ESCNote: The maximum buffer of the Edit Box is 80 characters.If the number of characters is bigger than the length of the box, the characters are shifted left automaticly

Display Terminal EP DT;EP;x; y; len; Default; EdMode;InpMode; Frame; Font;xs;ys ;Timeout

Special for Speedmix: Same as ‘ED’ +xs = Position x of ABC-Select Box ys = Position y of ABC-Select Box

4.1.2 Example

result=EcoCommand(„DT;ED;10;5;10;Rover;1;2;1;0;0“);

with different font: result=EcoCommand(„ DT;ED;10;50;10;0.5;0;7;1;3;0 “);

ROVER_

Alphanumeric Editbox

Manufacturer

Numeric Editbox

0.5_ Total amount:


4.2 Select BoxThe select box presents a list of text fields with a preselected item to the user. The number of the text fields is limited by the screen size and the selected font. (e.g. 10 text fields in font 4).

The user can select one of the items with the cursor-keys (Cursor Up, Cursor Down). Any other key stops the select box activity and gives back the last key code and the selected item number. This also happens if the user presses the Cursor-Up-Key in the top line or the Cursor-Down-Key in the bottom line. In this case the application programmer can use the „Insert Top“ or „Insert Bottom“ commands to display additional lines on the top or the bottom of the Select-Box, which will scroll all other items automatically.The „Redraw“ can be used to return to the same box again.

It is possible to change the number of lines of the header and each item (default: one) just as to change the behaviour on key pressings (Leave on each key press or -by default- only on confirmation keys).

Keys to change selection (select box remains active): CURSOR_UP, CURSOR_DOWN (at no end position)

Confirmation keys (select box function is leaved): ENTER, confirmation with actual selected item (1..n) CURSOR_UP, only if first item was selected before, confirmation with item '0' CURSOR_DOWN, only if last item was selected before, confirmation with item 'n+1' all other Keys: confirmation with actual selected item 'n'

There is only one Select-Box available at a time. It will be displayed using the start command DT;SB. Any following command will work on this by inverting areas or copying areas to another place. If any other output to the display area of the actual select box is done it won't be updated automatically (If you want to do that anyway, e.g. to write another information temporarily to that place, you have to save/restore the select boxes display area).

4.2.1 Overview Select Box CommandsSelect Box begin

Display Terminal Select Box DT;SB;x;y;w;h;Frame;Font;z;Timeout;s;sn

x = Position x of select box (include header) y = Position y of select box (include header) w = width (Pixel) h = height (Pixel) Frame =(1=Frame / 0= no Frame) Font = selected Font z = selected item Timeout = ms / ;; = no timeout s = header (;; means no header) sn = String (s1;s2;s3;..sn)

Return Value : key;z

SelectBox InsertTopDisplay Terminal Select Box;Top DT;SB;T;s;Timeout s = String (inserted string first line)

Timeout = ms / ;= no timeout


SelectBox InsertBottomDisplay Terminal Select Box;

BottomDT;SB;B;s;Timeout s = String (inserted string last line)

Timeout = ms / ; = no timeout


SelectBox RedrawDisplay Terminal Select Box;

RedrawDT;SB;R;z;Timeout z = selected Item

Timeout = ms / ; = no timeout


SelectBox Mode settingsDisplay Terminal Select Box;

ModeDT;SB;M;ItemLines;HeaderLines;KeyMode

ItemLines:Lines per item (1..3)Header Lines (1..3)


KeyMode: 0: Default, 1: Leave at each key press

Example Select Box

Draw Select Box:result=EcoCommand („DT;SB;10;20;220;140;1;3;7;0

;CODE YEAR MANUFACT. COLOUR;SAR1 80- BMW SARTORIUS RED;SAR1 85- BMW SARTORIUS ORANGE;SAR2 89- VW SARTORIUS GRAY;SAR2 92- VW SARTORIUS WHITE;SAR3 80- RENAULT SARTORIUS GOLD;SAR4 94- NISSAN SARTORIUS BLACK

;SAR11 97- TOYOTA SARTORIUS LIME“); Insert new Bottom Line:

result=EcoCommand („DT;SB;B;SAR12 98- TOYOTA SARTORIUS RED“);


CODE YEAR MANUFACT. COLOUR

SAR11 97- TOYOTA SARTORIUS LIME SAR4 94- NISSAN SARTORIUS BLACK SAR3 80- RENAULT SARTORIUS GOLD SAR2 92- VW SARTORIUS WHITE SAR2 89- VW SARTORIUS GRAY SAR1 85- BMW SARTORIUS ORANGE SAR1 80- BMW SARTORIUS RED

y=20 w=220

h=140

x=10

SAR12 98- TOYOTA SARTORIUS RED SAR11 97- TOYOTA SARTORIUS LIME SAR4 94- NISSAN SARTORIUS BLACK SAR3 80- RENAULT SARTORIUS GOLD SAR2 92- VW SARTORIUS WHITE SAR2 89- VW SARTORIUS GRAY SAR1 85- BMW SARTORIUS ORANGE

CODE YEAR MANUFACT. COLOUR

4.3 Bitmap Functions

The Bitmap- Function allows the Application Programmer to display graphic information (Icons, Logos etc.) on the Ecomix display. The Bitmap- Function use standard b/w bitmap files (*.bmp) created by any graphic- or scanner software (maximal resolution is the screen size of the Ecomix (320*240 pixel) the Speedmix (240x320 pixel) or the PMA7501 (192x64 pixel), without gray scaling).

Speedmix usage Attention : The bitmaps have to be rotated by 90° right before displaying it on the SpeedMix. (for use with the first Speedmix prototypes bitmaps have to be rotated 90° left!)E.g:

This rotated picture… will be displayed in that way.

To display the bitmaps very fast on the screen, without transmission from the host to the Ecomix , it is possible to store bitmaps in the Ecomix Terminal memory (RAM). There are 70 KByte of memory in the Ecomix available. The application can store bitmaps during start up to the Ecomix under a unique name and can display this bitmaps during the application program at any timeThe Bitmap- Function is a little bit different under DOS and Windows, because the DOS- Driver cannot open a bitmap- file by itself.

4.3.1 Overview (Windows Bitmap Functions)Display BitMap direct on the screen

Display Terminal Bitmap File DT;BF;x;y;mode;filename x = Bitmap Start Position x y = Bitmap Start Position y mode = 0 normal / 1 = inverse filename (*.bmp) standard bitmap file (no greyscales)

Store BitMap into ECOMIX- Memory

Display Terminal Bitmap Store DT;BS;filename;name filename: (*.bmp) standard bitmap file (no greyscales)name:Name of the internally stored file(8 characters / case sensitive)

Display BitMap on the screen

Display Terminal Bitmap Takeout DT;BT;x;y,mode;name mode = 0 normal / 1 = inverse name:Name of the internally stored file(8 characters / case sensitive)x = Bitmap Start Position x y = Bitmap Start Position y

Bitmap Read from screen to Memory

Display Terminal Bitmap Read DT;BR;x;y;w;h;name name:Name of the internally stored file(8 characters / case sensitive)x = Bitmap Start Position x y = Bitmap Start Position y w = Width of bitmap h = Height of bitmap

Clear stored BitMap

Display Terminal Bitmap Clear DT;BC;name name:Name of the internally stored file(8 characters / case sensitive)


4.3.2 Example (Windows) // during start up (store default bitmaps):result=EcoCommand(„DT;BS;PB.BMP;PBSYM“);result=EcoCommand(„DT;BS;INFO.BMP;INFOSYM“);:result=EcoCommand(„DT;BS;TEL.BMP;TELSYM“);:result=EcoCommand(„DT;BS;CAR.BMP;CARSYM“);

//during application (take out stored bitmaps)

if(.....) result=EcoCommand(„DT;BT;1;100;0;PBSYM“); if(.....) result=EcoCommand(„DT;BT;50;100;0;INFOSYM“); if(.....) result=EcoCommand(„DT;BT;100;100;0;TELSYM“);


4.3.3 Overview (DOS Bitmap Functions)

Display BitMap direct on the screen

Display Terminal Bitmap Paint DT;BP;x;y x = Bitmap Start position x y = Bitmap Start position y Return Value : FileOffsetlen (requested bytes)for following DT;BD Command

Bitmap Data DT;BD;data data : binary data as requested by • DT;BP command• DT;BM command • previous DT;BD commandReturn Value : FileOffsetlen (requested bytes)for following DT;BD Commandif len is 0 the BitMap file operation is terminated

Store BitMap into Ecomix or Speedmix memory

Display Terminal Bitmap Memorize DT;BM;name name:Name of the internally stored file(8 characters / case sensitive)Return Value : FileOffsetlen (requested bytes)for following DT;BD Command

Bitmap Data DT;BD;data data : binary data as requested by • DT;BP command• DT;BM command • previous DT;BD commandReturn Value : FileOffsetlen (requested bytes)for following DT;BD Commandif len is 0 the BitMap file operation is terminated

Display stored BitMap on the screen

Display Terminal Bitmap Takeout DT;BT;x;y,mode;name name:Name of the internally stored file(8 characters / case sensitive)x = Bitmap Start Position x y = Bitmap Start Position y mode= 0 normal / 1 = inverse

Bitmap Read from screen to Memory

Display Terminal Bitmap Read DT;BR;x;y;w;h;name name:Name of the internally stored file(8 characters / case sensitive)x = Bitmap Start Position x y = Bitmap Start Position y w = Width of bitmap h = Height of bitmap

Clear stored BitMap

Display Terminal Bitmap Clear DT;BC;name name:Name of the internally stored file(8 characters / case sensitive)


4.3.4 Full Example Program (DOS)

// Tested with Borland-C 3.1#include <conio.h>#include <stdio.h>#include <io.h>#include <fcntl.h>#include <stdlib.h>#include <dos.h>#include <string.h>#define BUFLEN 0x100#define NO_ERROR 0#define WRITE_ERROR 1#define READ_ERROR 2#define NO_TIMEOUT 0xffff#define FALSE (1==0)#define TRUE (1==1)#define DD_NAME "$$ECOMIX"#define Xpos argv[2]#define Ypos argv[3]typedef unsigned int UInt16_T;typedef unsigned char UInt8_T;int DDHandle;int BitmapHandle;void exitfunc (void);int EcoCommand (char* SendBuf, char*

ReceiveBuf, UInt16_T Timeout);/*----------------------------------------- main()-----------------------------------------*/void main (int argc, char** argv){char OutBuff[BUFLEN+1];char InBuff[BUFLEN+1];int err, n, ok, DataLen=1, DataOffs;char *InBuff_ptr, *StoreName = NULL;int BmpStore = FALSE;printf ("\nECOTEST <BMP File Name> <Xpos>

<Ypos> [/sStore Name]\n");if (! (argc == 4 || ( argc == 5 && strncmp (argv[4], "/s", 2) == 0) ) ){ printf ("\nError: Arguments not ok\n"); exit (1);}if (argc == 5){ StoreName = argv[4]+2; BmpStore = TRUE;}if ((DDHandle = open (DD_NAME, O_BINARY |

O_RDWR)) < 0){ printf ("\nError: OPEN ECODRV %s\n",

DD_NAME); exit (1);}if ((BitmapHandle = open (argv[1], O_BINARY |

O_RDONLY)) < 0){ printf ("\nError: OPEN Bitmap File %s\n",

argv[1]); exit (1);}// close stream on leaving programatexit (exitfunc); /* Start storing of File to EcoMix */if (BmpStore == FALSE) sprintf (OutBuff, "DT;BP;%s;%s\r\n",

Xpos, Ypos);else sprintf (OutBuff, "DT;BM;%s\r\n",

StoreName);EcoCommand (OutBuff, InBuff, 500);/* Send BitMap-Data to ExoMix in a Loop */

do { /* Skip Response Header */ InBuff_ptr=InBuff; while (*(InBuff_ptr++) != ';') ; /* do nothing */ /* Get Required data offset */ DataOffs = atoi(InBuff_ptr); /* Skip to Data Length */ while (*(InBuff_ptr++) != ';') ; /* Do nothing */ /* Get Required data length */ DataLen = atoi(InBuff_ptr); if (DataLen > 0) { /* Set Header for DT;BD-Command */ strcpy (OutBuff, "DT;BD;"); /* Set file pointer to required

position DataOffs */ lseek (BitmapHandle, DataOffs,

SEEK_SET); /* Read the required amount DataLen

of BitMap data */ read (BitmapHandle, OutBuff+6,

DataLen); /* Send Command to EcoMix */ ok = EcoCommand (OutBuff, InBuff,

500); }}while (ok == NO_ERROR && DataLen > 0);// Show picture if storedif (BmpStore != FALSE){ sprintf (OutBuff, "DT;BT;%s;%s;0;%s\r\n",

Xpos, Ypos, StoreName); EcoCommand (OutBuff, InBuff, 500);}exit (0);}/*-----------------------------------------EcoCommand sends a command to the DOS driverand waits for response-----------------------------------------*/int EcoCommand ( // O: Error (0: OK) char* SendBuf, // I: send buffer char* ReceiveBuf,// I: receive buffer UInt16_T Timeout)// I: Timeout in msec or

NO_TIMEOUT{int n, err = NO_ERROR;if ( (n = write (DDHandle, SendBuf, strlen

(SendBuf))) == -1 ) err = WRITE_ERROR;n=0;while ( n == 0 && // received nothing err == NO_ERROR && // receive error Timeout != 0) // control timeout{ if ( (n = read (DDHandle, ReceiveBuf,

BUFLEN)) == -1) err = READ_ERROR;// Timeout handling while nothing received if (n == 0) { delay (1); if (Timeout != NO_TIMEOUT) Timeout--; } else if (n > 0) // there is a response // terminate received string ReceiveBuf[n] = 0;}return err;}/*----------------------------------------- Called on program exit-----------------------------------------*/void exitfunc (void){close (DDHandle);close (BitmapHandle);}


5 Low Level Commands

5.1 Clear-Commands

Display Terminal Clear DT;C Clears whole display

Area Draw See below, graphic commands

Clears area

5.2 Text-Commands

DisplayTerminal Text Write DT;TW;x;y;s;Font x = Position x y = Position y s = string Font = Font number

DisplayTerminal Text Clear DT;TC;x;y;len;Font x = Position x y = Position y len = length (characters) Font = Font number

DisplayTerminal Text Invert DT;TI;x;y;Ien;Font x = Position x y = Position y len = length (characters) Font = Font number

5.3 Unicode Text-Commands

This functions are only available for Windows driver:

Display Terminal;Unicode Text

Text Write DT;UT;TW;x;y;Font;s x = Position xy = Position yFont = Font numbers = string (must be terminated with two zero bytes)

Text Clear DT;UT;TC;x;y;len;Font x = Position x y = Position y len = length (characters) Font = Font number

Text Invert DT;UT;TI;x;y;Ien;Font x = Position x y = Position y len = length (characters) Font = Font number

5.4 Cursor-Commands

Display Terminal Cursor Set DT;CS;x;y;m;Font x = Position x y = Position y m = mode (1=half, 2=full, 3=line) Font = Font number

Cursor Hide DT;CH

(*) Default setting = Cursor Hide


5.5 Graphic Commands

Display Terminal Line Vertical DT;LV;x;y;h x = Start Position x y = Start Position y h = height (Pixel)

Line Horizontal DT;LH;x;y;l x = Start Position x y = Start Position y l = length (Pixel)

BoX DT;BX;x;y;l;h;mode x = Start Position x y = Start Position y l = length h =height mode:0=single line1=double line

Area Draw DT;AD;x;y;w;h;char x = Start Position x y = Start Position y w = width h =height char: written character (eg: 0 deletes area, 255 fills area black)

Area Copy DT;AC;x;y;w;h;xn,yn x = Start Position x y = Start Position y w = width h =height x = New start Position x y = New start Position y

5.6 Scale Display Commands

Function Subfunction Example DescriptionDisplay Terminal Display Weight ;

ActivateDT;DW;A;y[;Frame]

y = Start Position y (0..220) frame = 1: Frame on, 0: Frame off

Display Terminal Display Weight; Off DT;DW;O

Display Graphic Write DG;W;o;s;[x;y;w;l;t;u;log]

activate the bargraph-weight-display with arbitrary parameters:o = weight Offset of bargraph zero points = bar graph Sensivity in unit per pixelx = x-Position of bar graph (1-296)y = y-Position of bar graph (1-238)w = Length of bar graph in pixels (1-318)l = Position of Lower Limit mark (pixels)t = Position of Target mark (pixels)u = Position of Upper Limit mark (pixels)log = Logarithmic Flag: 1 = Logarithmic bar graph 0 = Linear bar graph

Start DG;S;[x;y;w] activate the bargraph as a procentual weighing range display:x = x-Position of bar graph (1-296)y = y-Position of bar graph (1-238)w = Length of bar graph in pixels (1-318)

Off DG;O switch the bargraph off


5.7 Read/Write Setup

System Setup Read; SS;R;MenuPoint MenuPoint :L=LanguageC=ContrastT=Type of ScaleD=Display ON/OFFOnly Ecomix: T=Type of ScaleOutput:MenuPoint Setting (see table) and Bitmask

Write SS;W;MenuPoint;Setting MenuPoints see SS;R.Output:MenuPoint Setting (see table)

Save SS;S Save Data into EEPROM

Menu Reset SS;M Read old Data from EEPROM Undo Menu Settings

Default SS;D Save Factory Setup into EEPROM

Englisch MenuPointSetting Bit MaskSETUP L ANGUAGE Deutsch 1 2038English 2 2038Français 4 2038Italiano 5 2038Espanol 6 2038Nederlands 7 2038Português 8 2038Polski 9 2038Türkçe 10 2038SETUP C ONTRAST ******** 1 510******* 2 510****** 3 510***** 4 510**** 5 510*** 6 510** 7 510* 8 510SETUP WEIGH. D ISP. OFF 0 3ON 1 3Only EcomixSETUP BALANCE ( T ype of Scale) PMA family 1 250Sartorius Balance (SBI Mode) 3 250Sartorius Balance (XBPI Mode) 4 250PZ/PS7001 5 250Transparent Mode 6 250OFF 7 250

5.8 Special Key Commandsbeep is default onkeyboard- buffer is 15 characters long

Display Terminal Keyboard Get DT;KG;timeout Ouput: keycode

Keyboard Beep DT;KB;option option:1=Key Beep On0=Key Beep Off

Keyboard Flush DT;KF clear keyboard buffer

5.9 Beep Commands

Display Terminal Beep DT;B;option option: 1-254 (Beep intervals)


5.10 System Information Commands

SystemInformation Version SI;V Gets the firmware version information of the Ecomix: “0140xx”. The first part is fixed for Ecomix, the xx part contains the suffix of the version number (e.g. “03” at version V1.03)

Font Info SI;F Gets the country specific font version information of the Ecomix: “xx”, which contains the font version number (00 for standard font, font numbers see Ch. 2.5 )

Software Rel. SI;S Get software release of used driver

sPeed SI;P Ecomix speed information function, returns: - SI;10: Ecomix normal- SI;20: Ecomix DoubleSpeed

5.11 Balance Information Commands

BalanceInformation On / Off BI;O Get scale status: It returns BI;ON if scale is properly working, otherwise BI;OFF

5.12 Flush Commands

Display Terminal Flush Begin DT;FB Begin of command buffer mode Flush End DT;FE End of command buffer mode Flush Now DT;FN flush command buffer Now (*)

The Flush command is very useful to accelerate the screen construction on the Ecomix or Speedmix. Sometimes it could be better to transfer not every command separately ( e.g. characters at different screen positions, lines, boxes...), because every command has its own protocol overhead.After activating the Flush feature, all commands are collected first and sent to the Ecomix in a bigger packet. This packet is send automatically after :

• Keyboard request (Keyboard Get command, Edit command, Select Box command....)• Flush buffer is full• Sending the DT;FN flush command

The screen construction works faster, unnecessary Protocol overhead is avoided.In the Ecomix firmware version V1.10 and newer the flush mode has been improved. The Ecomix is collecting the command by itself and is able to update the screen in one step.

Please note:• After power-on the Flush feature is not active. The application programmer has to activate this

feature by sending the DT;FB command.• It is recommended to take a deeper look at the error handling, especially if a software which had been

developed without flush mode is changed to flush mode to increase the speed. The screen output commands are sent and executed not immediately (but collected by the driver and the Ecomix) which will result in less or none error checking during drivers command execution. Any errors will occur later, when the collected commands are executed by the Ecomix, and this could cause an omitting of the following commands.


5.13 Transparent mode commandsOnly Ecomix: The „Transparent Mode Feature“ allows the application programmer the implementation of weighing platforms with various communication protocols. To use the Transparent Mode it is necessary to enter the Setup and change the Scale Settings. In this mode the scale display is not supported.

Display Terminal

Transparent Mode Transmit DT;TM;T;s s =string

Receive DT;TM;R;Timeout Timeout (in milliseconds)Return: Length and response string

Setup DT;TM;S;BAUDRATE;STOPBIT;WORDLEN;PARITY;HANDSHAKE;XON;XOFF;MODE;OPTION

BAUDRATE: 110, 150, 300, 600, 1200, 2400, 4800, 9600, 19200 STOPBIT: 1 or 2 Stopbits WORDLEN: 7 or 8 Bits PARITY: ‘N’one, ‘E’ven, ‘O’dd, ‘M’ark, ‘S’pace HANDSHAKEKein: 0Hardware: 5Software: 10Beide: 15XON:cc = XON characterXOFF:cc = XOFF characterMODE:FREERUN: 0 ,ENDCHAR: 1,LENGTH: 3OPTION: If mode = FREERUN: no Optionif mode = ENDCHAR: cc= character cc is block-endif mode = LENGHT: nn= l..250 : block length

ClearTransmitBuffer

DT;TM;CT

ClearReceiveBuffer

DT;TM;CR

Example (Connection to a Sartorius Industrial Load Cell in SBI Mode):

Command ExplanationInitialize the communication protocol for the weighing platform.

DT;TM;S;9600;1;8;N;0;;;1;10 No HandshakeEnd character of String is LF

Clear Transmit Buffer DT;TM;CTClear Receive Buffer DT;TM;CRTransmit request command DT;TM;T;“< ESC> P“ Transmit the „Print“ commandRead Receive Buffer DT;TM;R;200 Receives the answer: - 1.234 g <CR< LF

5.14 Timer Commands

System Timer Write ST;W;x Sets system timer value, resolution unit: msec

Read ST;R Gets system timer value in msec

5.15 Filesystem Commands

Display Terminal FileSystem Info DT;FS;I Gets information about file system, returns <Max memory size>; <Used memory size>; <Max file entries>; <Used file entries>

Clear All DT;FS;A Clears all files


5.16 OPC Server Memory Commands

Memory Function Write String MF;W;S;n Write string number 'n' (1..10)

Write Float MF;W;F;n Write float value number 'n' (1..10)

Read String MF;R;S;n Recall string number 'n' (1..10)

Read Float MF;R;F;n Recall float value number 'n' (1..10)

5.17 Standard Scale Commands

For all information please refer the document: ScaleCmdTable.pdf

Remark: In SBI mode most of the scale commands are not available; only the main functions:• W;...• T;S• TP;W; TP;R, TP;T


6 Version ChangesThe descriptions of Ecomix and Speedmix commands have been unified with version V1.39. The older version changes are added here to have the complete overview.

6.1 Version Changes of the unified description for Ecomix and Speedmix

6.1.1 Version 1.43Few changes in this description.Software versions like described in document version 1.42

6.1.2 Version 1.42New DOS-Driver / Win DLL / Ecomix Firmware / Speedmix Firmware / PMA 7501 Firmware

Version / Date of this paper V1.42 / 09.01.2007Recommended VersionsDriver Version DOS Release 1.12Driver Version WIN Release R51Firmware Version Ecomix Version 1.10: ECO10n.abs / Date 24.01.06) ID = 01-40-10 Firmware Version Speedmix Version 1.03: PMC103.abs / Date 27.01.03) ID = 01-44-03 Firmware Version PMA7501 Version 23.04: PMA_2304.abs / Date 29.11.06) ID = 01-23-04 Changes in Dos Driver / Win DLL • Add functions for Unicode text outputBug Fixes in Dos Driver / Win DLL • %

6.1.3 Version 1.41New DOS-Driver / Win DLL / Ecomix Firmware / Speedmix Firmware

Version / Date of this paper V1.41 / 16.02.2006Recommended VersionsDriver Version DOS Release 1.10Driver Version WIN Release r43Firmware Version Ecomix Version 1.10: ECO10n.abs / Date 24.01.06) ID = 01-40-10 Firmware Version Speedmix Version 1.03: PMC103.abs / Date 27.01.03) ID = 01-44-03 Changes in Dos Driver / Win DLL • Add functions for OPC driver:

- MF;W;[SF];n: Store string or float variable- MF;R;[SF];n: Recall string or float variable

• Add Ecomix functions:- SI;P: Ecomix speed information function - Flush mode extension (Ecomix is accumulating commands)- BI;O: scale status (On/Off info)

Bug Fixes in Dos Driver / Win DLL • %


Version / Date of this paper V1.40 / 13.08.2004Recommended VersionsDriver Version DOS Release 1.10Driver Version WIN Release r42 + srvindll V4,0,1,2Firmware Version Ecomix Version 1.09: ECO09n.abs / Date 20.04.04) ID = 01-40-09 Firmware Version Speedmix Version 1.03: PMC103.abs / Date 27.01.03) ID = 01-44-03 Changes in Dos Driver / Win DLL • More flexibility in select box: it can have more than one line

per item and it is possible to leave it with each key press. (Requirement from UC)

• DT;SB;M New function to change settings of the select boxBug Fixes in Dos Driver / Win DLL • %



Version / Date of this paper V1.39 / 30.04.2004Recommended VersionsDriver Version DOS Release 1.10Driver Version WIN Release r42Firmware Version Ecomix Version 1.09: ECO09n.abs / Date 20.04.04) ID = 01-40-09 Firmware Version Speedmix Version 1.03: PMC103.abs / Date 27.01.03) ID = 01-44-03 Changes in Dos Driver / Win DLL • TP;T is made more tolerant, if actual weight is below last

tare.Bug Fixes in Dos Driver / Win DLL • Srvind20.dll: Answer “SI;N;” was always “0000000000”


6.2 Version Changes of Ecomix Description

6.2.1 Version 1.38New DOS-Driver / Win DLL

Version / Date of this paper V1.38 / 18.09.2001Recommended Driver Version DOS Release 1.07Recommended Driver Version WIN Release 3.5.0.6Recommended Firmware Version Version 1.06

ECO06n.abs / Date 17.04.01) ID = 01-40-06 Changes in Dos Driver / Win DLL • New Command DT;EP: Should only used by PMC7500

• New commands: „DT;FS;I“ & „DT;FS;A“ File System Information & File System delete All files

Bug Fixes in Dos Driver / Win DLL ‘Missing backslash’ problem in text write command (DT;TW): In quoted strings now ‘\’ can also be sent.

6.2.2 Version 1.37New Firmware V1.06

Version / Date of this paper V1.37 / 18.04.2001Recommended Driver Version DOS Release 1.06Recommended Driver Version WIN Release 3.3.0.14Recommended Firmware Version Version 1.06

ECO06n.abs / Date 17.04.01) ID = 01-40-06 Changes in FirmwareBug Fixes Firmware BASF-Glasurit screen refresh error fixedBug Fixes Dos Driver Error on command SI;F fixed.Bug Fixes Win DLL Error on command SI;F fixed.


Version / Date of this paper V1.36 / 05.02.2001Recommended Driver Version DOS Release 1.05Recommended Driver Version WIN Release >3.201Recommended Firmware Version Version 1.05

ECO05n.abs / Date 23.01.01) ID = 01-40-05 Changes in Firmware Features for reloadable fonts added (security on download,

setup info extended, support of auto-download)Bug Fixes Firmware Mettler scale tare error fixedBug Fixes Dos Driver Error on commands T;S and W;S fixed: Timeout now is infinite

(and not zero)


Version / Date of this paper V1.35 / 18.10.00Recommended Driver Version DOS Release 1.04Recommended Driver Version WIN Release 3.2Recommended Firmware Version Version 1.04

Old keyboard: (ECO04o.abs / Date 17.10.00) ID = 01-40-04 New keyboard: (ECO04n.abs / Date 17.10.00) ID = 01-40-04

Changes in Firmware Mettler scales PZ7001-F and PS7001-FFonts are reloadableFonts (No. 0, 6, 24) standardized (some characters added)


Default scale setting changed: Now PMAxxBug Fixes Dos Driver TP;T error fixed (problem examined by Yada)Bug Fixes Firmware Character ‘ß’ now has the correct Ascii value (E1H).

Read of software version is working now.Some sources of the „Nullptr“ error removedRange number output of multi range scales is ok now.Keyboard test corrections done

6.2.5 Version 1.34



Changes Both drivers support reading of the firmware version (SI;V)Bug Fixes The 16 bit version of the windows driver now can be run in

several instances V1.341 Missing description of DT;AC and TP;R added




Changes Firmware supports:scale key lock and release command

Bug Fixes Coteng problemTransparent mode




Changes Firmware supports Transparent Mode, VT100 ModeNew commands: Set Scale Display with Frame, New commands: Read/Write SetupNew Keycodes: Shift Function Keys, Scale KeysError messages 340 now (Factory settings restored (340))

Bug Fixes uneven beepsRead Balance Information (BI;H / BI;L / BI;T )Get model string of scale (SI ;M / )Get model string of scale (SI ;M / )

6.2.8 Version 1.31Some descriptions of “known bugs” are added (see mark !).Some key codes are corrected


6.2.9 Version 1.3Until now all command descriptions except the standard scale commands have been existing twice. Since I do not like redundant information at different places (because update is difficult and has a high error rate), I did remove it in this version.On the other side a global description of the command syntax has been added.

Version / Date of this paper V1.3 / 20.10.99Recommended Driver Version DOS tbd >>>> BETA 1.0 ( only 9600 Bd)Recommended Driver Version WIN tbd >>>> Release 2.8 (Beta version)Recommended Firmware Version Version 1.00


Changes - Firmware supports BPI7500 scales- New commands: Select Box Redraw, Bitmap save/restore

6.2.10 Version 1.2Version / Date of this paper V1.2 / 10.06.99Recommended Driver Version DOS BETA 1.0 ( only 9600 Bd)Recommended Driver Version WIN Release 2.8 (Beta version)Recommended Firmware Version BETA 1.0 (EM01V10.abs / Date 10.06.99) ID = 01-40-97 Changes Syntax (Pixel position), Error Messages, 19200 Baud

6.2.11 Version 1.1Version / Date of this paper V1.1 / 06.05.99Recommended Driver Version DOS preliminaryRecommended Driver Version WIN preliminaryRecommended Firmware Version preliminaryChanges change: Bitmaps Commands for DOS

6.2.12 Version 1.0Version / Date of this paper V1.0 / 29.03.99Recommended Driver Version DOS PreliminaryRecommended Driver Version WIN PreliminaryRecommended Firmware Version PreliminaryChanges new: Transparent Mode

new: Separate Beepnew: Bitmap Clearchange: Bitmap Store, Recall (only command syntax)change: Flush Command (command syntax, default is off)


6.3 Version Changes of Speedmix Description

6.3.1 Version 1.05Version / Date of this paper V1.05 / 25.10.2002Recommended Driver Version DOS Release 1.11Recommended Driver DLL Version WIN Release V4,0,0,6 Recommended Firmware Version New Firmware Version V1.02

Pmc102.abs / Date 22.10.02) ID = 01-44-02 Changes in Firmware Minor error fixingsChanges Driver • New Command BI;F to get scale filter settings

6.3.2 Version 1.04Version / Date of this paper V1.04 / 2002Recommended Driver Version DOS Release 1.10Recommended Driver DLL Version WIN Release V4,0,0,1 Recommended Firmware Version New Firmware Version V1.00

Pmc100.abs / Date 12.06.02) ID = 01-44-00 Changes in Firmware Stand alone mixing applicationChanges Driver • Edit box command changed: Every entry begins with

space• Win: New command DT;BW to get bitmap out of the

device.

6.3.3 Version 1.03Version / Date of this paper V1.03 / 14.02.2002Recommended Driver Version DOS Release 1.09Recommended Driver DLL Version WIN Release V3,6,0,4 Recommended Firmware Version New Firmware Version 0.95

Pmc095.abs / Date 12.02.02) ID = 01-44-95 Changes • Additional key codes (long keys available)

• Edit box command changed: Now entry of new character direct into edit field supported

6.3.4 Version 1.02Version / Date of this paper V1.02 / 16.11.2001Recommended Driver Version DOS Release 1.08Recommended Driver Version WIN Release V3,6,0,1 Recommended Firmware Version New Firmware Version 0.97

Pmc097.abs / Date 15.11.01) ID = 01-44-97 Changes • New name: SpeedMix

• Changes in key codes• Changes in display orientation graphics have to be

rotated in opposite direction (s. ch. 4.3)

6.3.5 Version 1.01Version / Date of this paper V1.01 / 31.07.2001Changes Only changes in description, “file system” commands added

6.3.6 Version 1.00Version / Date of this paper V1.00 / 21.06.2001Recommended Driver Version DOS Release 1.07Recommended Driver Version WIN Release 3.5.0.1Recommended Firmware Version New Firmware Version 0.99

Pm99.abs / Date 20.06.01) ID = 01-44-99 Changes in Firmware First Version
