ETC2 EAEDIPTFT70-ATP Embedded 7.0 tft-display 800x480 built-in intelligence Datasheet

Issue 09.2013
W
O
RL
D
NE
W
!
embedded 7.0" TFT-DISPLAY
800x480 BUILT-IN INTELLIGENCE
Dimension:
170x112x13,9mm
TECHNICAL DATA
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
TFT-GRAPHIC DISPLAY WITH BUILT-IN GRAPHIC FUNCTIONS
800x480 DOTS, 16-BIT COLOR (65.536 COLORS) WITH LED-BACKLIGHT
8MB ON BOARD FLASH FOR FONTS, PICTURES, ANIMATIONS AND MACROS
SIMPLE SUPPLY POWER +5V / 700mA
8 PRE-DEFINED FONTS, CAN BE EXPANDED
TRUETYPE-FONTS IMPORTABLE, TURNABLE IN 90° STEPS
3 DIFFERENT INTERFACES ON BOARD: RS-232, I²C-BUS OR SPI-BUS
DRAW LINE, PLACE A DOT, AREA, BARGRAPH... ACCURATE TO THE PIXEL
ROTARY AND POINTER INSTRUMENTS
MIX TEXT, GRAPHIC, PICTURES AND ANIMATIONS
LUXOURIOUS KEYBOARD FUNCTIONS
MULTI-LINGUAL WITH MACRO PAGES AND STRINGTABLES
BACKLIGHT BRIGHTNESS BY SOFTWARE
ANALOGUE TOUCH PANEL: VARIABLE GRID
FREE DEFINABLE KEY AND SWITCH
8 DIGITAL IN- AND 8 DIGITAL OUTPUTS
2 ANALOGUE INPUTS, COMFORTABLE TO USE
80 DIFFERENT SMALL JINGLES AS AUDIO FEEDBACK
ORDERING CODES
DISPLAYS
TFT 800x480 DOTS, WHITE LED BACKLIGHT
AS ABOVE, BUT WITH TOUCH PANEL
STARTERKIT
INCLUDES EA eDIPTFT70-ATP AND EVALUATION BOARD WITH USB
FOR DIRECT CONNECTION TO PC AND INTERFACE BOARDS FOR
CONNECTION WITH YOUR HOST SYSTEM
ADDTIOTNAL PARTS
MOUNTING BEZEL (ALUMINIUM), BLACK ANODIZED
SOCKET 1x24, 7.1mm HIGH (1 piece)
EA eDIPTFT70-A
EA eDIPTFT70-ATP
EA EVALeDIPTFT70
EA 0FP801-70SW
EA B-24
Zeppelinstr. 19 · D-82205 Gilching · Phone +49-(0)8105-778090 · Fax +49-(0)8105-7780 99 · www.lcd-module.de · [email protected]
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 2
Documentation of revision
Date
Type
Old
New
Reason / Description
May, 2011
0.1
June, 2012
0.2
corrected application schematic, RS232, RS485, USB
May, 2013
1.0
First official release (8MB Flash)
preliminary version
CONTENTS
GENERAL ............................................................................................................................... 3
RS-232 .................................................................................................................................... 4
RS-485, USB .......................................................................................................................... 5
SPI .......................................................................................................................................... 6
I²C ........................................................................................................................................... 7
ANALOGUE / DIGITAL IN- AND OUTPUT .............................................................................. 8
MATRIX KEYPAD .................................................................................................................... 9
SOFTWARE PROTOCOL .............................................................................................. 10 - 11
TERMINAL MODE, COMMAND TRANSFER ....................................................................... 12
COMMANDS / FUNCTIONS IN TABULAR FORMAT ................................................... 13 - 21
TOUCH PANEL .............................................................................................................. 18 -1 9
RESPONSES OF THE CONTROL PANEL .......................................................................... 21
CHARACTER SET ........................................................................................................ 22 - 23
COLORS ............................................................................................................................... 24
FRAMES, KEY STYLE, BARGRAPH AND PATTERN ......................................................... 25
INSTRUMENTS ............................................................................................................. 26 - 27
PROGRAMMING FONTS, PICTURES, ANIMATIONS ......................................................... 28
BITMAPS AS BUTTONS ...................................................................................................... 29
MACROS, MULTI-LINGUAL, MACRO PAGES ............................................................... 30 - 31
SOUNDS............................................................................................................................... 32
KEYBOARD .......................................................................................................................... 33
ELECTRICAL CHARACTERISTICS .................................................................................... 34
DIMENSION, MOUNTING PANEL ................................................................................. 35 - 36
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 3
GENERAL
The EA eDIP series of displays are the world’s first displays with integrated intelligence. In addition
to a variety of integrated fonts that can be used with pixel accuracy, they offer a whole range of
sophisticated graphics functions.
They are controlled via one of the 3 integrated interfaces: RS-232, SPI or I²C. The displays are
“programmed” by means of high-level language-type graphics commands. There is no longer any
need for the time-consuming programming of character sets and graphics routines. The ease of use
of this display with its touch panel dramatically reduces development times.
HARDWARE
The display is designed to work at an operating voltage of +5V.
Data transfer is either serial and asynchronous in RS-232 format or synchronous via the SPI or I²C
specification. To improve data security, a simple protocol is used for all types of transfer.
ANALOGUE TOUCH PANEL
All versions are also available with an integrated touch panel: You can make entries and menu or bar
graph settings by touching the display. The labeling of the “keys” is flexible and can also be changed
during runtime (different languages, icons). The drawing of the individual “keys” and the labeling is
handled by the integrated software.
LED ILLUMINATION
All displays are equipped with modern, energy-saving LED illumination. Brightness can be varied
0~100% by command.
In 24-hour operation, the illumination should be dimmed or switched off as often as possible to
increase their lifetime.
SOFTWARE
This display is programmed by means of commands, such asDraw a rectangle from (0,0) to (799,479).
No additional software or drivers are required. Strings and images can be placed withpixel accuracy.
Text and graphics can be combined at any time. Different character sets can be used at same time.
Each character set and the images can be zoomed from 2 to 8 times and rotated in 90° steps. With the
largest character set, the words and numbers displayed will fill the screen.
ACCESSORIES
Evaluation-Board (EA EVALeDIPTFT70) to write to internal data flash memory
The display is shipped fully programmed, with all fonts. The additional Evaluation-Board is thus
generally not required.
However, if the internal character sets have to be changed or extended, or if images or macros have
to be stored internally, the Evaluation-Board EA 9777-3USB, which is available as an accessory, will
burn the data/images you have created into the on-board data flash memory (8 MB) permanently.
The Evaluation-Board runs under Windows and is connected to the PC’s USB interface. It is shipped
with an interface cable and the installation software. The Evaluation-Board is equipped with serveral
LEDs, push buttons and potentiometer to test all peripherial modes of the eDIP.
Interface-Expansion for Evaluation-Board EA 9777-2PE (included in the Starter Kit):
With the expansion EA 9777-2PE for the Evaluation-Board all interfaces of the display are made
available with the help from small adaptor boards: RS-232, RS-485, SPI, I²C, RS-232 (CMOS level).
Further information you will find in the datasheet of the Evalution-Board.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 4
RS-232 INTERFACE
If the display is wired as shown below,
the RS-232 interface is selected. The
pin assignment is specified in the table
on the right.
The RxD and TxD lines lead CMOS
level (5V) for direct connection to a
microcontroller for example.
If “genuine” RS-232 levels are required
(e.g. for connection to a PC), an
external level converter (e.g. MAX232)
is required.
Pinout eDIPTFT70-A: RS-232/RS-485 mode
Pin Symbol In/Out Function
Pin
1
2
3
4
5
6
7
8
9
10
11
12
GND
VDD
SND+
SNDRESET
BAUD0
BAUD1
BAUD2
ADR0
RxD
TxD
EN485
In
In
In
In
In
In
Out
Out
25
26
27
28
29
30
31
32
33
34
35
36
GND
VDD
AIN1
AIN2
OUT1 / MO8
OUT2 / MO7
OUT3 / MO6
OUT4 / MO5
13
DPOM
In
37
OUT5 / MO4
14
15
16
ADR1
ADR2
BUZZ
In
In
Out
38
39
40
OUT6 / MO3
OUT7 / MO2
OUT8 / MO1
41
IN1 / MI8
42
43
IN2 / MI7
IN3 / MI6
44
IN4 / MI5
45
46
47
48
IN5 / MI4
17 DPROT
In
18
19
DNC
WP
Out
In
20
TEST
SBUF
IN
Out
21
22
23
24
N.C.
Ground Potential for logic (0V)
Power supply for logic (+5V)
Speaker LS1 (Impedance 8 Ohm)
Speaker LS2
L: Reset
Baud Rate 0
Baud Rate 1
Baud Rate 2
Address 0 for RS-485
Receive Data
Transmit Data
Transmit Enable for RS-485 driver
L: disable PowerOnMacro
do not connect for normal operation
Address 1 for RS-485
Address 2 for RS-485
Buzzer output
L: Disable Smallprotokoll
do not connect for normal operation
L: internal, do not connect
L: Writeprotect for DataFlash
open-drain with internal pullup 20..50k
IN (Power-On) L: Testmode
OUT L: data in sendbuffer
do not connect, reserved
BAUD RATES
The baud rate is set by means of pins 6, 7 and 8 (baud 0 to 2). The data
format is set permanently to 8 data bits, 1 stop bit, no parity.
RTS/CTS handshake lines are not required. The required control is
taken over by the integrated software protocol (see pages 10 and 11).
application example
Symbol
In/Out Function
NC
do not connect, reserved
Ground (=Pin 1)
Power supply (=Pin 2)
analogue input 0..VDD
DC impedance 1MOhm
In
8 digital outputs
maximum current:
IOL = IOH = 10mA
Out alternativ up to 8 matrix
keyboard output lines
(reduces the digital output
lines, see chapter external
keyboard)
8 digital inputs
open-drain with internal
pullup 20..50k
In
alternativ up to 8 matrix
keyboard input lines
(reduces the digital input
lines, see chapter external
keyboard)
Baudraten
Baud0 Baud1 Baud2
1
0
0
0
1
0
1
1
0
0
0
1
1
0
1
0
1
1
1
1
1
0
0
0
Datenformat
8,N,1
2400
4800
9600
19200
38400
57600
115200
230400
Note:
The pins BAUD 0 to 2, ADR 0 to 2, DPOM,
DPROT and TEST/SBUF have an internal
pullup, which is why only the LO level
(0=GND) is to be actively applied. These
pins must be left open for a Hi level.
For RS232 operation (without
addressing) the pins ADR 0 to ADR 2
must be left open.
On pin 20 (SBUF) the display indicates
with a low level that data is ready to be
retrieved from the internal send buffer.
The line can be connected to an interrupt
input of the host system, for example.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 5
APPLICATION EXAMPLE „REAL“ RS-232 INTERFACE
The eDIP fits for direct
connection to a RS-232
interface with CMOS
level (5V).
If you have an interface
with ±12V level, an
external levelshifter is
needed.
application example
APPLICATION EXAMPLE: RS-485 INTERFACE
With an external converter (e.g.
SN75176), the EA eDIP can be
connected to a 2-wire RS-485
bus. Large distances of up to
1200 m can thus be
implemented (remote display).
Several EA eDIP displays can
be operated on a single RS-485
bus by setting addresses.
application example
Addressing:
- Up to eight hardware addresses (0 to 7) can be set by means of Pins ADR0..ADR2
- The eDIP with the address 7 is selected and ready to receive after power-on.
- The eDIPS with the addresses 0 to 6 are deselcted after power-on
- Up to 246 further software addresses can be set by means of the ‘#KA adr’ command in the power-on macro (set eDIP
externally to address 0)
APPLICATION EXAMPLE: USB INTERFACE
With an external converter (e.g. FT232R) from FTDI the eDIP can be connected to an USB-Bus.
Virtual-COM-Port drivers are available for different Systems on the FTDI Homepage:
http://www.ftdichip.com/drivers/vcp.htm.
application example
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 6
SPI INTERFACE
If the display is wired as
shown below, SPI mode is
activated.
The data is then transferred
via the serial, synchronous
SPI interface.
The transfer parameter will be
set via the pins DORD, CPOL
and CPHA.
Pinout eDIPTFT70-A: SPI mode
Pin
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Symbol In/Out Function
GND
Ground Potential for logic (0V)
VDD
Power supply for logic (+5V)
SND+
Speaker LS1 (Impedance 8 Ohm)
SNDSpeaker LS2
RESET
In
L: Reset
SS
In
Slave Select
MOSI
In
Serial In
MISO
Out Serial Out
CLK
In
Shift Clock
DORD
In
Data Order (0=MSB first; 1=LSB first)
SPIMOD
In
connect to GND for SPI interface
NC
do not connect
L: disable PowerOnMacro
DPOM
In
do not connect for normal operation
CPOL
In
Clock Polarity (0=LO 1=HI when idle)
CPHA
In
Clock Phase sample 0=1st;1=2nd edge
BUZZ
Out Buzzer output
L: Disable Smallprotokoll
DPROT
In
do not connect for normal operation
DNC
Out L: internal, do not connect
WP
In
L: Writeprotect for DataFlash
open-drain with internal pullup 20..50k
TEST
IN
IN (Power-On) L: Testmode
SBUF
Out
OUT L: data in sendbuffer
Pin
25
26
27
28
29
30
31
32
33
34
35
36
Symbol
GND
VDD
AIN1
AIN2
OUT1 / MO8
OUT2 / MO7
OUT3 / MO6
OUT4 / MO5
37
OUT5 / MO4
38
39
40
OUT6 / MO3
OUT7 / MO2
OUT8 / MO1
41
IN1 / MI8
In/Out Function
N.C.
do not connect, reserved
Ground (=Pin 1)
Power supply (=Pin 2)
In
analogue input 0..VDD
DC impedance 1MOhm
8 digital outputs
maximum current:
IOL = IOH = 10mA
Out
alternativ up to 8 matrix
keyboard output lines
(reduces the digital output
lines, see chapter external
keyboard)
8 digital inputs
open-drain with internal
IN2 / MI7
Note:
pullup 20..50k
IN3 / MI6
The pins DORD, CPOL, CPHA,
alternativ up to 8 matrix
DPOM, DPROT and TEST/SBUF
20
44
IN4 / MI5
In keyboard input lines
have an internal pullup, which is
(reduces the digital input
21
45
IN5 / MI4
lines, see chapter external
why only the LO level
22
46
IN6 / MI3
keyboard)
N.C.
do not connect, reserved
23
47
IN7
/
MI2
(0=GND) is to be actively applied.
24
48
IN8 / MI1
These pins must be left open for a Hi
level.
On pin 20 (SBUF) the display indicates with a low level that data is ready to be retrieved from the internal send buffer.
The line can be connected to an interrupt input of the host system, for example.
18
19
DATA TRANSFER SPI
Write operation: a clock rate up to 200 kHz is allowed
without any stop. Together with a pause of 100 µs
between every data byte a clock rate up to 3 MHz can
be reached.
Read operation: to read data (e.g. the „ACK“ byte) a
dummy byte (e.g . 0xFF) need to be sent.
Note that the EA eDIP for internal operation does need
a short time before providing the data; therefore a short
pause of min. 6µs (no activity of CLK line) is needed for
each byte.
application example
42
43
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
I²C-BUS INTERFACE
If the display is wired as shown
below, it can be operated directly to
the I²C bus.
8 different base addresses and 8
slave addresses can be
selected on the display.
Data transfer is possible at up
to 100 kHz. However, if pauses of at
least 100 µs are maintained between
the individual bytes during transfer, a
byte can be transferred at up to 400
kHz.
EA eDIPTFT70-A
Page 7
Pinout eDIPTFT70-A: I2C mode
Pin Symbol In/Out Function
1
2
3
4
5
6
GND
VDD
SND+
SNDRESET
BA0
7
BA1
8
SA0
9
SA1
10
SA2
11
BA2
12 I2CMOD
13
DPOM
14
15
16
SDA
SCL
BUZZ
17 DPROT
18
19
DNC
WP
20
TEST
SBUF
21
22
23
24
N.C.
Pin
Symbol
In/Out Function
25
26
27
28
29
30
N.C.
do not connect, reserved
In
In
Ground Potential for logic (0V)
Power supply for logic (+5V)
Speaker LS1 (Impedance 8 Ohm)
Speaker LS2
L: Reset
Basic Address 0
GND
VDD
In
Basic Address 1
31
AIN1
Ground (=Pin 1)
Power supply (=Pin 2)
analogue input 0..VDD
DC impedance 1MOhm
32
33
34
35
36
AIN2
OUT1 / MO8
OUT2 / MO7
OUT3 / MO6
OUT4 / MO5
37
OUT5 / MO4
38
39
40
OUT6 / MO3
OUT7 / MO2
OUT8 / MO1
41
IN1 / MI8
42
43
IN2 / MI7
IN3 / MI6
44
IN4 / MI5
45
46
47
48
IN5 / MI4
IN6 / MI3
IN7 / MI2
IN8 / MI1
In
In
In
In
In
Slave Address 0
Slave Address 1
Slave Address 2
Basic Address 2
connect to GND for I²C interface
L: disable PowerOnMacro
In
do not connect for normal operation
Bidir. Serial Data Line
In
Serial Clock Line
Out Buzzer output
L: Disable Smallprotokoll
In
do not connect for normal operation
Out L: internal, do not connect
In
L: Writeprotect for DataFlash
open-drain with internal pullup 20..50k
IN
IN (Power-On) L: Testmode
Out
OUT L: data in sendbuffer
do not connect, reserved
In
8 digital outputs
maximum current:
IOL = IOH = 10mA
Out
alternativ up to 8 matrix
keyboard output lines
(reduces the digital output
lines, see chapter external
keyboard)
8 digital inputs
open-drain with internal
pullup 20..50k
In
alternativ up to 8 matrix
keyboard input lines
(reduces the digital input
lines, see chapter external
keyboard)
Note:
The pins BA0..2, SA0..2, DPOM, DPROT and TEST/SBUF have an internal pullup, which is why only the LO level
(0=GND) is to be actively applied. These pins must be left open for a Hi level.
On pin 20 (SBUF) the display indicates with a low level that data is ready to be retrieved from the internal send buffer.
The line can be connected to an interrupt input of the host system, for example.
I²C - Address
Pin 11,7,6
Base
BA2 BA1 BA0 address
L
L
L
$10
L
L
H
$20
L
H
L
$30
L
H
H
$40
H
L
L
$70
H
L
H
$90
H
H
L
$B0
H
H
H
$D0
I²C address
D7
D6
D5
D4
D3
D2
D1
D0
0
0
0
0
0
1
1
1
0
0
0
1
1
0
0
1
0
1
1
0
1
0
1
0
1
0
1
0
1
1
1
1
S
A
2
S
A
1
S
A
0
R
W
DATA TRANSFER I²C INTERFACE
all pins open: Write $DE
Read $DF
principle I2C-bus transfer:
- I²C-Start
- Master-Transmit: EA eDIP-I²C-address (e.g. $DE), send smallprotocol package (data)
- I²C-Stop
- I²C-Start
- Master-Read: EA eDIP-I²C-Address (e.g. $DF), read ACK-byte and opt. smallprotocoll package (data)
- I²C-Stop
Read operation: for internal operation the
EA eDIP does need a short time before
providing the data; therefore a short pause of
min. 6µs is needed for each byte (no activity of
SCL line).
Applikationsbeispiel
application example
EA eDIPTFT70-A
Page 8
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
ANALOGUE INPUT AIN1 AND AIN2 (PIN 31+32)
For analogue measurement 2 inputs with a range of 0..+5V are available. Each input is grounded
(GND) and DC impedance is 1MΩ. Please make sure that only positive voltages will be supplied
there. Internal resolution is 10 Bit, equal to a 3-digit DVM modul. Linearity (after adjustment) is around
0.5%.
Adjustment
Analogue inputs are not calibrated when shipped out. A procedure for adjustment may be like that:
1.) Put a well known voltage within a range of 2V-VDD to analogue input (example: 3,0V, AIN1)
2.) Run command for calibration (see page 16). Example: „ESC V @ 1 3000“.
Each input query can be done via serial interface or directly shown on display (as digits or bargraph
in various colors and sizes).
Best way for direct visualisation are Process-macros or one of Analogue-macros (e.g. starting at every
voltage change, or above/below a limit).
Both input lines are scaleable from 0 to ±9999.9. Scaling will be done via definition at 2 voltages
„value1=string1;value2=string2“ (see table on page 16).
DIGITAL INPUT AND OUTPUT
The EA eDIP is featured with 8 digital input and 8 digital output lines (CMOS level,
grounded).
8 outputs (Pin 33-40)
Each line can be controlled individually using the „ESC Y W“ command. A
maximum current of 10mA can be switched per line. This give the opportunity to
drive a low power LED in direct way. To source higher current please use an
external transistor.
8 inputs (Pin 41-48)
Each input provides an internal 20..50 kΩ pull-up resistor, so it is possible to connect a key
or switch directly between input and GND. The inputs can be queried and evaluated
directly via the serial interface („ESC Y R“).
In addition to that every port change may start an individual port - or bit- macro (see p. 30).
The command "ESC Y A 1" activates automatic port query. Every alteration of inputs firstly calls bit
macros and afterwards port macros. If there is no definied macro, the new status is transfered into the
send buffer (refer to p. 21).
Note: The logic circuitry is designed for slow operations; in other words, more than 3 changes per
second cannot be easily executed.
EXTENDED OUTPUTS
It is possible to connect 1 to 32 chips like 74HC4094 to the eDIP (OUT1...OUT3), this is why it is
attainable to have 8 to 256 additional outputs. The command "ESC Y E n1 n2 n3" (see p. 17) provides
a comfortable way to control the outputs.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 9
EXTERNAL KEYBOARD
A keyboard (anything from individual keys to a 8x8 matrix keyboard) can be connected to the I/O- ports.
The command ‘ESC Y M n1 n2 n3’ defines the count of input lines (n1=1..8) and output lines (n2=1..8).
n3 set debounce function with 10ms steps (n3=0..15). Please note that count of digital input and output
lines will be reduced while connecting an external keyboard at the same port.
Each key is connected with 1 output and 1 input. All inputs are terminated with a 20..50kΩ pull-up
resistor. For double-keystroke function decoupling of outputs is necessary. For that please use
schottky diodes (e.g. BAT 46).
Transmitting the keystrokes
At each keystroke, the associated key number (1..64) is transmitted or if a corresponding MatrixMacro is defined, Matrix-Macro will be started. The release of the key is not transmitted. If the release
of the key is to be transmitted as well, this can be done by defining Matrix-Macro no. 0.
(see page 21: Responses of EA eDIP)
Calculating of key numbers:
Key_number = (output-1) * count_of_inputs + input (output = MOx, input = MIx).
Examples
- 2x2 matrix: Command ‘ESC Y M 2 2 ..’ defines the 2x2 matrix. Keypad will need input lines MI1, MI2
and output lines MO1, MO2. Output lines are decoupled by diodes; this is for double
keystrokes necessary. 6 input and 6 output lines remain free for other requirements.
- 1x4 matrix: Command ‘ESC Y M 1 4 ..’ defines the 1x4 matrix. Keypad will need output lines
MO1..MO4 and a single input line MI1. With that connection 7 input and 4 output lines
remain free for other requirements.
- 4x0 matrix: Using one single output only (physically 4x1 Matrix), all keys can switch to GND. So no
output line is necessary and command ‘ESC Y M 4 0 ..’ defines 4 input lines onyl. With
that connection 4 input and 8 output lines remain free for other requirements.
- 4x4 matrix: Command ‘ESC Y M 4 4 ..’ defines the 4x4 matrix. Keypad will need input lines MI1..MI4
and output lines MO1..MO4. Output lines are decoupled by diodes; this is for double
keystrokes necessary. 4 input and 4 output lines remain free for other requirements.
.
2x2 Matrix
1x4 Matrix
4x0 Matrix
4x4 Matrix
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 10
DATA TRANSFER PROTOCOL (SMALL PROTOCOL)
The protocol has an identical structure for all 3 interface types: RS-232, SPI and I²C. Each data transfer
is embedded in a fixed frame with a checksum (protocol package). The EA eDIPTFT70-A
acknowledges this package with the character <ACK> (=$06) on successful receipt or <NAK> (=$15)
in the event of an incorrect checksum or receive buffer overflow. In the case of <NAK>,
the entire package is rejected and must be sent again.
Receiving the <ACK> byte means only that the protocol package is ok,
there is no syntax check for the command.
Note: it is neccessary to read the <ACK> byte in any case. If the host
computer does not receive an acknowledgment, at least one byte is lost.
In this case, the set timeout has to elapse before the package is sent
again. The raw data volume per package is limited to 255 bytes (len <=
255). Commands longer than 255 bytes (e.g. Load image ESC UL...)
must be divided up between a number of packages. All data in the
packages are compiled again after being correctly received by the EA
eDIP.
DEACTIVATING THE SMALL PROTOCOL
For tests the protocol can be switched off with an L level at
pin 17 = DPROT. In normal operation, however, you are urgently advised
to activate the protocol. If you do not, any overflow of the receive buffer will
not be detected.
BUILDING THE SMALL PROTOCOL PACKAGES
Command/data to the display
>
<
<DC1>
len
data...
The user data is transferred framed by <DC1>,
the number of bytes (len) and the checksum
(bcc). The display responds with <ACK>.
bcc
<ACK>
<DC1> = 17(dez.) = $11
<ACK> = 6(dez.) = $06
len = count of user data (without <DC1>, without checksum bcc)
bcc = 1 byte = sum of all bytes incl. <DC1> and len, modulo 256
void SendData(unsigned char *buf, unsigned char len)
{
unsigned char i, bcc;
Clear display and draw a line from 0,0 to 799,479
>
<DC1> len
$11
<
$0E
ESC
D
L
ESC
G
D
$1B
$44
$4C
$1B
$47
$44
0
$00
0
$00
$00
799
$00
$1F
479
$03 $DF
$01
bcc
$72
<ACK>
$06
Example for a complete datapackage
SendByte(0x11);
bcc = 0x11;
// Send DC1
SendByte(len);
bcc = bcc + len;
// Send data length
for(i=0; i < len; i++)
{ SendByte(buf[i]);
bcc = bcc + buf[i];
}
// Send buf
SendByte(bcc);
// Send checksum
}
C-Code to transmit data package
Request for content of send buffer
>
<
<
<DC2>
1
S
bcc
<ACK>
<DC1>
len
data...
bcc
<DC2> = 18(dez.) = $12
1 = 1(dez.) = $01
S = 83(dez.) = $53
<ACK> = 6(dez.) = $06
len = count of user data (without <DC1>, without checksum bcc)
bcc = 1 byte = sum of all bytes incl. <DC1> and len, modulo 256
The command sequence <DC2>, 1, S, bcc
empties the display’s send buffer. The display
replies with the acknowledgement <ACK> and
the begins to send all the collected data such as
touch keystrokes.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 11
Request for buffer information
>
<
<
<DC2>
1
I
This command queries whether user data is
ready to be picked up an how full the display's
receive buffer is.
bcc
<ACK>
<DC2>
2
send buffer
bytes ready
receive buffer
bytes free
bcc
<DC2> = 18(dez.) = $12
1 = 1(dez.) = $01
I = 73(dez.) = $49
<ACK> = 6(dez.) = $06
send buffer bytes ready = count of bytes stored in send buffer
receive buffer bytes free = count of bytes for free receive buffer
bcc = 1 byte = sum of all bytes incl. <DC2>, modulo 256
This is how the maximum package size that can
be sent by the display can be limited. The default
setting is a package size with up to 128 bytes of
user data. The timeout can be set in increments
of 1/100 seconds. The timeout is activated
when individual bytes get lost. The entire
package then has to be sent again.
Protocol settings
>
<DC2>
<
<ACK>
3
D
packet size for
send buffer
timeout
bcc
<DC2> = 18(dec.) = $12
3 = 3(dez.) = $03
D = 68(dez.) = $44
packet size for send buffer = 1..128 (standard: 128)
timeout = 1..255 in 1/100 seconds (standard: 200 = 2 seconds)
bcc = 1 byte = sum of all bytes incl. <DC2>, modulo 256
<ACK> = 6(dec.) = $06
Request for protocol settings
>
<
<
<DC2>
1
P
3
max.
packet size
This command is used to query protocol
settings.
bcc
<ACK>
<DC2>
akt. send
packet size
akt. timeout
bcc
<DC2> = 18(dez.) = $12
1 = 1(dez.) = $01
P = 80(dez.) = $50
<ACK> = 6(dez.) = $06
max. packet size = count of maximum user data for 1 package (eDIPTFT70-A = 255)
akt. send packet size = current package size for send
akt. timeout = current timeout in 1/100 seconds
bcc = 1 byte = sum of all bytes incl. <DC2>, modulo 256
Repeat the last package
>
<
<
<DC2>
1
R
If the most recently requested package
contains an incorrect checksum, the entire
package can be requested again. The reply can
then be the contents of the send buffer (<DC1>)
or the buffer/protocol information (<DC2>).
bcc
<ACK>
<DC1>
<DC2>
len
data...
bcc
<DC2> = 18(dez.) = $12
1 = 1(dez.) = $01
R = 82(dez.) = $52
<ACK> = 6(dez.) = $06
<DC1> = 17(dez.) = $11
len = count of user data in byte (without ckecksum, without <DC1> or <DC2>)
bcc = 1 byte = sum of all bytes incl. <DC2> and len, modulo 256
Adressing (only for RS232/RS485)
>
<DC2>
<
<ACK>
3
A
select or
deselect
adr
bcc
<DC2> = 18(dez.) = $12
3 = 3(dez.) = $03
A = 65(dez.) = $41
select or deselect: 'S' = $53 or 'D' = $44
adr = 0..255
bcc = 1 byte = sum of all bytes incl. <DC2> and adr, modulo 256
<ACK> = 6(dec.) = $06
This command can be used to select or
deselect the eDIP with the address adr.
EA eDIPTFT70-A
Page 12
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
TERMINAL MODE
When you switch the unit on, the cursor flashes in the
first line, indicating that the display is ready for
operation. All the incoming characters are displayed
in ASCII format on the terminal (exception:
CR,LF,FF,ESC,’#’). The prerequisite for this is a
working protocol frame or a deactivated protocol (see
pages 10 and 11).
Line breaks are automatic or can be executed by
means of the ‘LF’ character. If the last line is full, the
contents of the terminal scroll upward. The ‘FF’
character (page feed) deletes the terminal. The
character ‘#’ is used as an escape character and thus
cannot be displayed directly on the terminal. If the
character ‘#’ is to be output on the terminal, it must be
transmitted twice: ‘##’. The size of the terminalwindow can be set by command 'ESC TW'.
Terminal-Font 2: 8x16
Attention: The terminal has its own level for displaying
and is thus entirely independent of the graphic
outputs. If the graphics screen is deleted with ‘ESC DL’, for example, that does not affect the contents
of the terminal window.
USING THE SERIAL INTERFACE
The operating unit can be programmed by means of various integrated commands. Each command
begins with ESCAPE followed by one or two command letters and then parameters.
There are two ways to transmit commands:
1. ASCII mode
- The ESC character corresponds to the character ‘#’ (hex: $23, dec: 35).
- The command letters come directly after the ‘#’ character.
- The parameters are transmitted as plain text (several ASCII characters) followed by a separating
character (such as a comma ‘,’) - also after the last parameter e.g.: #GD0,0,799,479,
- Strings (text) are written directly without quotation marks and concluded with CR (hex: $0D) or LF
(hex: $0A).
2. Binär mode
- The escape character corresponds to the character ESC (hex: $1B, dec: 27).
- The command letters are transmitted directly.
- The coordinates xx and yy are transmitted as 16-bit binary values (first the LOW byte and then the
HIGH byte).
- All the other parameters are transmitted as 8-bit binary values (1 byte).
- Strings (text) are concluded with CR (hex: $0D) or LF (hex: $0A) or NUL (hex: $00).
No separating characters, such as spaces or commas, may be used in binary mode.
The commands require no final byte, such as a carriage return (apart from the string $00).
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 13
ALL COMMANDS AT A GLANCE
The built-in intelligence allows an easy creation of your individual screen content. Below mentioned
commands can be used either directly via the serial interface (see page 12) or together with the
selfdefinable macro (see page 28).
EA eDIPTFT70-A: Terminal commands
Command
Codes
Set terminal color
ESC
F
T
Define window
ESC
Form feed FF (dec:12)
Carriage return CR (13)
Line feed LF (dec:10)
Position cursor
Cursor on/off
Save cursor position
Restore cursor position
Terminal off
Terminal on
Output version
Output projectname
Output interface
^L
^M
^J
ESC
ESC
T
Output informationen
ESC
T
Command
Codes
Set display color
Delete display
Fill display
Fill display with color
Invert display
ESC
Set text color
Set font
Font zoom factor
Additional width/height
Spacewidth
Text angle
Output string
L: left justified
C: centered
R: right justified
ESC
F
ESC
Z
ESC
Z
T
Remarks
T
W
P
C
S
R
A
E
V
J
Q
fg
n1
C
n1
bg
Preset color for terminal mode: fg= foreground color; bg= background color
C
The terminal output is executed with font n1: 1=8x8; 2=8x16 only within the window from
column C and line L (=upper-left corner) with a width of W and a height of H (specifications in
characters). W=1..100 and Height H=60/30 (in characters)
L
W
H
The contents of the screen are deleted and the cursor is placed at pos. (1,1)
Cursor to the beginning of the line on the extreme left
Cursor 1 line lower, if cursor in last line then scroll
C=column; L=line; origin upper-left corner (1,1)
n1=0: Cursor is invisible; n1=1: Cursor flashes;
The current cursor position is saved
The last saved cursor position is restored
Terminal display is switched off; outputs are rejected
Terminal display is switched on;
The version no. is output in the terminal e.g. "EA eDIPTFT70-A V1.0 Rev.A"
The macrofile-projectname is output in the terminal e.g. "init / delivery state"
The used interface is output in the terminal e.g "RS232,115200 baud,ADR: $07"
The terminal is initialisized and cleared; the software version, hardware revision,
macrofile-projectname and CRC-checksum are output in the terminal
L
I
EA eDIPTFT70-A: Graphic commands
Remarks
after
reset
8,1
8x16
1,1
60,17
1,1
1
on
after
reset
Display commands (effect on the entire display)
F
ESC
ESC
ESC
D
ESC
D
L
S
F
I
fg
bg
Defines color 1..32 for display and areas: fg=foreground color; bg=background color
Delete display contents (all pixels to background color)
Fill display contents (all pixels to foreground color)
Fill complete display content with color n1=1..32
Invert display content
n1
8,1
Commands for outputting strings
Z
F
Z
Y
J
W
fg
n1
n1
n1
n1
n1
bg
Color 1..32 (0=transparent) for string and character: fg=text color; bg=background color
Set font with the number n1
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
n1=0..15: additional width left/right; n2=0..15: additional height top/bottom
n1=0: use spacewidth from font; n1=1: same witdh as a number; n1>=2 width in dot
Text output angle: n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
n2
n2
L
C
xx1 yy1
text
...
NUL
R
Output string
in an area
(since V1.2)
ESC
Z
B
String for terminal
ESC
Z
T
Set color for lines
Point size/line thickness
Pattern
Draw point
Draw straight line
Draw rectangle
Set start point
Continue straight line
ESC
F
G
Z
M
P
D
R
S
W
fg
n1
n1
xx1
xx1
xx1
xx1
xx1
Draw X-Graph
X
xs
ya
yy1
Draw Y-Graph
Y
ys
xa
xx1
Delete area
Fill area
Fill area with color
Invert area
Copy area
Patterncolor
Area with fill pattern
Draw box
Set color for border
Set border type
Draw border box
L
S
F
I
C
M
M
O
R
E
R
xx1
xx1
xx1
xx1
xx1
fg
xx1
xx1
c1
n1
xx1
yy1
yy1
yy1
yy1
yy1
bg
yy1
yy1
c2
n2
yy1
xx2
xx2
xx2
xx2
xx2
xx1 yy1 xx2 yy2
text ...
8,0
3
1,1
0, 0
0
0
A string (...) is output to xx1,yy1
end of string: 'NUL' ($00), 'LF' ($0A) or 'CR' ($0D)
several lines are separated by the character '|' ($7C, pipe)
the character '\' ($5C, backslash) cancles the special function of '|' and '\'
Output a string (...) inside area from xx1,yy1 to xx2,yy2 at position n1=1..9;
the area will be filled with background color;
n1
NUL n1=1: Top Left; n1=2: Top Center; n1=3: Top Right
n1=4: Middle Left; n1=5: Middle Center; n1=6: Middle Right
n1=7: Bottom Left; n1=8: Bottom Center; n1=9: Bottom Right
Command for outputting a string from a macro to the terminal
text
...
Draw straight lines and points
ESC
G
bg
n2
Colors 1..32 (0=transparent): fg = color for line; bg = pattern background
8,1
n1 = X-point size (1 to 15); n2 = Y-point size (1 to 15);
Set straight line/point pattern no. n1=1..255; 0=do not use pattern
Set a point at coordinates xx1, yy1
Draw straight line from xx1,yy1 to xx2,yy2
Draw four straight lines as a rectangle from xx1,yy1 to xx2,yy2
Set the last end point at coordinates xx1, yy1 for commands 'GW', 'GX' and 'GY'
Draw a straight line from last end point to xx1, yy1
1,1
Draw graph with fix x-steps (xs=1..127 or 129..255 for neg. steps) and variable amount (ya=1..255)
of y-values
Draw graph with fix y-steps (ys=1..127 or 129..255 for neg. steps) and variable amount (xa=1..255)
of x-values
yy1
yy1 xx2 yy2
yy1 xx2 yy2
yy1
yy1
Change/draw rectangular areas
ESC
R
F
ESC
R
F
ESC
R
yy2
yy2
yy2 n1
yy2
yy2 xx3
xx2 yy2
xx2 yy2
c3
xx2 yy2
Delete an area from xx1,yy1 to xx2,yy2 (fill with background color)
Fill an area from xx1,yy1 to xx2,yy2 (fill with foreground color)
Fill an area from xx1,yy1 to xx2,yy2 with color n1=1..32
Invert an area from xx1,yy1 to xx2,yy2
yy3 Copy an area from xx1,yy1 to xx2,yy2 to new position xx3,yy3
Color 1..32 (0=transp.) for monochrome pattern: fg=foreground; bg=background color
n1 Draw an area from xx1,yy1 to xx2,yy2 with pattern n1
n1 Draw a rectangle xx1,yy1 to xx2,yy2 and fill with pattern n1
Set color for border segments: c1=frame outside; c2=frame inside; c3=filling
Set border type n1=1..255; border angle: n2=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
Draw a border box from xx1,yy1 to xx2,yy2
8,1
8,1,1
1, 0
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 14
EA eDIPTFT70-A: Bitmap / Animation commands
Command
Codes
Set bitmap colors
Image zoom factor
Image angle
Mirror Image
ESC
after
reset
Remarks
Bitmap image commands
ESC
F
fg
bg
painting color for monchrome bitmaps fg=foreground color; bg=background color
1,8
Z
n1
n2
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
1,1
W
X
n1
n1
T
n1
I
xx1
yy1
L
xx1
yy1
xx1
yy1
output angle of the image: n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
n1=0: normal display; n1=1: the image is mirrored horizontally
U
Transparency for
color bitmaps
Load internal image
Load image
RLE compression
Send hardcopy
U
ESC
U
ESC
U
R
ESC
U
H
0
0
n1=0: no transparency; show picture with all colors rectangular
n1=1: color of the first dot at top left side will be defined as transparent (like a mask)
n1=2: if defined - use transparent color from bitmap-file (.GIF .TGA .PNG .G16)
n1=3: replace transparent color from bitmap-file with actually background color
Load internal image with the no (0 to 255) from the data flash memory to xx1,yy1
nr
G16 data ...
2
Load an image to xx1,yy1; see image structure (G16 format) for image data
the next hardcopy ('ESC U H xx1,yy1,xx2,yy2) will be send with RLE compression
xx2 yy2
After this command, the image extract is sent (to sendbuffer) in G16 format
Animation image commands
Set animation colors
Animation zoom factor
Animation angle
Mirror animation
ESC
ESC
F
W
fg
bg
color for monchrome animation images fg=foreground color; bg=background color
1,8
Z
n1
n2
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
1,1
W
n1
X
n1
T
n1
output angle of the animation image n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
W
Transparency for
color animation
Load single image
ESC
W
I
xx1
yy1
n1 n2
Define animationprocess
ESC
W
D
no
xx1
yy1
Change animation type
Change animation time
Next animation image
Previous animation image
Show animation image
Run to animation image
Stop animationprocess
ESC
Command
Codes
W
n2
0
n1=0: normal display; n1=1: the animation image is mirrored horizontally
n1=0: no transparency; show animation with all colors rectangular
n1=1: color of the first dot at top left side will be defined as transparent (like a mask)
n1=2: if defined - use transparent color from animation-file (.GIF .G16)
n1=3: replace transparent color from animation-file with actually background color
Load from animation n1=0..255 the single image n2 to xx1,yy1
Define an animationprocess no=1..4 at position xx1,yy1 (=left top edge) with
animation image n2=0..255.
type time type: 1=run once; 2=cyclically; 3=pingpong; 4=once backwards; 5=cyclic backwards
6=pingpong backwards; 7=manually (use command ESC W N|P|F|M)
time: 0=stop; 1..254=time in in 1/10 sec; 255=use time from animation-file
Assign a new type=1..7 to animationprocess no=1..4
Y
no
type
C
no
time
N
no
P
F
no
no
n2
Show the previous image from animationprocess no=1..4
Show image n2 from animationprocess no=1..4
M
no
n2
Run animationprocess no=1..4 from actually image to image n2
L
no
0
2
Assign a new time=0..255 to animationprocess no=1..4
Show the next image from animationprocess no=1..4
Stop animationprocess no=1..4 and clear last image with actually background color
EA eDIPTFT70: Clipboard commands
after
reset
Remarks
Clipboard commands (Buffer for display area)
Save display contents
Save area
Restore area
Copy area
C
B
S
xx1 yy1 xx2 yy2
The entire content of the display is copied to the clipboard as an image area
The image area from xx1, yy1 to xx2, yy2 is copied to the clipboard
C
R
K
xx1 yy1
The image area on the clipboard is copied back to the display
The image area in the clipboard is copied back to xx1, yy1 of the display
L
xx1 yy1
I
xx1 yy1
n1
F
xx1 yy1
n1
ESC
empty
Load bitmap to clipboard
Load image to clipboard
Internal image to clipboard
Animation sub image to
clipboard
ESC
C
G16 data ...
Load the image data (G16-format) into clipboard to xx1, yy1
Draw internal image from data-flash with n1=0..255 into clipboard to xx1, yy1
n2
Draw internal animation sub image from data-flash with number n1=0..255, n2=framenumber into
clipboard to xx1, yy1
n1=0: Auto update OFF; n1=1: Auto update ON; after loading image into clipboard ('CL', 'CI, 'CF')
1
the content is copied to the screen
Clipboardimage autoupdate
U
Copy to clipboard layer
Copy from clipboard layer
Copy area on clipboard
layer
Clipboard transparent color
P
xx1 yy1 xx2 yy2 xx3 yy3 Area from xx1,yy1 to xx2,yy2 on the screen is copied into the clipboard layer to xx3,yy3
C
xx1 yy1 xx2 yy2 xx3 yy3 Clipboard area from xx1,yy1 to xx2,yy2 is copied into the screen to xx3,yy3
A
xx1 yy1 xx2 yy2 xx3 yy3 The area from x1,y1 to x2,y2 on the clipboard layer is copied to new upper left corner x3,y3
n1
Extended clipboard layer usage
Animation through clipboard
ESC
C
T
W
n1
n1=0: no transparency; 1..32: transparent color for clipboard, only for 'ESC CC'
n1
n1=1..4: animation nr; n2=0: draw directly to screen, n2=1 first draw to clipboard layer and
then copy to screen
n2
0
1-4
0
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 15
EA eDIPTFT70-A: Instrument commands
Command
Codes
Remarks
after
reset
Define, use instruments
Definine instrument
Update instrument
Redraw instrument
Send instrument value
ESC
ESC
I
P
n1
xx1
n1
n1
n1
val
I
A
N
S
D
n1
n2
I
F
Z
vf
n1
n1
hf
n2
Y
n1
n2
W
n1
Delete instrument
yy1
n2
n3
aw
ew
Define instrument n1=1..4 and xx1,yy1 (=left top edge);
Use intrument image n2=0..255
Output angle n3=0: 0°; n3=1: 90°; n3=2: 180°; n3=3: 270°;
aw, ew (0..254) are start and endvalue (0% and 100%).
nothing
definied
Update instrument with new value and redraw
Redraw entire instument n1=1..4
Send actual instrument value n1=1..4 to send buffer
The definition of the instrumets gets invalid. If the instrument was adjustable by touch,
the touch area will be deleted, too.
n2=0: Instrument stays visible; n2=1: Instrument is deleted completely
User values - formatted string output
User value color
User value font
User value zoom
User value additional
hight/width
User value angle
ESC
F
ESC
I
User values / scaling
ESC
Command
Codes
Set color for bargraph
Bargraph pattern
Bargraph border
Bargraph linewidth
ESC
F
ESC
B
Define bargraph
ESC
B
I
X
n1
xx1
Set color 1..32 for instrument user value fg=foreground; bg=background color
Set font nr for instrument user value
Set zoom factor for instrument user value: n1=X-Zoom 1x..8x; n2=Y-Zoom 1x..8x
n1=0..15: additional width left/right;
n2=0..15: additional height top/bottom for instrument user value;
Set writing angle for instrument user value: n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
8,1
5
1,1
0, 0
0°
Define user value for instrument no=1..4. Output is right justified to x1,y1
Format String: "iv1=uservalue1;iv2=uservalue2"
For
Assign two instrument values (iv1,iv2 =0..254) to user defined values max. range: 4 1/2 digits 19999
mat
yy1
NUL
+ decimal point ('.' or ',') + sign
Str
e.g. display "-123.4" for iv1=0 and "567.8" for iv2=100
ing
Format String: "0=-123.4;100=567.8"
EA eDIPTFT70-A: Bargraph commands
Remarks
after
reset
Bargraph commands
Update bargraph
Draw bargraph
Send bargraph value
ESC
B
Delete bargraph
B
M
E
B
fg
n1
n1
n1
bg
R
L
O
U
no
A
N
S
no
no
no
D
no
X
F
Z
fg
n1
n1
bg
n2
fc
Colors: fg = foreground; bg = background; fc = color for frame
Pattern for bargraph n1=1..255; n1=0 no pattern/solid (valid for type=0..3)
Border for bargraph n1=1..255 (valid for type=4..7)
Linewidth for bargraph n1=1..255; n1=0 automatic (valid for type=2,3,6,7)
Define bargraph no=1..20 to L(eft), R(ight), O(up), U(down)
xx1,yy1,xx2,yy2 rectangle enclosing the bar graph.
sv, ev are the values for 0% and 100%.
xx1 yy1 xx2 yy2 sv ev type type: 0=pattern bar; 1=pattern bar in rectangle;
type: 2=pattern line; 3=pattern line in rectangle;
type: 4=border bar; 5=border bar in rectangle;
type: 6=border line; 7=border line in rectangle;
val
Set and draw the bargraph with the number no=1..20 to the new value val
Entirely redraw the bargraph with the number no=1..20
Send the current value of bargraph number no=1..20 to sendbuffer
The definition of the bar graph with the number no=1..20 becomes invalid.
If the bar graph was defined as input with touch, this touch field will also be deleted.
n2
n2=0: Bar graph remains visible; n2=1: Bar graph is deleted
8,1,8
0
1
0
no bar
defined
User values - Format text output
User value color
User value font
User value zoom
User value additional
width/height
User value angle
ESC
F
ESC
B
User values / scaling
ESC
B
Y
n1
W
n1
X
no
n2
xx1 yy1
For
mat
Str
ing
NUL
Set color for bargraph user value; fg=foreground, bg=background color
Set font n1 for bargraph user value
Set zoom factor for bargraph user value; n1=X-Zoom 1x..8x; n2=Y-Zoom 1x..8x
n1=0..15: additional width left/right;
n2=0..15: additional height top/bottom for bargraph user value;
Set writing angle for bargraph user value; n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°;
Define user value for bargraph no=1..20. Output is always right justified to xx1,yy1;
Format String: "bv1=uservalue1;bv2=uservalue2". 'NUL' ($00) = termination;
Assign two bar values (bv1,bv2 =0..254) to user defined values
max. range: 4 1/2 digits 19999 + decimal point ('.' oder ',') + sign
e.g. display "-123.4" for bar value bv1=0 and "567.8" for bar value bv2=100
Format String: "0=-123.4;100=567.8"
8,1
5
1,1
0, 0
0°
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 16
EA eDIPTFT70-A: Macro commands
Command
Codes
Remarks
after
reset
Macro commands
Run macro
Run touch macros
Run menu macro
Run port macro
Run bit macro
Run matrix macro
Run process macro
Run analogue macro
ESC
M
N
no
Call the (normal) macro with the number no (max. 7 levels)
T
M
no
Call the touch macro with the number no (max. 7 levels)
Call the menu macro with the number no (max. 7 levels)
P
B
no
no
Call the port macro with the number no (max. 7 levels)
Call the bit macro with the number no (max. 7 levels)
X
C
no
no
Call the matrix macro with the number (max. 7 levels)
Call the process macro with the number (max. 7 levels)
V
Disable macros
L
ESC
n2
U type n1
n2
Call the analogue macro with the number no (max. 7 levels)
Macros of the type'N','T','P','B','X','C', 'M' or 'V' (type 'A' = all macro types) are disabled from the
number n1 to n2; i.e. no longer run when called.
Macros of the type 'N','T','P','B','X','C', 'M' or 'V' (type 'A' = all macro types) are enabled from
number n1 to n2; i.e. run again when called.
A page is selected for macros and images n1=0 to 15. if a macro/image is not defined in the
current page 1 to 15, this macro/image is taken from page 0 (e.g. to switch languages or for
horizontal/vertical installation).
the current macro/image page is saved (when used in process macros)
the last saved macro/image page is restored
M
Enable macros
Select macro/image page
K
ESC
no
type n1
n1
M
Save macro/image page
Restore macro/imagepage
W
R
Macro with delay
G
n1
n2
E
n1
n2
n3
Autom. macros cyclical
A
n1
n2
n3
Autom. macros ping pong
J
n1
n2
n3
Automatic (normal-) macro
Autom. macros once only
ESC
Call the (normal) macro with the number n1 in n2/10s. Execution is stopped by commands (e.g.
receipt or touch macros).
Automatically run macros n1 to n2 once only; n3=pause in 1/10s. Execution is stopped by
commands (e.g. receipt or touch macros).
Automatically run macros n1 to n2 cyclically; n3=pause in 1/10s. Execution is stopped by
commands (e.g. receipt or touch macros).
Automatically run macros n1 to n2 to n1 (ping pong); n3=pause in 1/10s. Execution is stopped,
for example, by receipt or touch macros.
M
Macro processes
Define macro process
Macro process interval
ESC
M
Stop macro processes
D
no type n3
Z
no
S
n1
n4
zs
A macro process with the number no (1 to 4) is defined (1=highest priority).
zs The process macros n3 to n4 are run successively every zs/10s.
type: 1=once only; 2=cyclical; 3=ping pong n3 to n4 to n3
a new time zs in 1/10s is assigned to the macro process with the number no (1 to 4).
if the time zs=0, execution is stopped.
All macro processes and animations are stopped with n1=0 and restarted with n1=1 in order,
for example, to execute settings and outputs via the interface undisturbed
EA eDIPTFT70-A: Analogue input AIN1, AIN2 commands
Command
Codes
Remarks
1
after
reset
Commands for analogue inputs
Calibration
V
Calibration procedure is as follows:
1.) Apply defined voltage (3..5V) to AIN1 (channel1) or AIN2 (channel2)
2.) Run this command with channel information ch=1..2 and xx1=voltage value [mV] (16-Bit)
e.g. 4.0V on AIN1; Command: '#V@1,4000;'
n1=0 disables input scan for AIN1 and AIN2; n1=1 enable input scan
ch
A
n1
D
ch
K
ch
n1
M
n1
n2
B
ch
no
Instrument for AIN1/AIN2
+
ch
no
Redraw bargraph
R
ch
V
ch
fg
F
ch
n1
Z
ch
n1
n2
Set zoom factor for channel ch=1..2; n1=X-Zoom 1x..8x; n2=Y-Zoom 1x..8x
1,1
Y
ch
n1
n2
n1=0..15: additional width left/right;
n2=0..15: additional height top/bottom for channel ch=1..2;
0, 0
W
ch
n1
ch
format string
...
Enable/disable AIN scan
Send analog value
ESC
ESC
V
Bargraph for AIN1/AIN2
ESC
Voltage in [mV] will be sent (to sendbuffer) for channel ch=1..2
Sets two limits for channel ch=1..2.
n1=lower limit [mV/20]; n2=upper limit [mV/20]; n3=hysteresis [mV]
Related to this limits serveral analogmacros can be started automatically.
V
Limit for analog macro
Redefine analoguemacro
(since V1.1)
xx1
not
calib
rated
@
ESC
n2
n3
0
0
Assign analoguemacrofunction n1=0..19 with analoguemacro number n2=0..255.
Assigns bargraph no=1..20 to analogue input ch=1..2
(it is possible to assign more than one bargraph to an anlogue input).
Define start- endvalues (sv, ev) for bargraph in [mV/20] (see comand 'ESC B RLOU')
Assigns instrument no=1..4 to analogue input ch=1..2
Define start- endvalues (sv, ev) for bargraph in [mV/20]
Redraw all bar graphs defined for channel ch=1..2
V
User values - Format text output
User value color
User value Font
User value zoom
User value additional
width/height
User value angle
User values / scaling
Send user value
Display on terminal
Display user value
F
ESC
ESC
ESC
V
V
V
E
S
ch
T
ch
G
ch
bg
Set color for string output of channel ch=1..2; fg= foreground, bg= background color
Set font n1 for channel ch=1..2
NUL
Set writing angle for channel ch=1..2; n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°;
Set user value for channel ch=1..2.
Format String: "mV1=uservalue1;mV2=uservalue2". 'NUL' ($00) = termination
Assign two voltages (0..5000mV) to user defined values
max. range: 4 1/2 digits 19999 + decimal point ('.' oder ',') + sign
e.g. display for 2000 mV input should be "-123.45" and "0.00" for 1000mV
Format String: "2000=-123.45;1000=0"
This will send current voltage as formated string for channel ch=1..2 to sendbuffer
Show formated string of channel ch=1..2 on termial window
xx1 yy1
Show formated string of channel ch=1..2 at coordinate xx1,yy1
8,1
5
0
0
=0.00
5000
=5.00
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 17
EA eDIPTFT70-A: Backlight commands
Command
Illumination brightness
Increase brightness
Decrease brightness
Brightness changetime
Illumination on/off
Codes
H
n1
N
Y
Assign bar with backlight
Asign instrument with
backlight
Save parameter
after
reset
Set brightness of the LED illumination n1=0 to 100%.
[100]
Increase brightness of the LED illumination (one step=1%)
P
ESC
Remarks
Decrease brightness of the LED illumination (one step=1%)
Z
n1
Time n1=0..31 in 1/10sec for changing brightness from 0 to 100%
L
n1
LED n1=0: OFF; n1=1: ON; n1=2 to 255: LED switched ON for n1/10sec
1
B
no
Assign bar no=1..20 for changing brightness of the backlight
0
+
n1
Brightness is connected to instrument 1..4.
0
@
Save the actual brightness and changetime for poweron to EEPROM
EA eDIPTFT70-A: I/O port commands
Command
Codes
Write output port
Read input port
Port scan on/off
Invert input port
ESC
Y
Matrix keyboard
Redefine input bitmacro
Redefine matrixmacro for
keys
ESC
Remarks
W
n1
R
n1
A
n1
I
n1
M
n1
n1=0: Set all 8 output ports in accordance with n2 (=8-bit binary value)
n1=1..8: Reset output port n1 (n2=0); set (n2=1); invert (n2=2)
n1=0: Read all 8 input ports as 8-bit binary value (to sendbuffer)
n1=1..8: Read input port <n1> (1=H-level=VDD, 0=L-level=GND)
The automatic scan of the input port is n1=0: deactivated; n1=1: activated
n2
n2
D
n1
n2
X
n1
n2
E
n1
n2
n3
Command
Codes
Tone buzzer on/off
ESC
Y
S
n1
Sound settings
ESC
Y
V
n1
Play soundqueue
ESC
Y
Q
Note queue
ESC
Y
T
"Notestr" NUL
Play touchsound
ESC
Y
-
n1
Command
Codes
Remarks
n3
n4
NUL
n2
Remarks
S
Define color
ESC
Wait (pause)
ESC
Set RS485 address
T
n1
F
P
no
X
n1
ESC
K
A
ESC
S
B
Send bytes
Send version
Send projectname
Send internal infos
n1=0: no use of internal strings
n1>0: after code n1 appears following codes are internal string numbers
R5
G6
B5
adr
num
0
data...
after
reset
The tone output (Pin 16) becomes n1=0: OFF; n1=1: ON; n1=2..255: ON for n1/10s
AUS
n1=0..7: set volume for a soundqueue and tonscale notes
n2=0..127: wait n2x10ms between the sounds
7,10,1,1
n3=1..15: repeat counter; n3=0: loop
n4=0..2: Mode; 0=ignbore touchsounds, 1=interrupted, 2=stops by touchsounds
play soundqueue; sound nr 1..80 (max. 90 Sounds); #YQ 0 stops playing;
Allowed characters in "notestr" (max 90 notes):
CDEFGAH = notes from one-line octave; cdefgah = notes from two-line octave; P= pause; 1..8 =
time divisor for following notes
play sound number n1=1..80; n2=0..7: volume; a played soundqueue will be affected ('#YV')
EA eDIPTFT70-A: Other commands
ESC
0
Set the outputs of the external 74HC4094 from port n1=0..255 to port n2=0..255; n3=0: low; n3=1:
high; n3=2: invert;
n3
EA eDIPTFT70-A: Sound commands
String table code
1
Assign keynumber n1=1..65 with matrixmacro number n2=0..255
After release the key n1=0 run matrixmacro number n2=0..255
ESC
data...
Ports
1-8=0
input port n1=1..8 is assigned by falling edge n2=0 to new BitMacro number n3=0..255
input port n1=1..8 is assigned by rising edge n2=1 to new BitMacro number n3=0..255
n3
Extended outputs
n2
after
reset
The input port is n1=0: normal; n1=1: evaluated inverted
Specifies an external matrix keyboard at the inputs and outputs.
n1=number of inputs (1..8); n2=number of outputs (0..8); n3=debouncing (0..7)
Y
Y
[5]
Set a new RGB value for color no. n1=1..32 (R5:Bit7..3; G6:Bit7..2; B5:Bit7..3)
Wait n1 tenths of a second before the next command is executed.
For RS232/RS485 operation only and only possible when Hardware address is 0.
The eDIP is assigned a new address adr (in the Power-On macro).
num (=1 to 255) bytes are sent to the sendbuffer data... = num Bytes.
In the source text of the macro programming, the number num must not be specified. This is
counted by the ediptftcompiler and entered.
V
The version is sent as a string to sendbuffer e.g. "EA eDIPTFT32-A V1.1 Rev.A TP+"
J
The macro-projectname is sent as a string to the sendbuffer e.g. "init / delivery state"
I
Internal information about the edip is sent to the sendbuffer.
after
reset
0
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 18
EA eDIPTFT70-A: Commands for the touch panel
Command
Codes
Remarks
after
reset
Touch presets
Touch bordercolors
ESC
Touch borderform
Touch button colors
ESC
Touch button number
F
E
n1
n2
n3
s1
A
E
n1
n2
F
C
nf
nb
sf
sb
A
C
n1
n2
n3
n4
s2 s3
Set the colors (0..32) for touch borders (ESC AT AK).
n=normal; s=selected; 1=frame outside; 2=frame inside; 3=filling
n1=1..255 border number; n1=0 no border; n2=angle 0=0°; 1=90°; 2=180°; 3=270°
Set the colors (0..32) for monochrome touch buttons (ESC AU AJ).
n=normal; s=selected; f=foreground; b=background
n1=0..255 button number; n2=button angle; n3=X-Zoom 1..8; n4=Y-Zoom 1..8
n1=0: newly defined switches do not belong to a group.
n1=1 to 255: newly defined switches belong to the group with the number n1.
Only 1 switch in a group is active at one time; all the others are deactivated. In the case
of a switch in a group, only the down code is applicable. the up code is ignored.
Radio group for switches
ESC
A
R
n1
Font color
Label font
Label zoom factor
Additional width/height
Label angle
Offset for selected label
ESC
F
A
nf
F
n1
Z
Y
n1
n1
n2
n2
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
n1=0..15: additional width left/right; n2=0..15: additional height top/bottom
W
O
n1
n1
n2
Label output angle: n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
n1=X-offset; n2=Y-offset; n1,n2=0..7 (add +8 for negative direction)
8,1,2
8,1,7
1,0
8,1
8,1
1,0,1,1
0
Label font presets
ESC
A
sf
Color for touch labeling. nf=normal fontcolor; sf= fontcolor for selection
Set font with the number n1 for touch key label
8,1
5
1,1
0,0
0
0, 0
Define touch areas
Define touch key
Define touch switch
(status of the switch
toggles after each contact)
ESC
ESC
T
xx1 yy1 xx2 yy2
dow
Cod
up
Cod
U
xx1 yy1
dow up
Cod Cod
text
...
NUL
K
xx1 yy1 xx2 yy2
dow
Cod
up
Cod
J
xx1 yy1
dow up
Cod Cod
text
...
NUL
A
A
text
...
NUL
text
...
NUL
'T': The area from xx1,yy1 to xx2,yy2 is defined as a key
'K': The area from xx1,yy1 to xx2,yy2 is defined as a switch
'U': The actual button is loaded to xx1,yy2 and defined as a key
'J': The actual button is loaded to xx1,yy2 and defined as a switch
'down code':(1-255) return/touchmacro when key pressed.
'up code': (1-255) return/touchmacro when key released.
(down/up code = 0 press/release not reported).
'text': this is a string that is placed in the key with the current touch font.
The first character determines the alignment of the text (C=centered, L=left
justified, R=right justified). Multiline texts are separated with the character '|'
($7C, dec: 124);
optional: after the character '~' ($7E, dec: 126) you can write a 2nd text for a
selected touch key/switch e.g. "LED|on~LED|off"
'nul': ($00) = end of string
Define touch key with menu
function
ESC
A
M
The area from xx1,yy1 to xx2,yy2 is defined as a menu key. 'down
code':(1-255) Return/touch macro when pressed. 'up Code':(1-255)
Return/touch macro when menu canceled 'mnu Code':(1-255) Return/menu
macro+(item no. 1) after selection of a menu item. (down/up code = 0:
activation/cancellation is not reported.) 'text':= string with the key text and the
menu items. the first character determines the direction in which the menu
dow up mnu text
xx1 yy1 xx2 yy2 code code code ... NUL
opens (R=right, L=left, O=up, U=down). The second character determines
the alignment of the touch key text (C=centered, L=left justified, R=right
justified). The menu items are separated by the character '|' ($7C,dec:124)
(e.g. "uckey|item1|item2|item3". The key text is written with the current touch
font and the menu items are written with the current menu font. The
background of the menu is saved automatically.
Define drawing area
ESC
A
D
xx1 yy1 xx2 yy2
Define free touch area
ESC
A
H
xx1 yy1 xx2 yy2
Set bar by touch
Set instrument by touch
ESC
A
B
n1
A drawing area is defined. You can then draw with a line width of n1 and color fg within
the corner coordinates xx1,yy1 and xx2,yy2.
A freely usable touch area is defined. Touch actions (down, up and drag) within the
corner coordinates xx1,yy1 and xx2,yy2 are sent.
The bargraph with number n1 is defined for input by touch panel.
ESC
A
+
n1
The instrument with number n1 is defined for input by touch panel.
n1
fg
TOUCH PANEL
The Version EA eDIPTFT70-ATP is shipped with an analogue, resistive touch panel. Up to 100 touch
areas (keys, switches, menus, bar graph inputs) can be defined simultaneously. The fields can be
defined with pixel accuracy. The display supports user-friendly commands. When the touch “keys” are
touched, they can be automatically inverted and an external tone can sound (pin 16), indicating they
have been touched. The predefined return code of the “key” is transmitted via the interface, or an
internal touch macro with the number of the return code is started instead.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 19
EA eDIPTFT70-A: Commands for the touch panel
Command
Codes
Touch query on/off
ESC
A
A
n1
Touch query is deactivated (n1=0) or activated (n1=1)
Touch key response
ESC
A
I
S
n1
n1
Automatic inversion when touch key touched: n1=0=OFF; n1=1=ON;
Tone sounds briefly when a touch key is touched: n1=0=OFF; n1=1=ON
Touch key vibration
response
ESC
A
*
n1
n1=0: vibration off
n1=1..3: vibration intensity 1=low, 2= mid, 3=high
Set touch sound:
n1=0: all types
n1=6: free area (#AH)
n1=1: key (#AT/#AU)
n1=7: make menu(#AM)
n1=2: switch (#AJ/#AK)
n1=8: menu box(change menu entry)
n1=3: bar (#AB)
n1=9: keyboard (#KS)
n1=4: instrument (#A+)
n1=10: edit box (#ET)
n1=5: all types draw (#AD)
n2=1..80: sound number (0=no sound; 255=no change)
n3=0..7: sound volume (255 no change)
after
reset
Remarks
Global settings
Touch key sound response
ESC
A
-
n1
Send bar value on/off
ESC
A
Q
n1
N
code
P
X
code
code
The status of the switch is changed by means of a command (n1=0=off; n1=1=on)
The status of the switch with the return code (off=0; on=1) is placed in the sendbuffer
G
n1
down code of the activated switch from the radio group n1 is placed in the sendbuffer
L
code
V
xx1 yy1
n2
n3
1
1
1
1,19,7
2,50,7
3,23,6
4,24,4
5,23,6
6,23,6
7,43,7
8,14,6
9,9,5
10,51,6
Automatic transmission of a new bar graph / instrument value by touch input is n1=0: deactivated;
n1=1: is placed in the sendbuffer once at the end of input
n1=2: changes are placed continious in the sendbuffer during input
1
Other functions
Invert touch key
Set touch switch
Query touch switch
Query radio group
ESC
Delete touch area
ESC
A
The touch key with the assigned return code is inverted manually
n1
The touch area with the return code (code=0: all touch areas) is removed from the touch query.
n1=0 the area remains visible on the display; n1=1, the area is deleted.
n1
A
n1
remove the touch area that includes the coordinates xx1,yy1 from the touch query.
n1=0: area remains visible; n1=1: Delete area
TOUCH ADJUSTMENT
The touch panel is perfectly adjusted and immediately ready for operation on delivery. As a result of
aging and wear, it may become necessary to readjust the touch panel:
1a. Send Command 'ESC A@' or
1b. Touch the touch panel at power-on and keep it depressed. After the message “touch adjustment
?” appears, release the touch panel. Touch the touch panel again within a second for at least a
second.
2. Follow the instructions for adjustment (press the 2 points upper left and lower right corner).
EA eDIPTFT70: menu commands
Command
Codes
Set menu colors
Set menu font
Menu font zoom factor
Additional character
width/height
Menu angle
ESC
Remarks
after
reset
Settings for menu box / touch menu
ESC
F
N
F
fg
n1
bg
Z
n1
n2
n1 = X-zoom factor (1x..8x); n2 = Y-zoom factor(1x..8x)
n2
n1=0..15: additional width left/right; n2=0..15: additional height top/bottom
Y
n1
W
n1
T
n1
fc
Colors 1..32; fg=for characters; bg=for background; fc=for frame
Set font with the number n1 (0 to 31) for menu display
8,1,8
5
1,1
0, 0
N
Touch menu automation
Menu display angle n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
0
n1=1: Touch menu opens automatically
n1=0: Touch menu does not open automatically; instead the request 'ESC T 0' to open is sent to the1
host, which can then open the touch menu with 'ESC N T 2'
Menu commands (control with keys not by touch)
Define and display menu
next item
previous item
D
ESC
N
xx1 yy1
N
P
End of menu / send
S
End of menu / macro
M
End of menu / cancel
A
n1
nr
A menu is drawn at corner xx1,yy1 with the current menu font.no=currently inverted entry (e.g.: 1 =
Text
first entry). "text.."=string with menu items, the different items are separated by the character '|'
NUL
...
($7C,dec:124) (e.g. "item1|item2|item3"). The background of the menu is saved automatically.If a
menu is already defined, it is automatically canceled+deleted
The next item is inverted or remains at the end
The previous item is inverted or remains at the beginning
The menu is removed and replaced with the original background. The current item is send as a
number (1 to n) (0=no menu displayed)
The menu is removed and replaced with the original background. Menu macro n1 is called from
item1, menu macro nr+1 for item2...
The menu is removed and replaced with the original background.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 20
EA eDIPTFT70: Edit box commands
Command
Codes
Remerks
after
reset
Setting for edit box
Edit box frame colors
ESC
ESC
n1
n2
n3
H
fd
bd
fa
ba
O
F
left
top
right
bot
n1
Set offset from editbox frame to edit field
Set font number n1=0..255
E
H
n1
n1
n1=1..255: frame number for editbox; n1=0: no frame
n1=1: save edit box background into clipboard layer; n1=0: background is not saved
F
Edit field text colors
Offset for edit field
Set font
Set frame
Save edit box background
Set the frame colors 1..32 (0=transparent) for edit box:
n1=frame outside; n2=frame inside; n3=filling
Q
E
Set text colors (1..32) for edit field:
f=font foreground; b=font background; d=deactivated; a=activated edit box
8,1,1
8,1
1,8
0,0,0,
5
1
0
Define edit box
L
Define and show edit box
ESC
E
no
L: left; C: centerR: right assigned;
def.
Define edit box number no=1..15 from xx1,yy1 to xx2,yy2 and draw
n2 xx1 yy1 xx2 yy2 Text NUL
n2=max. text length; n2=0: no limit
...
default Text=userdefined default text; 'NUL' ($00): End of string
D
no
n2
T
no
n2
P
no code
C
R
Delete edit box
Set edit box by touch
ESC
E
Set password character
Delete edit box no=1..15 (no=0: all edit boxes)
n2=0: area remains visible
n2=1: delete are or restore from clipboard layer (see 'ESC E H')
The edit box no=1..15 can be activated by touch panel.
n2= activate touchmacro; n3=deactivate touchmacro (n2/n3=0 touchmacro is not used)
Set edit box no=1..15 input mode:
code=0: all character are shown; code=1..255: use wildcard for each character
n3
keine
Editbox
def.
0
Using edit box
Activate edit box
A
no
Get edit box string
G
no
ESC
Activates edit box with no=1..15 for editing; no=0: deactivates actually selected edit box
Put string from edit box no=1..15 into sendbuffer
no=0: put all edit box strings into sendbuffer
Send onde character (code) to active edit box; special codes:
8: BACKSPACE deletes last character
10: CANCEL editing, set to default text
12: CLEAR edit field
13: SEND put string into sendbuffer, copy as default text
Send a string to active edit box; 'NUL' ($00): end of string
E
Send character to edit box
B code
Send string to edit box
S
Text...
NUL
EA eDIPTFT70: Touch Keyboard commands
Command
Codes
Remarks
after
reset
Frame settings
Keyboard frame colors
K
ESC
F
Special key frame colors
Keyboard frame
n1
n2
n3
s1
s2 s3
S
ESC
K
E
n1
Set frame colors 1..32 (0=transparent) for keys (special keys code <32) n=normal;
s=selected; 1=frame outside; 2=frame inside; 3=filling
Set frame for keyboard frames: n1=1..255 normal keys (Code >= 32)
n2=1..255 special keys (Code < 32); n1/n2=0: draw no frame
n2
812817
81981G
1
Keyboard label settings
Keyboard label color
F
ESC
Secial key label color
F
s2
F
n1
n2
L
code
O
n1
Y
Keyboard label font
Key label string
n1
ESC
K
Label offset for selection
s1 s2
Text...
NUL
n2
Ser the textcolor 1..32 for keys.
(special keys Code<32)
n1=normal textcolor; s2=textcolor for selection
Set font (1..255) for keyboard label:
n=normal keys; s=special keys; 1=single letters; 2=strings
code=keycode; text...= alternative labelfor key (e.g. for special keys)
code=0: Clear alternative label for all keys
n1=X-offset; n2=Y-offset; n1,n2=0..7 +8 for negative direction
8,1
1,8
6,5
0
0, 0
Keyboard layout
Define keyboard
ESC
K
B
Keyboard position
ESC
K
P
no codestr... NUL
xx1 yy1 xx2 yy2 gap
define keyboard with number no=1..4 definieren;
"codestr" = string with keycodes, several lines are seperated by '|'; 'NUL' ($00): end of string
use backslash '\' ($5C) for special keycodes:
\1,\2,\3,\4: show keyboard no. 1, 2, 3, 4
\5: SHIFT use keyboard 2 for one key autofallback to no. 1
\6: CAPSLOCKtoggle between keyboard no. 1 and no. 2
\8: send code 8 = BACKSPACE for edit box
\A: send code 10 = CANCEL for edit box
\C: send code 12 = CLEAR for edit box
\D: send code 13 = SEND for edit box
\N: placeholder for a key with is not used and drawn
no
keyboard
defined
xx1,yy1 bis xx2,yy2: rectangle enclosing the keyboard
gap: space between the keys
Using keyboard
Show keyboard
S
no
D
n1
Keyboard background
H
n1
n2
Key matrixmacro
M
code
n2
delete keyboard
ESC
K
n2
Show keyboard no=1..4
n2=0: put pressed keys into sendbuffer.
n2=1..15: activate edit box and send pressed keys to it
remove actually shown keyboard (touch areas) from screen:
n1=0: keyboard stays visible
n1=1: delete area or restore from clipboard (see command 'ESC KH')
n1=1: save background into clipboard layer; n1=0: background is not saved
Set background color n2=1..32 (0=transparent)
code=keycode (code=0: all keycodes) Set MatrixMacro for all codes
n2 = 1..255 MatrixMacro number if key is pressed (n2=0: run no macro)
0, 0
0
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 21
RESPONSE OF THE EA EDIPTFT70-A VIA SERIAL INTERFACE
The table below contains all response codes. Some response data will come automatically some
others on request. In addition to that with command 'ESC SB ...' user is able to transmit individual data
packages. All reponses are placed into the sendbuffer. With the smallprotocol command ’Request for
content of send buffer’ (see page10) the host can read out the sendbuffer. This can be done per polling,
alternativly pin 20 ’SBUF’ shows with LO-signal that data is ready to transmit.
Responses of the EA eDIPTFT70-A
Id
num
data
ESC
A
1
code
ESC
B
2
no
value
ESC
F
2
no
value
ESC
K
1
code
ESC
P
1
value
ESC
M
1
no
ESC
H
5
type
xLO
ESC
ESC
ESC
ESC
B
F
X
G
2
2
2
2
no
no
code
no
value
value
value
code
ESC
E
num
ESC
Y
2
ESC
D
3
ESC
W
num
ESC
V
num
ESC
J
num
ESC
I
21
xHI
Remarks
automatic responses (placed into sendbuffer)
yLO
yHI
Response from the analog touch panel when a key/switch is pressed. code = down or up code of the key/swit
transmitted if no touch macro with the number code is defined !
When a bargraph is set by touch, the current value of the bar no is transmitted. Transmission of the bar balue
activated (see the 'ESC A Q n1' command).
When a instrument is set by touch, the current value of the instrument no is transmitted. Transmission of the
intstrument value must be activated (see the 'ESC A Q n1' command).
Response of the touch keyboard; code = keycode. It's only transmitted if there is no MatrixMacro defined and
box.
After the input port is changed, the new 8-bit value is transmitted. The automatic port scan must be activated.
A n1' command. It is only transmitted when there is no corresponding port/bit macro defined !
When a keystroke of the external matrix keyboard is detected, the newly pressed key number no is transmitte
transmitted if no corresponding matrix macro is defined !
The following is transmitted in the case of a free touch area event: type=0 is release; type=1 is touch; type=2
free touch area at the coordinates xx1, yy1
Response only when requested by command (placed into sendbuffer)
After the 'ESC B S n1' command, the current value of the bar with the number no is transmitted.
After the 'ESC I S n1' command, the current value of the instrument with the number no is transmitted.
After the 'ESC A X' command, the current status (value=0 or 1) of the touch switch code is transmitted.
After the 'ESC A G nR' command, the code of the active touch switch in the radio group no is sent.
After the 'ESC E G nr' command or sending the code '13' to the active edit box ('ESC E B code'), the content
no edit box string
nr= number of the edit box (string length=num-1)
After the 'ESC Y R' command, the requested input port is transmitted. no=0: value is an 8-bit binary value of a
no
value
no=1..8: value is 0 or 1 depending on the status of the input no
ch LOval HIval
After the 'ESC V D ch' command, the requested voltage of channel ch=1..2 will be sent (value = 0..5000mV)
After the 'ESC V S ch' command, the requested voltage of channel ch=1..2 will be set as scaled ASCII charac
ch
scaled ASCII string...
string = num-1).
After the 'ESC S V' command, the version of the edip firmware is transmitted as a string
version string...
e.g. "EA eDIPTFT70-A V1.0 Rev.A TP+"
projectname string...
After the 'ESC S J' command, the macro-projectname is transmitted. e.g. "init / delivery state"
X-dots, Y-dots, Version, Touchinfo, after the 'ESC S I' command, internal information is sent by eDIP (16-Bit integer values LO-HI Byte)
CRC-ROM, CRC-ROMsoll
Version: LO-Byte = version number Software; HI-Byte = Hardware revison letter touch
DF in KB,
Touchinfo: LO-Byte = '-|+' X direction detected; HI-Byte = '-|+' Y direction detected
CRC-DF, CRC-DFsoll, DFlen
DFlen: number of user bytes in data flash memory (3 Bytes: LO-, MID- HI-Byte)
Responses without length specification (num)
ESC
U
L
xx1
yy1
image data...
(G16-FORMAT)
after the 'ESC UH....' command, a hard copy is sent in G16-format.
xx1,yy1 = Start coordinates of the hard copy (upper left corner)
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 22
PRELOADED FONTS
As standard, there are 3 monospaced, 3 proportional character sets and 2 large digit fonts integrated.
The proportional character sets (which have a narrow “I” and a wide “W”, for example) look better and
take up less space on the screen. Each character can be placed with pixel accuracy, and its height
and width can be increased by a factor of 1 to 8. A text can be output left justified, right justified or
centered. Rotation in 90° steps is possible. Macro programming permits further fonts to be integrated.
All kinds of fonts can be converted from True-Type
Fonts by using using the LCD toolkit/
eDIPTFTcompiler *) (the Starter kit EA
EVALeDIPTFT70 is required).
*)
Web underhttp://www.lcd-module.com/products/edip.htm
Font 1: 4x6 monospaced
Font 2: 6x8 monospaced
Font 3: 7x12 monospaced
Font 4: GENEVA10 proportional
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
Font 5: CHICAGO14 proportional
Font 7: big numbers BigZif50
EA eDIPTFT70-A
Page 23
Font 6: Swiss30 Bold proportional
Font 8: big numbers BigZif100
This hard copy shows all the fonts with
which the product is shipped
ADDITIONAL FONTS
Up to 256 fonts á 16 pages can be loaded into the internal DataFlash.
EA eDIPTFT70-A
Page 24
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
COMPILER OPTION "WinFont:"
It is possible to raster TrueType-Fonts in
different sizes whitch can be used. A doubleclick to the fontname within the KitEditor opens
the font selection box.
To simplify
the use of
fonts, there is
the possibilty
of a edit box. If you output a string with
KitEditor (e.g. #ZL 5,5, "Hello"), you can perform a double click on the
string to open it. Now you can select the desired characters. This is
mainly recommended using cyrillic, asian or symbol fonts.
In that way, the KitEditor automatically places the right ASCII-Code.
Alternatively you can use instead of the quotation mark curly brackets
(e.g. +ZL 5,5, {48656C6C6F}).
COMPILER OPTION "Font:"
Following font formats can be used:
- FXT: Textfont as used by eDIP240/320 and KIT series
- G16: internal eDIPTFT format (with this format it is possible to user color fonts)
65,536 COLORS
EA eDIPTFT70-A is able to work with 65,536 colors for
true-color pictures/icons and animations. For an easy use
there exists a color palette with 32 entries (16 colors are
predefined after PowerOn). This
Color R
G
B
color palette can be redefined at any
1
0
0
0
time without changing the content of
2
0
0 255
3
255
0
0
the display (command: ESC FP no
4
0
255
0
R G B). To use a color for text and
5
255
0 255
6
0
255 255
graphic functions you set only a
7
255 255
0
number between 1..32. The dummy color number 255 means that the actually
8
255 255 255
9
111 111 111
color is not changed e.g you want only to change the foreground- and not the
10
255 143
0
background color. The color number 0=transparent is special and can be used
11
143
0 255
12
255
0 143
for background of character e.g. that means that for placing a character no
13
0
255 143
rectangular field will be deleted around the character itself. The sensless
14
143 255
0
15
0
143 255
combination
16
175 175 175
o
f
transparent background and
transparent foreground is
used to invert all dots
(=complementary). Two times
inverted will end same as
action was started (original
drawing is restored).
show some examples to show the letter ‘A’ onto a fixed background
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 25
BORDERS, KEY STYLES AND BARGRAPH
The eDIP is shipped with 20 predefined border (no:1..20) for the
commands draw box frame and draw touchkeys.There are also three
special borders in various colors for
using with bargraph commands
(no:101..107, 111..117 and
121..127). All of them can be used in
various sizes via coordinates. The
frames 1..20 are split into 3
segments: the outer frame, inner
frame and filling. Each segment will
get an individual colour for normal
and for selected state. This will give
the user the opportunity, when
touching a field, the individual part of
the key will be inverted only.
FILL PATTERNS
A pattern type can be set as a parameter with various commands. In this way, for example, rectangular
areas and bar graphs can be filled with different patterns. The eDIP is shipped with 20 predefined fill
patterns.
Define own pattern:
With the LCD-tools it is possible to define new pattern (=bitmaps with exactly 8x8
dots).(Compileroption "Pattern:"). The foreground- and backgound color can be set
for monochrome pattern (as the 20 preloaded pattern) incl. transparency. It is also
possible to define full colored pattern.With the LCD-tools some sample pattern has
been installed (see folder 'Pattern').
EA eDIPTFT70-A
Page 26
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
DEFINE OWN BORDER
With the LCD-tools it is possible to define new borders (Compileroption "Border:"). Each of these new
border is a bitmap with exactly 24x24 dots (9 segments with
8x8 dots: 4x edge, 4x middle part, 1x filling).
Scaling for bigger touchkeys/frames will be done by
repetition of these 8x8 dot segments.
This makes it necessary to keep the
8x8 size in every case. If 4-color
bitmaps are used (as the preloaded
border 1..20) the color can be set
individually (the first color is always
transparent and is not used by the
eDIP). It is also possible to define full
colored border (as the preloaded
border25:
border for bargraphs 101...127).With
50x56 Dot size
the LCD-tools some sample border
has been installed (see folder 'Bitmaps\Color\Border').
ROTARY AND POINTER INSTRUMENTS
With the help of the LCD-Tools it is possible to include instruments (Compiler command:
Instrument: 4, <instrument.i16>). Performing a double click in the KitEditor on the
instrument file opens the instrument editor.
The instruments are supported by convinient commands (’ESC I..’). For example the instruments are
connectable to an analog input. In addition they are configurable by touch.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 27
Some examples of instruments:
BUTTONS AS KEYS
Apart from the border types, which are infinitely scalable, it is also possible to use bitmaps as touch
keys or touch switches (Compilerotion "Button:"). A button always consists of two Bitmaps of equal size
(one bitmap to display the touch key in its normal state and another for when it is pressed). The active
area of the touch key automatically results from the size of the button bitmaps.
SWITCHES IN GROUPS (RADIO GROUPS)
Touch switches change their status from ON to OFF or vice versa each
time they are touched. Several touch switches can be included in a group
(‘ESC A R n1’ command). If a touch switch in the group ‘n1’ is switched
on, all the other touch switches in this group are automatically switched
off. Only one switch is ever on (see table on page 18).
RadioBlack75x15_0.bmp
RadioBlack75x15_1.bmp
zwei Radio-Gruppen mit Touch-Schaltern
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 28
CREATING INDIVIDUAL MACROS AND IMAGES
To create your own fonts, images, animations and macros you need the following:
- To connect the display to the PC, you need the EA 9777-3USB USB evaluation board, which is
available as an accessory, or a self-built adapter with a MAX232 level converter (see the application
example on page 5).
- ELECTRONIC ASSEMBLY LCD-Tools*), which contains a kiteditor, bitmapeditor, ediptftcompiler,
fonts, images, border, pattern and examples (for Windows PCs)
- A PC with an USB or serial COM interface
To define a sequence of commands as a macro, all the commands are written to a file on the PC (e.g.
DEMO.KMC). You specify which character sets are to be integrated and which command sequences
are to be in which macros. If the macros are defined using the kit editor, you start the eDIPTFT compiler
using F5. This creates a file called DEMO.DF. If an EA 9777-3USB evaluation board is also connected
or the display is connected to the PC via a MAX232, this file is automatically burned in the display’s
data flash memory. You can send the created macrofile *.DF with any other system to the EA
eDIPTFT70-A. All programming commands are inside this file, so you only need to send the content
of the *.df file (via RS232, SPI or I2C with smallprotocol in packets) to the EA eDIPTFT70-A.
KIT-EDITOR HELP (ELECTRONIC ASSEMBLY LCD TOOLS)
At bottom from the KitEditor window in the statusline you can see a short description for the current
command and the parameters. For more information press F1.
*)
im Internet unter http://www.lcd-module.de/deu/dip/edip.htm
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 29
IMAGES
To save transfer time via serial interface, it is possible to store up to 256 bitmaps á 16 pages into internal
dataflash (Compileroption "Picture:"). Following image file-formats can be used:
- BMP: Windows Bitmap with 1-, 4-, 8-, 16-, 24-, 32-BIT colordepth incl. RLE.
- GIF: Graphics Interchange Format incl. optionally transparency
- JPG: JPEG Compressed Images
- TGA: TARGA Images with 8-, 16-, 24-, 32-BIT colordepth incl. RLE and transparency.
- PNG: Portable Network Graphics incl. colour map, gray scale and transparency
- G16: internal eDIPTFT format, incl. RLE and transparency
All pictures are converted into internal G16 format with RLE encoding (saves memory). Too big
pictures are resized proportional (Compileroption "MaxSize:"). It is also possible to reduce the
colordepth (Compileroption "MaxColorDepth:"). One color can be defined as transparent
(Compileroption "MakeTransparent:“) The internal pictures can be used with the command "ESC U
I" via serial interface or from a macro. The foreground- and backgound color can be set for monochrome
pictures incl. transparency.
ANIMATIONS
It is possible to store up to 256 animations á 16 pages into internal dataflash. (Compileroption
"Animation:"). Following image file-formats can be used:
- GIF: animated GIF (only identically transparent areas, transparency can be switched off).
- G16: internal animated eDIPTFT format
- two or more single bitmaps (BMP, GIF, JPG, TGA, PNG, G16) e.g. two bitmaps for blinking
Note that max. 4 animations (animationprocesses) can run at the same time . The animations are
selfrunning pictures, but you can use the animations manually too. The foreground- and backgound
color can be set for monochrome animations.
PATTERN
Patterns are used to fill a box, a bargraph or to draw a line. It is possible to store up to 256 pattern á 16
pages into internal dataflash (Compileroption "Pattern:").
Each bitmap (BMP, GIF, JPG, TGA, PNG, G16) with a size of 8x8 dots can be imported as a pattern.
The foreground- and backgound color can be set for monochrome pattern incl. transparency.
BORDER / BARGRAPH
A border can be scaled and is used for rectangles, bargraphs and touch keys/switches. It is possible
to store up to 256 border á 16 pages into internal dataflash (Compileroption "Border:")
Each bitmap (BMP, GIF, JPG, TGA, PNG, G16) with a size of 24x24 dots can be imported as a border.
The transparency of GIF,TGA, PNG and G16 bitmaps is used by the EA eDIP. It is possible to change
the colors for 4-color borders, the first color ist always transparent and is not used by the EA eDIP. When
used for a touch key/switch a second border can be loaded witch will be used if the touch key/ switch
is pressed.
IMAGES AS TOUCHKEYS (BUTTONS)
It is possible to store up to 256 touchkeys/buttons á 16 pages into internal dataflash. (Compileroption
"Button:").
A button consists of one or two images with the same size (BMP, GIF, JPG, TGA, G16). The
transparency of GIF,TGA, PNG and G16 bitmaps is used by the EA eDIP and should be identical. The
first bitmap is used when the touch key/switch is released and the second bitmap is used if the touch
key/ switch is pressed.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 30
MACROS
Single or multiple command sequences can be grouped together in macros and stored in the data flash
memory. You can then start them by using the Run macro commands. There are different types of
macro (compiler directive marked in green letters):
Normal macro Macro:
These are started by means of an ‘ESC MN xx’ command via the serial interface or from another
macro. A series of macros occurring one after the other can be called cyclically (movie, hourglass,
multi-page help text). These automatic macros continue to be processed until either a command is
received via the interface or a touch macro with a corresponding return code is activated.
Touch macro TouchMacro:
Started when you touch/release a touch field (only in versions with a touch panel - TP) or issue an
‘ESC MT xx’ command.
Menu macro (1 to 255) MenuMakro:
Started when you choose a menu item or issue an ‘ESC MM xx’ command.
Bit macro BitMacro:
will be started by a single line IN 1..8 (bit) will change or by command 'ESC MB xx'. Bit- Macro 1..8 are
good for falling edge and Bit Macro 9..16 are good for rising edge at input 1..8. It is possible to change
the assignment between Bitmacro and intput with command ‘ESC YD n1 n2 n3’ (see page 17).
Port macro PortMacro:
These are started when voltage (binary) is applied to IN 1..8 or by command 'ESC MP xx'.
Matrix macro MatrixMacro:
Matrix Macro 1..64: start when keypressed or by command 'ESC MX xx'. Matrix Macro 0: start after
release of key or by command. It is possible to change the assignment between keynumber and
Matrixmacro with command ‘ESC YX n1 n2 n3’ (see page 17).
Analogue macro AnalogMacro:
will start whenever voltage changes or limit exceeds or by command 'ESC MV xx'. See table at the right:
It is possible to change the assignment between
Analog Makros
analoguemacrofunction and Analoguemacronumber with command
Makro Nr.
‘ESC VM n1 n2’ (see page 15).
Start des Makros bei
AIN1 AIN2
0
10 jeder Änderung des Analogwertes
Process Makro ProcessMacro:
1
11 fallendem Analogwert
automatic start at fixed periode (0.1s up to 25s) or by command 'ESC 2 12 steigendem Analogwert
MC xx'. Up to 4 individual process may be defined by command 'ESC 3 13 kleiner unterer Grenzwert
4
14 größer unterer Grenzwert
MD ..'. These Process Makro will never be stopped by other commands 5 15 kleiner oberer Grenzwert
6
16 größer oberer Grenzwert
or activities.
7
8
9
17 Ausserhalb beider Grenzwerte
18 Innerhalb beider Grenzwerte
19 kleiner als anderer Analogkanal
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 31
Power-on-macro PowerOnMacro:
Started after power-on. You can switch off the cursor
and define an opening screen, for example.
Reset-macro ResetMacro:
Started after an external reset (low level at pin 5).
Watchdog-macro WatchdogMacro:
Started after a fault/error (e.g. failure).
Brown-out-macro BrownOutMacro:
Started after a voltage drop <4.6V (typ.).
Achtung: Wird im PowerOn-, Reset-,
Watchdog- oder BrownOut-Makro eine
Endlosschleife programmiert, ist das
Display nicht mehr ansprechbar. In diesen
Fall muss die Ausführung des Power-On
Makros unterdrückt werden. Das erreicht
man durch die Beschaltung von DPOM:
-PowerOff - Pin13 (DPOM) auf GND legen
-PowerOn - Pin13 (DPOM) wieder öffnen.
WRITE PROTECTION FOR MACRO PROGRAMMING AND FONTS
A LO level at pin 19 (WP) prevents the macros, images and fonts in the data flash memory from being
overwritten inadvertently (so it is highly recommended !).
MACRO PAGES (MULTILINGUAL CAPABILITY)
There are 16 complete macro sets available as well as the internal images and fonts. By simply
switching the active macro page (ESC M K n1), for example, up to 16 different languages can thus be
supported.
If a macro/picture is defined in the kit editor, a page number can be specified in square brackets after
the macro/picture number. If a macro/image is not defined in the currently set page [1] to [15], this macro/
picture is automatically taken from page [0]. Thus, not all macros and images have to be stored
separately for each language when they are identical in each language.
PICTURE: 100[0] <BIER.BMP>
PICTURE: 100[1] <BEER.BMP>
PICTURE: 100[2] <BIRRA.BMP>
;make sure to select MacroPage first (#MK n1)
; SAME AS "MACRO: 2"
MACRO: 2[0]
#FZ 3,1
#ZL 25,0 "DEUTSCH "
#UI 0,20, 100
MACRO: 2[1]
#FZ 3,1
#ZL 25,0 "ENGLISH
#UI 0,20, 100
MACRO: 2[2]
#FZ 3,1
#ZL 25,0 "ITALIAN
#UI 0,20, 100
; ENGLISH
"
; ITALIAN
"
If there is only the need of handling strings differently, stringtables might be used. Depending on the
active macropage (ESC M K n1) the desired string is called. Please check the following example:
STRINGCODE=$01
STRING: 100[0] "HALLO WELT
";store strings
STRING: 100[1] "HELLO WORLD ";into display’s
STRING: 100[2] "CIAO A TUTTI ";memory
;make sure to select MacroPage first (#MK n1)
MACRO: 1
#ST StringCode
#ZL 10,5, StringCode, 100
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 32
SOUNDS
The EA eDIPTFT70-A(TP) has a sound-module. There are two groups of sounds, notes and jingles.
Notes:
The command #YT “notenstr“ plays notes, to play individual startmelodies or alerts.
Tone (C'-H')
f (Hz)
Tone (C''-H'')
f (Hz)
C
261.6
c
523.3
#C (C sharp/ D flat)
277.2
#c (c sharp/ d flat)
554.4
D
293.7
d
587.3
#D (D sharp/ E flat)
311.1
#d (d sharp/ e flat)
622.3
E
329.6
e
659.3
F
349.2
f
698.5
#F (F sharp/ G flat)
370.0
#f (f sharp/ g flat)
740.0
G
392.0
g
784.0
#G (G sharp/ A flat)
415.3
#g (g sharp/ a flat)
830.6
A
440.0
a
880.0
#A (A sharp/B flat)
466.2
#a (a sharp/b flat)
932.3
H
493.9
h
987.8
Jingles:
Above all, this group is applicable to support touch functions acoustically. The command #A- n1, n2,
n3 applies to every different touch function another jingle with volume (e.g.: #A- 1, 10, 7 = touch button
is assigned with jingle 10 volume 7). The jingles are orgnized in subgroups for an easy selection.
Default Values:
Touchtype
Sound-Number
Volume
Sound-Number
Jingle-Group
Example
1 - 25
toneless klick
Button, Bar,
Instrument
1=Key
19
7
2=Switch
50
7
26 - 49
tone klick
Button, Menu,
Editbox
3=Bargraph
23
6
50-59
double klick
Button, Switch, Menu
4=Instrument
24
4
60-80
melody
Alarm, Warning, Info
5=Draw
23
6
6=Free area
23
6
7=Make menu
43
7
8=Menu Box
14
6
9=Keyboard
9
5
10=Edit Box
51
6
HARDWARE
A Speaker can be directly connected to the pins 3+4. The integrated amplifier reaches 1W in the
maximum, driving 8 Ohm speakers.
For print mounting the following type is a possibilty: *)Peak value, in case of playing a sound.“EKULIT
AP-30P“
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 33
KEYBOARD AND EDIT-BOXES
The EA eDIPTFT70-ATP is able to handle the input of strings itself. You can show a keyboard, which
displays the user’s input data in an edit box. The example shown in the figure below illustrates the
situation. Not till pressing return the data is transfered to the send buffer and transmitted to the host
system.
;—— Place Editbox ——
;select font
#EF SWISS30B
#FQ BLUE, WHITE, BLUE ; set frame colors
#FH WHITE, BLUE, BLUE, YELLOW ; set text colors
; define frame
#EE 20
; define offset between frame and text
#EO 10,10,10,10
#EL 1, 0, 30,140,770,210,““ ; define left justified editbox
; activate editbox
#EA 1
;—— Place Keyboard ——
; keyboard frame colors
#FK BLUE,WHITE,BLUE,YELLOW,BLUE,YELLOW
; special keys for keyboard frame colors
#FS RED,WHITE,RED,YELLOW,BLUE,YELLOW
; keyboard text color
#FF WHITE, BLUE
; special key text color
#FY BLACK, BLUE
#KF SWISS30B, CHICAGO14, SWISS30B, CHICAGO14; select fonts for keyboard
; frame
#KE 6,6
; define labels for special keys
#KL 6, „CAPS“
#KL 8, „<—“
#KL 12, „CLEAR“
#KL 13, „Return“
#KL 5, „Shift“
#KL ‘ ‘,“Space“
; define two keyboards, for capital and small letters ‘\’ means special command
; ‘|’ means next line of keyboard
„
#KB 1, „^1234567890ß\8\C|\6qwertzuiopü+\D\D|\5asdfghjklöä#\N|<yxcvbnm,.-|
„
#KB 2, „°!“’“§$%&/()=?\8\C|\6QWERTZUIOPÜ*\D\D|\5ASDFGHJKLÖÄ\N’“’|<YXCVBNM;:_|
; set keyboard position
#KP 0,240,800,480,3
; show keyboard
#KS 1,1
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 34
SPEZIFICATION AND CHARACTERISTICS
Characteristics
Value
Condition
min.
typ.
max.
Unit
Operating Temperature
-20
+70
°C
Storage Temperature
-30
+80
°C
90
%RH
5.1
V
Storage Humidity
< 40°C
Operating Voltage
4.9
5.0
Input Low Voltage
-0.5
0.3*VDD
V
Input High Voltage
Pin Reset only
0.9*VDD
VDD+0.5
V
Input High Voltage
except Reset
0.6*VDD
VDD+0.5
V
Input Leakage Current
Pin MOSI only
1
uA
50
kOhms
0.7
V
Input Pull-up Resistor
20
Output Low Voltage
Output High Voltage
4.2
V
w./o. Touch
480
cd/m²
with Touch
400
cd/m²
Brightness (white)
Output Current
20
mA
Backlight 100%
690
1000*
mA
Backlight off
200
500*
mA
Power Supply
*) Peak, if a sound is played with full volume.
NOTES ON HANDLING AND OPERATION
ATTENTION
- The module can be destroyed by polarity reversal or overvoltage of the power
supply; overvoltage, reverse polarity or static discharge at the inputs; or shortcircuiting of the outputs.
- It is essential that the power supply is switched off before the module is
handling precautions!
disconnected. All inputs must also be deenergized.
- The display and touch screen are made of plastic and must not come into contact
with hard objects. The surfaces can be cleaned using a soft cloth without solvents.
- The module is designed exclusively for use in buildings. Additional measures have to be taken if it
is to be used outdoors. The maximum temperature range of -20 to +70°C must not be exceeded. If
used in a damp environment, the module may malfunction or fail. The display must be protected from
direct sunshine.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT70-A
Page 35
MOUNTING BEZEL EA 0FP801-70SW
As accessory we deliver an optional black anodized mounting bezel. The mounting clips are included
in the supplied EA eDIPTFT70-A(TP).
190,00 mm
130,00 mm
92,50 mm
140,00 mm
all dimensions are in mm
153,50 mm
180,00 mm
8,00 mm
180,00 mm
170,00 mm
50,00 mm
122,00 mm
4x
4,00 mm
panel cutout
180,00 mm
130,00 mm
120,00 mm
only neccessary, if using vibrating motor
130,00 mm
2,50 mm
10,00 mm
8x M3
EA eDIPTFT70-A
Page 36
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
DIMENSIONS
ATTENTION
handling precautions!
Note:
LC displays are generally not
suited to wave or reflow
soldering.
Temperatures of over 80°C can
cause lasting damage.
Two mounting clips are
included.
all dimensions are in mm
Zeppelinstr. 19 · D-82205 Gilching · Phone +49-(0)8105-77 8090 · Fax +49-(0)8105-778099 · www.lcd-module.de · [email protected]
Mouser Electronics
Authorized Distributor
Click to View Pricing, Inventory, Delivery & Lifecycle Information:
ELECTRONIC ASSEMBLY:
0FP801-70SW EA eDIPTFT70-A EA eDIPTFT70-ATP EA B-24