ETC2 EAEVALEDIPTFT43 Embedded 4.3 tft-display 480x272 built-in intelligence Datasheet

Issue 02.2014
W
O
RL
D
NE
W
!
embedded 4.3" TFT-DISPLAY
480x272 BUILT-IN INTELLIGENCE
FEATURES
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
Dimensions
107x71x12mm
TFT GRAPHIC DISPLAY WITH BULIT-IN GRAPHIC FUNCTIONS
480x272 DOTS, 16-BIT (65,536) COLORS WITH LED BACKLIGHT
LANDSCAPE AND PORTRAIT MODE (272x480) BY COMMAND
4MB ON BOARD FLASH FOR FONTS, PICTURES, ANIMATIONS AND MACROS
POWER SUPPLY +5V / 180mA
8 PRE-DEFINED FONTS, CAN BE EXPANDED
FONT ZOOM FROM 2mm TO about 80mm, TURNABLE IN 90° STEPS
3 DIFFERENT INTERFACES ON BOARD: RS-232, I²C-BUS OR SPI-BUS
POSITIONING ACCURATE TO THE PIXEL WITH ALL FUNCTIONS
DRAW LINE, PLACE A DOT, AREA, BARGRAPH...
PICTURES AND ANIMATIONS
MIX TEXT AND GRAPHIC
MULTI-LINGUAL WITH MACRO PAGES
BACKLIGHT BRIGHTNESS BY SOFTWARE
ANALOGUE TOUCH PANEL: VARIABLE GRID
FREE DEFINABLE KEY AND SWITCH
8 DIGITAL IN- AND 8 DIGITAL OUTPUT
2 ANALOGUE INPUTS COMFORTABLE TO USE
ORDERING CODES
DISPLAYS
TFT 480x272 DOTS, WHITE LED BACKLIGHT
AS ABOVE, BUT WITH TOUCH PANEL
STARTERKIT
INCLUDES EA eDIPTFT43-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 1x20, 4.5mm HIGH (1 piece)
EA eDIPTFT43-A
EA eDIPTFT43-ATP
EA EVALeDIPTFT43
EA 0FP481-43SW
EA B254-20
Zeppelinstr. 19 · D-82205 Gilching · Phone +49-(0)8105-77 8090 · Fax +49-(0)8105-778099 · www.lcd-module.de · [email protected]
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 2
Documentation of revision
Date
Software
Hardware
July, 22nd. 2008
1.0
Rev.D
New
March 2009
1.1
Rev.E
June 2009
1.2
- additional command: ESC ZB
- bug fix
November 2009
1.3
- bug fix "bargraph" and "clear touch"
May 2011
1.4
- additional functions: Instruments, extended Ports
January 2012
1.5
July 2013
1.6
Reason / Description
1st. Edition
- additional command: ESC YD, ESC VM, ESC YX
- bug fix
- additonal functions: X/Y-graph, String table
Rev.F
- page 32: thickness corrected to 10.4/11.9mm
SMD pin header and new TFT panel
CONTENTS
GENERAL ............................................................................................................................... 3
RS-232, RS485, USB ............................................................................................................. 4
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 - 17
TOUCH PANEL ..................................................................................................................... 18
RESPONSES OF THE CONTROL PANEL .......................................................................... 19
CHARACTER SET .......................................................................................................... 20-22
COLORS ............................................................................................................................... 22
FRAMES, KEY STYLE AND PATTERN .......................................................................... 23-24
INSTRUMENTS ............................................................................................................... 24-25
PROGRAMMING: FONTS, PICTURES, ANIMATIONS ........................................................ 26
BITMAPS AS BUTTONS ...................................................................................................... 27
MACROS, MULTI-LINGUAL, MACRO PAGES ................................................................. 28-29
ELECTRICAL CHARACTERISTICS .................................................................................... 30
DIMENSIONS, MOUNTING PANEL............................................................................... 31 - 32
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-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.
The displays are ready for operation immediately with an operating voltage of 5V. 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.
ANALOG 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 as Draw a rectangle from (0,0) to (479,271).
No additional software or drivers are required. Strings and images can be placed with pixel 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 (Programmer) for internal data flash memory
The display is shipped fully programmed and 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-2USB, which is available as an accessory, will
burn the data/images you have created into the on-board data flash memory (4 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, pushbottons and potentiometer to test all peripherial modes of the eDIP.
Interface-Expansion for Evaluation-Board (included in the Starter-Kit):
Wtih the expansion EA 9777-2PE for the Evaluation-Board all interfaces of the display are made
available with the help from small adapter 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 eDIPTFT43-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
5V (CMOS level) to a
microcontroller, for example,
for direct connection.
If “genuine” RS-232 levels are
required (e.g. for connection
to a PC), an external level
converter (e.g. MAX232) is
required.
Pinout eDIPTFT43-A: RS-232/RS-485 mode
Pin
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Symbol In/Out Function
GND
Ground Potential for logic (0V)
VDD
Power supply for logic (+5V)
NC
do not connect
NC
do not connect
RESET
In
L: Reset
BAUD0
In
Baud Rate 0
BAUD1
In
Baud Rate 1
BAUD2
In
Baud Rate 2
ADR0
In
Address 0 for RS-485
RxD
In
Receive Data
TxD
Out Transmit Data
EN485
Out Transmit Enable for RS-485 driver
L: disable PowerOnMacro
DPOM
In
do not connect for normal operation
ADR1
In
Address 1 for RS-485
ADR2
In
Address 2 for RS-485
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
21
22
23
24
25
26
27
28
29
30
31
32
Symbol
GND
VDD
AIN1
AIN2
OUT1 / MO8
OUT2 / MO7
OUT3 / MO6
OUT4 / MO5
OUT5 / MO4
OUT6 / MO3
OUT7 / MO2
OUT8 / MO1
33
IN1 / MI8
34
35
36
IN2 / MI7
IN3 / MI6
IN4 / MI5
37
IN5 / MI4
38
39
IN6 / MI3
IN7 / MI2
40
IN8 / MI1
In/Out Function
Ground (0V)
Power supply (+5V)
analogue input 0..5V
DC impedance 1MOhm
In
8 digital outputs
maximum current:
IOL = IOH = 10mA
alternativ up to 8 matrix
keyboard output lines
(reduces the digital
output lines, see chapter
external keyboard)
Out
8 digital inputs
open-drain with internal
pullup 20..50k
alternativ up to 8 matrix
keyboard input lines
(reduces the digital input
lines, see chapter
external keyboard)
In
Baud Rates
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
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
data format
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 eDIPTFT43-A
Page 5
APPLICATION EXAMPLE „REAL“ RS-232 INTERFACE
The eDIP fits for direct
connection to a RS-232
interface with CMOS
level (VDD).
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 eDIPTFT43-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 eDIPTFT43-A: SPI mode
Pin
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Symbol In/Out Function
GND
Ground Potential for logic (0V)
VDD
Power supply for logic (+5V)
NC
do not connect
NC
do not connect
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)
SPIMO
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
21
22
23
24
25
26
27
28
29
30
31
32
Symbol
GND
VDD
AIN1
AIN2
OUT1 / MO8
OUT2 / MO7
OUT3 / MO6
OUT4 / MO5
OUT5 / MO4
OUT6 / MO3
OUT7 / MO2
OUT8 / MO1
33
IN1 / MI8
34
35
36
IN2 / MI7
IN3 / MI6
IN4 / MI5
37
IN5 / MI4
38
39
IN6 / MI3
IN7 / MI2
40
IN8 / MI1
In/Out Function
Ground (0V)
Power supply (+5V)
In
analogue input 0..5V
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
pullup 20..50k
In
alternativ up to 8 matrix
keyboard input lines
(reduces the digital input
lines, see chapter
external keyboard)
Note:
The pins DORD, CPOL, CPHA, 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.
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
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 on an 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 eDIPTFT43-A
Page 7
Pinout eDIPTFT43-A: I2C mode
Pin Symbol In/Out Function
1
GND
Ground Potential for logic (0V)
2
VDD
Power supply for logic (+5V)
3
NC
do not connect
4
NC
do not connect
5 RESET
In
L: Reset
6
BA0
In
Basic Address 0
7
BA1
In
Basic Address 1
8
SA0
In
Slave Address 0
9
SA1
In
Slave Address 1
10
SA2
In
Slave Address 2
11
BA2
In
Basic Address 2
12 I2CMO
In
connect to GND for I²C interface
L: disable PowerOnMacro
13 DPOM
In
do not connect for normal operation
14 SDA
Bidir. Serial Data Line
15
SCL
In
Serial Clock Line
16 BUZZ
Out Buzzer output
L: Disable Smallprotokoll
17 DPROT
In
do not connect for normal operation
18 DNC
Out L: internal, do not connect
19
WP
In
L: Writeprotect for DataFlash
open-drain with internal pullup 20..50k
TEST
IN
IN (Power-On) L: Testmode
20
SBUF
Out
OUT L: data in sendbuffer
Pin
21
22
23
24
25
26
27
28
29
30
31
32
Symbol
GND
VDD
AIN1
AIN2
OUT1 / MO8
OUT2 / MO7
OUT3 / MO6
OUT4 / MO5
OUT5 / MO4
OUT6 / MO3
OUT7 / MO2
OUT8 / MO1
33
IN1 / MI8
34
35
36
IN2 / MI7
IN3 / MI6
IN4 / MI5
37
IN5 / MI4
38
39
IN6 / MI3
IN7 / MI2
40
IN8 / MI1
In/Out Function
Ground (0V)
Power supply (+5V)
analogue input 0..5V
DC impedance 1MOhm
In
8 digital outputs
maximum current:
IOL = IOH = 10mA
alternativ up to 8 matrix
keyboard output lines
(reduces the digital
output lines, see chapter
external keyboard)
Out
8 digital inputs
open-drain with internal
pullup 20..50k
alternativ up to 8 matrix
keyboard input lines
(reduces the digital input
lines, see chapter
external keyboard)
In
Note:
The pins BA0 to 2, SA0 to 2, DPOM, DPROT and TEST/SBUF have an internal pullup, which is why only the LO level
(L=0=GND) is to be actively applied. These pins must be left open for a Hi level (H=1).
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
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
D0
S
A
2
S
A
1
S
R
A
W
0
all pins open: Write $DE
Read $DF
DATA TRANSFER I²C-BUS
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).
application example
EA eDIPTFT43-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 23+24)
For analogue measurement 2 inputs with a range of 0..VDD 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 2-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 25-32)
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 33-40)
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. 28).
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. 19).
Note: The logic circuitry is designed for slow operations; in other words, more than 3 changes per
second cannot be easily executed.
EXTENDED OUTPUTS (V1.4 AND HIGHER)
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 eDIPTFT43-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-keytroke 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 19: Responses of EA eDIPTFT43-A)
Calculation 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 comman '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 'ESCY 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 eDIPTFT43-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 eDIPTFT43-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 eDIPTFT43-A.
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 SMALLPROTOCOL 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(dec.) = $11
<ACK> = 6(dec.) = $06
len = count of user data (without <DC1>, without checksum bcc)
bcc = 1 byte = sum of all bytes incl. <DC1> and len, modulo 256
voidSendData(unsigned char *buf, unsigned char len)
{
unsigned char i, bcc;
Clear display and draw a line from 0,0 to 479,271
>
<DC1> len
<
<ACK>
$11
$0E
ESC
D
L
ESC
G
D
$1B
$44
$4C
$1B
$47
$44
0
$00
$06
0
$00
$00
479
$00
$DF
271
$01 $0FE $01
bcc
$60
Example to a complete data package
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“ source code to transmit a data package
Request for content of send buffer
>
<
<
<DC2>
1
S
bcc
<ACK>
<DC1>
len
data...
bcc
<DC2> = 18(dec.) = $12
1 = 1(dez.) = $01
S = 83(dez.) = $53
<ACK> = 6(dec.) = $06
len = count of user data (without <DC2>, without checksum bcc)
bcc = 1 byte = sum of all bytes incl. <DC2>, 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 eDIPTFT43-A
Page 11
Request for buffer information
>
<
<DC2>
<
<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>
2
send buffer
bytes ready
receive buffer
bytes free
bcc
<DC2> = 18(dec.) = $12
1 = 1(dez.) = $01
I = 73(dez.) = $49
<ACK> = 6(dec.) = $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
Protocol settings
>
<DC2>
<
<ACK>
3
D
packet size for
send buffer
timeout
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.
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(dec.) = $12
1 = 1(dez.) = $01
P = 80(dez.) = $50
<ACK> = 6(dec.) = $06
max. packet size = count of maximum user data for 1 package (eDIPTFT43-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
bcc
<ACK>
<DC1>
<DC2>
len
data...
bcc
<DC2> = 18(dec.) = $12
1 = 1(dez.) = $01
R = 82(dez.) = $52
<ACK> = 6(dec.) = $06
<DC1> = 17(dec.) = $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
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>).
Adressing (only for RS232/RS485)
>
<DC2>
<
<ACK>
3
A
select or
deselect
adr
bcc
<DC2> = 18(dec.) = $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 eDIPTFT43-A
Page 12
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 terminal-window can be set by
command 'ESC TW'.
Attention: Graphic commands are able to draw
inside terminal window. For example 'ESC DL' will
delete terminal window, too.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
Terminal-Font 2: 8x16
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,479,271,
- Strings (text) are written directly without quotation marks and concluded with CR (hex: $0D) or LF
(hex: $0A).
2. Binary 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 eDIPTFT43-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 pages 26/28).
EA eDIPTFT43-A: Terminal commands
Command
Codes
Set terminal color
ESC
F
T
fg
bg
Define window
ESC
T
W
n1
C
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
Set display orientation
Delete display
Fill display
Fill display with color
Invert display
ESC
F
ESC
D
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
P
C
S
R
A
E
V
J
Q
C
n1
L
W
H
Preset color for terminal mode: fg= foreground color; bg= background color
8,1
The terminal output is executed with font n1: 1=8x8; 2=8x16 only within the window from column C8x16
and line L (=upper-left corner) with a width of W and a height of H (specifications in characters).
1,1
Display organisation 480x272: C=1..60; L=1..34/17; 272x480: C=1..34; L=1..60/30
60,17
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 eDIPTFT43-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
after
reset
EA eDIPTFT43-A: Graphic commands
Remarks
1,1
1
on
after
reset
Display commands (effect on the entire display)
D
O
L
S
F
I
fg
n1
Z
F
Z
Y
J
W
fg
n1
n1
n1
n1
n1
bg
Defines color 1..32 for display and areas: fg=foreground color; bg=background color
n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270° (0°+180°=480x272; 90°+270°=272x480)
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
0°
Commands for outputting strings
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
...
R
Output string
in an area
(since V1.2)
ESC
Z
B
String for terminal
ESC
Z
T
Set color for lines
Draw rectangle
Draw straight line
Continue straight line
Draw point
Point size/line thickness
Pattern
Set start point
ESC
F
ESC
G
G
R
D
W
P
Z
M
S
fg
xx1
xx1
xx1
xx1
n1
n1
xx1
G
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;
text
NUL n1=1: Top Left; n1=2: Top Center; n1=3: Top Right
n1
...
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
NUL
Draw straight lines and points
Draw X-Graph
ESC
bg
yy1 xx2 yy2
yy1 xx2 yy2
yy1
yy1
n2
Colors 1..32 (0=transparent): fg = color for line; bg = pattern background
8,1
Draw four straight lines as a rectangle from xx1,yy1 to xx2,yy2
Draw straight line from xx1,yy1 to xx2,yy2
Draw a straight line from last end point to xx1, yy1
Set a point at coordinates xx1, yy1
n1 = X-point size (1 to 15); n2 = Y-point size (1 to 15);
1,1
Set straight line/point pattern no. n1=1..255; 0=do not use pattern
0
Set the last end point at coordinates xx1, yy1 for commands 'GW', 'GX' and 'GY' (since V1.5)
Draw graph with fix x-steps (xs=1..127 or 129..255 for neg. steps) and variable amount (ya=1..255)
of y-values (since V1.5)
Draw graph with fix y-steps (ys=1..127 or 129..255 for neg. steps) and variable amount (xa=1..255)
of x-values (since V1.5)
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 eDIPTFT43-A
Page 14
EA eDIPTFT43-A: Bitmap / Animation commands
Command
Codes
Set bitmap colors
Image zoom factor
Image angle
Mirror Image
ESC
F
ESC
U
Remarks
after
reset
Bitmap image commands
Transparency for
color bitmaps
Load internal image
Load image
RLE compression
Send hardcopy
U
Z
fg
n1
W
X
n1
n1
T
n1
bg
n2
painting color for monchrome bitmaps fg=foreground color; bg=background color
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
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
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 .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
I
xx1 yy1
nr
xx1 yy1
G16 data ...
U
L
R
U
H
xx1 yy1 xx2 yy2
ESC
U
ESC
ESC
1,8
1,1
0
0
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) is send with RLE compression (since V1.5)
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
Z
fg
n1
W
X
n1
n1
T
n1
bg
n2
W
Transparency for
color animation
Load single image
ESC
W
I
Define animationprocess
ESC
W
D
no
Y
C
no type
no time
N
P
no
no
F
M
no
no
L
no
Change animation type
Change animation time
Next animation image
Previous animation image
Show animation image
Run to animation image
Stop animationprocess
ESC
W
xx1 yy1
xx1
color for monchrome animation images fg=foreground color; bg=background color
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
output angle of the animation image n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
0
n1=0: normal display; n1=1: the animation image is mirrored horizontally
0
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)
2
n1=2: if defined - use transparent color from animation-file (.GIF .G16)
n1=3: replace transparent color from animation-file with actually background color
n1 n2
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.
yy1 n2 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
Assign a new time=0..255 to animationprocess no=1..4
Show the next image from animationprocess no=1..4
Show the previous image from animationprocess no=1..4
n2
n2
1,8
1,1
Show image n2 from animationprocess no=1..4
Run animationprocess no=1..4 from actually image to image n2
Stop animationprocess no=1..4 and clear last image with actually background color
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 15
EA eDIPTFT43-A: Bargraph commands
Command
Codes
Set color for bargraph
Bargraph pattern
Bargraph border
Bargraph linewidth
ESC
F
ESC
B
Define bargraph
ESC
B
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
Y
n1
n2
W
n1
X
no
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.
n2
If the bar graph was defined as input with touch, this touch field will also be deleted.
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
Command
Codes
B
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"
EA eDIPTFT43-A: Instrument commands (since V1.4)
Remarks
8,1
5
1,1
0, 0
0°
after
reset
Define, use instruments
Definine instrument
Update instrument
Redraw instrument
Send instrument value
ESC
ESC
I
P
n1
xx1 yy1
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
n2
n3
aw
ew
Define instrument n1=1..4 an 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 entirely 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
User values / scaling
ESC
F
ESC
I
ESC
I
X
n1
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
For
Format String: "iv1=uservalue1;iv2=uservalue2"
mat
Assign two instrument values (iv1,iv2 =0..254) to user defined values max. range: 4 1/2 digits 19999
xx1 yy1
NUL
Str
+ decimal point ('.' or ',') + sign
ing
e.g. display "-123.4" for iv1=0 and "567.8" for iv2=100
Format String: "0=-123.4;100=567.8"
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 16
EA eDIPTFT43-A: Analogue input AIN1, AIN2 commands
Command
Codes
Remarks
after
reset
Commands for analogue inputs
Calibration
ESC
V
Enable/disable AIN scan
Send analog value
ESC
ESC
V
Bargraph for AIN1/AIN2
Instrument for AIN1/AIN2
(since V1.4)
Redraw bargraph
ESC
ch
xx1
A
n1
D
ch
K
ch
n1
M
n1
n2
Assign analoguemacrofunction n1=0..19 with analoguemacro number n2=0..255.
B
ch
no
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')
+
ch
no
Assigns instrument no=1..4 to analogue input ch=1..2
Define start- endvalues (sv, ev) for instrument in [mV/20]
R
ch
n2
not
calib
rated
0
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)
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
@
n3
V
0
Redraw all bar graphs defined for channel ch=1..2
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
F
ESC
ESC
V
V
Send user value
Display on terminal
Display user value
ESC
Command
Codes
V
V
F
ch
ch
fg
n1
bg
Set color for string output of channel ch=1..2; fg= foreground, bg= background color
Set font n1 for channel ch=1..2
8,1
5
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
...
E
S
T
ch
ch
G
ch
xx1 yy1
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
0
0
=0.00
5000
=5.00
Show formated string of channel ch=1..2 at coordinate xx1,yy1
EA eDIPTFT43-A: Macro commands
Remarks
after
reset
Macro commands
Run macro
Run touch macros
Run port macro
Run bit macro
Run matrix macro
Run process macro
Run analogue macro
ESC
M
Disable macros
ESC
no
no
Call the (normal) macro with the number no (max. 7 levels)
Call the touch 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
no
L
type
n1
n2
U
type
n1
n2
K
n1
Call the analogue macro with the number no (max. 7 levels)
Macros of the type'N','T','P','B','X','C' 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' 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)
M
Enable macros
Select macro/image page
ESC
N
T
M
Save macro/image page
Restore macro/imagepage
W
R
the last saved macro/image page is restored
Automatic (normal-) macro
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
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
Stop macro processes
ESC
M
D
no type
Z
no
S
n1
zs
n3
n4
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
1
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 17
EA eDIPTFT43-A: Commands for backlight, I/O-port and misc
Command
Codes
Remarks
after
reset
Backlight commands
Illumination brightness
Increase brightness
Decrease brightness
Brightness changetime
Illumination on/off
Assign bar with backlight
Asign instrument with
backlight (since V1.4)
Save parameter
H
N
ESC
Y
n1
Set brightness of the LED illumination n1=0 to 100%.
Increase brightness of the LED illumination (one step=1%)
100
P
Z
n1
Decrease brightness of the LED illumination (one step=1%)
Time n1=0..31 in 1/10sec for changing brightness from 0 to 100%
5
L
B
n1
no
LED n1=0: OFF; n1=1: ON; n1=2 to 255: LED switched ON for n1/10sec
Assign bar no=1..20 for changing brightness of the backlight
1
1
+
n1
Brightness is connected to instrument 1..4.
1
@
Save the actual brightness and changetime for poweron to EEPROM
Port commands
Write output port
Read input port
Port scan on/off
Invert input port
ESC
Y
Matrix keyboard
Redefine input bitmacro
(since V1.1)
Redefine matrixmacro for
keys (since V1.1)
Extended outputs
(since V1.4)
ESC
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=5V, 0=L-level=0V)
The automatic scan of the input port is n1=0: deactivated; n1=1: activated
W
n1
n2
R
n1
A
n1
I
n1
M
n1
n2
n3
D
n1
n2
n3
X
n1
n2
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)
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
Y
Ports
1-8=0
1
0
0
Assign keynumber n1=1..65 with matrixmacro number n2=0..255
After release the key n1=0 run matrixmacro number n2=0..255
ESC
Y
E
n1
n2
n3
Define color
Wait (pause)
ESC
F
P
no
R5
G6
ESC
X
n1
Set RS485 address
ESC
K
A
adr
String table code
ESC
S
T
n1
Tone on/off
ESC
Y
S
n1
B
num
ESC
S
Set the outputs of the external 74HC4094 (refer to page 8) from port n1=0..255 to port n2=0..255;
n3=0: low; n3=1: high; n3=2: invert;
Other commands
Send bytes
Send version
Send projectname
Send internal infos
B5
Set a new RGB value for color no. n1=1..32 (R5:Bit7..3; G6:Bit7..2; B5:Bit7..3)
V
J
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).
n1=0: no use of internal strings
n1>0: after code n1 appears following codes are internal string numbers (since V1.5)
The tone output (pin 16) becomes n1=0:OFF; n1=1:ON; n1=2 to 255:ON for n1/10s
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.
The version is sent as a string to sendbuffer e.g. "EA eDIPTFT43-A V1.0 Rev.A TP+"
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.
data...
0
OFF
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 18
TOUCH PANEL
The Version EA eDIPTFT43-ATP is shipped with an analog, resistive touch panel. Up to 60 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.
EA eDIPTFT43-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
Set the colors (0..32) for touch borders (ESC AT AK).
n=normal; s=selected; 1=frame outside; 2=frame inside; 3=filling
s2 s3
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 any 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
n1
n2
n1 = X-zoom factor (1x to 8x); n2 = Y-zoom factor (1x to 8x)
Y
n1
n2
n1=0..15: additional width left/right; n2=0..15: additional height top/bottom
W
n1
O
n1
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
Label output angle: n1=0: 0°; n1=1: 90°; n1=2: 180°; n1=3: 270°
n2
n1=X-offset; n2=Y-offset; n1,n2=0..7 (add +8 for negative direction)
8,1
5
1,1
0,0
0
0, 0
Define touch areas
Define touch switch
(status of the switch
toggles after each contact)
ESC
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
(since V1.4)
ESC
A
B
n1
'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
text NUL '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 '|'
text NUL ($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
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.
Touch query on/off
ESC
A
A
n1
Touch query is deactivated (n1=0) or activated (n1=1)
Touch key response
ESC
A
I
n1
Automatic inversion when touch key touched: n1=0=OFF; n1=1=ON;
S
n1
Tone sounds briefly when a touch key is touched: n1=0=OFF; n1=1=ON
Send bar value on/off
ESC
A
Q
n1
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
N
code
P
code
X
code
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
n1
V
xx1
yy1
Define touch key
ESC
T
xx1
yy1
xx2 yy2
dow
Cod
up
Cod
U
xx1
yy1
dow
Cod
up
Cod
text
...
NUL
K
xx1
yy1
xx2 yy2
dow
Cod
up
Cod
J
xx1
yy1
dow
Cod
up
Cod
text
...
NUL
n1
fg
A
A
Global settings
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 status of the switch is changed by means of a command (n1=0=off; n1=1=on)
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.
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
1
1
1
1
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 19
TOUICH 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).
RESPONSE OF THE EA eDIPTFT43-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 eDIPTFT43-A
Id
num
data
Remarks
automatic responses (placed into sendbuffer)
ESC
A
1
code
ESC
B
2
no
value
ESC
F
2
no
value
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
Y
2
no
value
ESC
D
3
ch
LOval
ESC
W
num
ch
ESC
V
num
version string...
ESC
J
num
ESC
I
21
projectname string...
X-dots, Y-dots, Version, Touchinfo,
CRC-ROM, CRC-ROMsoll
DF in KB,
CRC-DF, CRC-DFsoll, DFlen
ESC
U
L
xHI
yLO
yHI
Response from the analog touch panel when a key/switch is pressed. code = down or up code of the key/switch. It is onl
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 must be
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
must be activated (see the 'ESC A Q n1' command).
After the input port is changed, the new 8-bit value is transmitted. The automatic port scan must be activated. See the 'E
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 transmitted. Only
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 is drag with
free touch area at the coordinates xx1, yy1
Response only when requested by command (placed into sendbuffer)
HIval
scaled ASCII string...
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 Y R' command, the requested input port is transmitted. no=0: value is an 8-bit binary value of all 8 inputs.
no=1..8: value is 0 or 1 depending on the status of the input no
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 characters (length
string = num-1).
After the 'ESC S V' command, the version of the edip firmware is transmitted as a string
e.g. "EA eDIPTFT43-A V1.0 Rev.A TP+"
After the 'ESC S J' command, the macro-projectname is transmitted. e.g. "init / delivery state"
after the 'ESC S I' command, internal information is sent by eDIP (16-Bit integer values LO-HI Byte)
Version: LO-Byte = version number Software; HI-Byte = Hardware revison letter touch
Touchinfo: LO-Byte = '-|+' X direction detected; HI-Byte = '-|+' Y direction detected
DFlen: number of user bytes in data flash memory (3 Bytes: LO-, MID- HI-Byte)
Responses without length specification (num)
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 eDIPTFT43-A
Page 20
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 USB Evaluation Board
EA 9777-2USB is required).
*)
refer to web: http://www.lcd-module.com/products/edip.html
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
EA eDIPTFT43-A
Page 21
Font 6: Swiss30 Bold proportional
Font 7: big numbers BigZif50
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 eDIPTFT43-A
Page 22
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 witch 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.
Alternativly 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 eDIPTFT32-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 entrys (16 colors are
predefined after PowerOn). This color palette can be
redefined at any time without
Color R
G
B
changing the content of the display
1
0
0
0
2
0
0 255
(command: ESC FP no R G B). To use
3
255
0
0
a color for text and graphic functions
4
0
255
0
you set only a number between 1..32.
5
255
0 255
6
0
255 255
The dummy color number 255 means that the actually color is not changed e.g you
7
255 255
0
8
255 255 255
want only to change the foreground- and not the background color. The color
9
111 111 111
number 0=transparent is special and can be used for background of character e.g.
10
255 143
0
that means that for placing a character no rectangular field will be deleted around
11
143
0 255
12
255
0 143
the character itself. The sensless combination of transparent background and
13
0
255 143
transparent
14
143 255
0
15
0
143 255
foreground
16
175 175 175
is used to
invert
all
dots
(=complementary). Two times
inverted will end same as
action was started (original
drawing is restored).
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 eDIPTFT43-A
Page 23
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').
*)
full version is free available on web at http://www.lcd-module.de/eng/dip/edip.htm
EA eDIPTFT43-A
Page 24
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
border25:
border (as the preloaded border
50x56 Dot size
for bargraphs 101...127).With the
LCD-tools some sample border has been installed (see
folder 'Bitmaps\Color\Border').
ROTARY AND POINTER INSTRUMENTS (since V. 1.4)
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 eDIPTFT43-A
Page 25
Some instrument examples:
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.
RadioBlack75x15_0.bmp
RadioBlack75x15_1.bmp
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 16).
two radio groups with touch switches
EA eDIPTFT43-A
Page 26
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
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-2USB USB programmer, which is available
as an accessory, or a self-built adapter with a MAX232 level converter (see the application example
on p.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-2USB programmer 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 eDIPTFT43-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 eDIPTFT43-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.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 27
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 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, PNG, 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.
EA eDIPTFT43-A
Page 28
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
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 macros 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 macros (1 to 255) TouchMacro:
Started when you touch/release a touch field (only in versions with a touch panel - TP) or issue an
‘ESC MT xx’ command.
Bit macros 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’ (since firmware V1.1, see page 17).
Port macros PortMacro:
These are started when voltage (binary) is applied to IN 1..8 or by command 'ESC MP xx'.
Matrix macros 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’ (since firmware V1.1, see page 17)
Analogue Macros AnalogMacro:
Analogue Macro
will start whenever voltage changes or limit exceeds or by Macro No.
Macro starts at
command 'ESC MV xx'. See table at the right: AIN AIN
0
10 every change of input voltage
It is possible to change the assignment between 1 11 falling input voltage
analoguemacrofunction and Analoguemacronumber with 2 12 rising input voltage
3
13 below lower limit
command ‘ESC VM n1 n2’ (since firmware V1.1, see page 15)
4
14 above lower limit
Process macros ProcessMacro:
5
15 below upper limit
automatic start at fixed periode (0.1s up to 25s) or by command 6 16 above upper limit
'ESC MC xx'. Up to 4 individual process may be defined by 7 17 outside of both limits
command 'ESC MD ..'. These Process Makro will never be 8 18 inside of both limits
9
19 lower than other channel
stopped by other commands or activities.
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 under 4.6V.
Important: If a continuous loop is programmed in
a power-on, reset, watchdog or brown-out macro,
the display can no longer be addressed. In this
case, the execution of the power-on macro must
be suppressed. You do this by wiring DPOM:
- PowerOff - connect pin 13 (DPOM) to GND
- PowerOn - open pin 13 (DPOM) again.
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 29
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>
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
; SAME AS "MACRO: 2"
"
; 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
STRING: 100[1] "HELLO WORLD "
STRING: 100[2] "CIAO A TUTTI "
MACRO: 1
#ST StringCode
#ZL 10,5, StringCode, 100
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 !).
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 30
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
500
cd/m²
with Touch
410
cd/m²
Brightness (white)
Output Current
20
mA
Backlight 100%
180
mA
Backlight off
80
mA
Power Supply
ELECTRONIC ASSEMBLY reserves
the right to change specifications
without prior notice. Printing and
typographical errors reserved.
EA eDIPTFT43-A
Page 31
MOUNTING BEZEL EA 0FP481-43SW
all dimensions are in mm
panel cutout
NOTES ON HANDLING AND OPERATION
- The module can be destroyed by polarity reversal or overvoltage of the power supply; overvoltage,
reverse polarity or static discharge at the inputs; or short-circuiting of the outputs.
- It is essential that the power supply is switched off before the module is 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.
ATTENTION
- 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
handling precautions!
sunshine.
EA eDIPTFT43-A
Page 32
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.
The mounting clips are
included.
all dimensions are in mm
Zeppelinstr. 19 · D-82205 Gilching · Phone +49-(0)8105-7780 90 · Fax +49-(0)8105-77 8099 · www.lcd-module.de · [email protected]
Mouser Electronics
Authorized Distributor
Click to View Pricing, Inventory, Delivery & Lifecycle Information:
ELECTRONIC ASSEMBLY:
EA EDIPTFT43-ATP EA 0FP481-43SW EA EDIPTFT43-A EA TOUCH480-1