e-Gizmo EZ HMI User manual

©2012 by e-Gizmo Mechatronix Central
Page 1 of 16 pages EZ HMI Display Terminal
e-Gizmo
EZ HMI Display Terminal
The EZ HMI (Human-Machine Interface) is a general
purpose display and input terminal designed with mi-
crocontroller applications in mind. Users can display
messages and data through its LCD display, and
get alphanumeric input from users with the use of
just a few simple commands. It even features a self
contained menu driven function that allows users to
set, edit, and save to its non volatile memory data-
herein referred to as Parameters, for later retrieval
and use by the user application programs.
A user interface function that carries these features
usually requires lengthy codes (it does). Now that
these functions are already built-in features of the
EZ HMI, there goes one detail you no longer need to
worry about- you can put all your programming effort
on the application project.
!"#$%&"'()*"%+,-./+0"1234"5"'(6"7.20"8/19":10;"
controller.
!"#$%&"71/;"<197=;.>3+";1"?@AB@"CD#"E10;*"
including Arduino & gizDuino
!").F+"-0+/"G'6"H5".27-;0"I"?"1-;7-;0J"7/1-
F.K+0"=KK.;.12=3"-0+/"'(6
!"G.073=4"-0+/"L+2+/=;+K"81/9=;;+K"9+00=L+"
with relative ease.
!"#0+/"G.=31L"8-2<;.12"9=M+0"=<,-.0.;.12"18"
user inputted data simple.
!"C+2-"K/.F+2"N=/=9+;+/"O2;/4"8-2<;.12"=3-
lows the user to enter non-volatile data for
later retrieval and use by the host MCU using
just a simple set of functions.
!"O2<1K+/"0P.;<:"=331P0"+2;/4"18"2-9+/.<"=2K"
alphanumeric data, including selected sym-
bols.
!"QR"<:=/=<;+/0">4"5"3.2+0"SDG"1/"@)G"K.0-
play.
!")1-/"7-0:">-;;12"M+40"-0+K".2"7=/=9+;+/"
entry and dialog mode are free to use for
other purposes in your program.
Figure 1. EZ HMI Display Terminal Module.
Figure 2. EZ HMI Display Terminal with LCD
display module removed. You can use a VFD
display module in place of the LCD if you want
a high brightness- high contrast display.
Technical Manual and Communication Functions Reference Manual
%+FT"Q/U
$/K-.21V".0"="/+L.0;+/+K";/=K+"9=/M"1P2+K">4";:+"
$/K-.21"&+=9W":;;7W((PPPT$/K-.21T<<

©2012 by e-Gizmo Mechatronix Central N=L+"5"18"QR"7=L+0EZ HMI Display Terminal
CONTROLS and TERMINALS
16 CHARACTERS X 2 LINES
LCD OR VFD DISPLAY
UART PORT
ROTARY ENCODER SWITCH
WITH PUSH FUNCTION
EXT DC INPUT
7.5V-9V DC
>
<ENTER
EXIT
SELECT
FUNCTION SWITCHES
SW2 SW3 SW4 SW5
LCD CONTRAST
ADJUST
UART PORT POWER
AUX DIO
Figure 3. EZ HMI Controls and Port layout. The four push button controls and encoder
!"#$%&'()$)')*+'!&)*+(',+$"++-'./'012',3#4$5#-'63-%$#7-!')-('3!+*'(+8-+('63-%$#7-!9
Figure 4. EZ HMI showing AUX DIO port location and LCD contrast adjustment.

©2012 by e-Gizmo Mechatronix Central
N=L+"?"18"QR"7=L+0 EZ HMI Display Terminal
PIN DESCRIPTION
&=>3+"QT"NQ"A"$#X"G'6
&:+"$#X.3.=/4"G.L.;=3"'27-;"6-;7-;"G'6"<=2">+"8/++34"
used for user applications. These can be controlled
and monitored using the communication functions
=0"K+0</.>+K".2"0+<;.12"YTQ5T"&:+"$#X"G'6"P1/M0"12"
B@"K.L.;=3"31L.<"3+F+30T
Pin No: C$%Z'[\ Description
1 GND Circuit Ground
5PC4 G.L.;=3"6-;7-;"U
? NDB G.L.;=3"6-;7-;"Q
4 PC6 G.L.;=3"6-;7-;"5
BPC7 G.L.;=3"'27-;"U
6NGU Digital Input 1
&=>3+"5T"N?"A"#$%&"N6%&
&:+"#$%&"N6%&"&XG"=2K"%XG"3.2+0"=/+""7/1F.K+K"
with a level translator that allows it to be connect
K./+<;34";1"=24":10;"<12;/133+/"P1/M.2L"P.;:"31L.<"3+F+3""
.2"?TU";1"BTU@"/=2L+T"]++").LTR";1").LT"^"81/"91/+"
details.
Pin No: C$%Z'[\ Description
1 TXD #$%&"&X"G$&$"6#&N#&
5 %XG #$%&"%X"G$&$"'[N#&
?GND Ground
4I@ #$%&"N6%&"N1P+/__
__`NQ"A"#$%&"N6aO%"]6#%DO
a.;:"`NQ".20;=33+K*";:+"I@"#$%&"
7.2"=<;"=0"IB@"71P+/".27-;"1/"
output and is used as follows:
no J1 DC input:
!"""Ob"EC'"<=2">+"71P+/+K">4"0-7734.2L"IB@";1";:+"
I@";1"\[G".27-;"18";:+"#$%&"N6%&T
!"""N1P+/"=773.+K";:/1-L:"`Q
!"""I@"=<;0"=0"="IB@"71P+/"01-/<+";:=;"41-"<=2"-0+"
;1"71P+/"1;:+/"K+F.<+0T"D-//+2;"K/=P2";:/1-L:"I@"
7.2"9-0;"21;"+c<++K"5BU9$T
a.;:1-;"`NQ*"I@"7.2".0"-0+K"81/"3+F+3"#$%&"'(6"3+F+3"
translation. It must be supplied with a voltage input
+,-=3";1";:+"@<<"0-7734"18";:+"+c;+/2=3":10;"<12;/13-
ler. This will ensure logic level compatibility between
the host and EZ HMI.
O[D6GO%"]a'&DE
The encoder switch is a special rotary switch that
7/1F.K+0"81/"="0.973+">-;",-.<M"P=4"18"+2;+/.2L"-0+/"
inputs. Data is generally selected by rotating the
shaft. Pushing the shaft will launch a predetermined
set of actions, which may vary according to the func-
tions using it.
[1"d-97+/"12"`NQ
PUSH
ROTATE
Figure 5. The encoder switch provides a user intui-
tive way of inputting data. Numeric and alphanumeric
inputs is possible, replacing multikey ASCII key-
board.

©2012 by e-Gizmo Mechatronix Central Page 4 of 16 pagesEZ HMI Display Terminal
7.5-9.0V DC
DC INPUT
HOST CONTROLLER (MICROCONTROLLER)
with 5V Supply Voltage
TXD
+5V
RXD
GND
GND
JUMPER INSTALLED
ON JP1 5V POSITION
+5V
SOURCE
7.5-9.0V DC
DC INPUT
HOST CONTROLLER (MICROCONTROLLER)
with 5V Supply Voltage drawn from EZ HMI
TXD
RXD
GND
JUMPER INSTALLED
ON JP1 5V POSITION
+5V INPUT
WIRING CONFIGURATIONS
Important:"a./+"3+2L:;0"9-0;"21;"+c<++K"Q"C+;+/.
Figure 6. UART wiring interface with a 5V logic microcontroller host
with separate power source.
Figure 7. The EZ HMI +5V, when routed through UART V+ by installing a
jumper at JP1 +5V position, can be used to power UART connected device,
such as the host MCU, or even wireless UART devices.

©2012 by e-Gizmo Mechatronix Central
N=L+"B"18"QR"7=L+0 EZ HMI Display Terminal
7.5-9.0V DC
DC INPUT
HOST CONTROLLER (MICROCONTROLLER)
with 3.0-3.3V Supply Voltage
TXD
VCC
RXD
GND
GND
NO JUMPER!
+3.0-3.3V
SOURCE
VCC
HOST CONTROLLER (MICROCONTROLLER)
with 5V Supply Voltage
TXD
VCC
RXD
GND
GND
+5V
SOURCE
VCC
JUMPER INSTALLED
ON JP1 5V POSITION
Figure 8. The EZ HMI, conversely, can be powered
from a +5V sourced by the host controller circuit.
Figure 9. UART wiring interface to host controllers
with 3.0-3.3V working logic levels. Make sure the
jumper in JP1 is removed.

©2012 by e-Gizmo Mechatronix Central Page 6 of 16 pagesEZ HMI Display Terminal
Figure 10. EZ HMI Schematic Diagram

©2012 by e-Gizmo Mechatronix Central
Page 7 of 16 pages EZ HMI Display Terminal
1. DISPLAYING MESSAGE
The LCD used in the EZ HMI has a display area
18"QR"<:=/=<;+/0"c"5"3.2+0T"a.;:";:+"-0+"18"d-0;":=38"
dozen or so functions, users can effortlessly display
messages and other info.
!")-2<;.12"ec” erases the whole content of LCD
display.
!")-2<;.12"e>” is use to set the cursor to any location
within the displayable area. This allows you to start
printing anywhere on the LCD display screen.
!")-2<;.12"e1f"=2K"e2” allows you to display message
on the top line and bottom line respectively. Portions
of LCD display not overwritten with the new mes-
sage will remain unaffected.
!")-2<;.12"e3f"=2K"e4”, allows you to display mes-
0=L+"=0".2"e1f"=2K"e2f*"+c<+7;";:+"3.2+".0"<3+=/+K"g/0;"
of its old display before putting in the new message.
Scrolling Message
'8"41-/"9+00=L+".0";11"312L";1"g;".20.K+";:+"QR"
characters display area, you can use the scrolling
message functions to display your long messages.
]</133.2L"8/19"/.L:;";1"3+8;*"8-2<;.12"em” displays your
0</133.2L"9+00=L+"=;";:+";17"3.2+*"P:.3+"8-2<;.12"eM”
use the bottom line to display. You can display mes-
0=L+0"-7";1"h^"<:=/=<;+/0"312L"7+/"3.2+"-0.2L";:+0+"
functions.
Tip: The LCD display does not respond well with
8=0;"<:=2L.2L"K.073=4T"]</133.2L"9+00=L+"9=4"/+0-3;"
in display that appears to overlap on top of each
other, hence, may be hard to read. To minimize this,
adjust the LCD contrast until an acceptable scrolling
display is obtained. This may result in lower over-
=33"<12;/=0;T"&:.0"3.9.;=;.12"K1+0"21;"=7734";1"@)G"
displays.
]++";:+"]+<;.12"YTQ";1"YTY"81/"91/+"K+;=.30"12";:+"
usage of the display functions
2. PARAMETERS AND PARAMETER ENTRY
MODE
The EZ HMI Parameter Entry Mode is a built-in func-
tion that allows you to set, modify, and save to EZ
HMI non-volatile memory up to 48 data sets; we will
refer to these data sets as parameters here on. This
function will be useful for applications where param-
eters need to be adjusted by the user from time to
time. Example applications includes (and not lim-
ited to) temperature control, process control, timer,
instrumentation - to name just a few.
Using the same function, each parameter can be
2=9+K">4";:+"-0+/"81/"+=04".K+2;.g<=;.12T"N=/=9+-
ters are grouped according to the type of data it can
:13KT"&:+0+"=/+"3.0;+K".2";:+"81331P.2L";=>3+"?T
2.1 Entering Parameter Entry Mode
Parameter entry mode can be initiated by program
control (see section 4.7) or by pressing the encoder
switch push switch as follows:
5TQTQ" N-0:";:+"+2<1K+/"0P.;<:"M21>T"
5TQT5" E13K".;".2"7-0:"710.;.12"-2;.3"e$Kd-0;"N=/=9-
eter Mode” is displayed on LCD screen. This
0:1-3K";=M+"73=<+"P.;:.2"?"0+<12K0T
5TQT?" %+3+=0+";:+"+2<1K+/"7-0:"0P.;<:T
&=>3+"?T"Ob"EC'"[12"@13=;.3+"G=;="];1/=L+
Parameter No Capacity Data Type Value Range
UAQB 16 QR">.;"].L2+K"'2;+L+/ A?5hRi";1"I?5hRh
QRA?Q 16 16 bit Unsigned Integer UARBB?B
?5AYh 16 ?5">.;"].L2+K"'2;+L+/ A"5*QYh*Yi?*RYi";1"I"5*QYh*Yi?*RYh
Adjust Parameter
Mode

©2012 by e-Gizmo Mechatronix Central Page 8 of 16 pagesEZ HMI Display Terminal
2.2 Parameter Entry Mode display Screen
To select and display parameter value:
5T5TQ" N-0:";:+"+2<1K+/"0P.;<:"=0"9=4">+"2+<+0-
0=/4"-2;.3";:+"ejf"0.L2"=77+=/0"12";:+"/.L:;-
most top line position,
5T5T5" %1;=;+";:+"+2<1K+/"0P.;<:"-2;.3";:+"K+0./+K"
parameter number is displayed.
5T5T?" &:+"7=/=9+;+/"=3.=0"=2K".;0"<-//+2;"F=3-+"=/+"
displayed.
To change parameter alias:
5*5*Y" ]+3+<;";:+"7=/=9+;+/"2-9>+/"=0".2"5T5TQA
5T5T?T
5T5TB" C19+2;=/.34"7-0:"]aB"ekf"0P.;<:T"$"<-/01/"
0:1-3K"=77+=/"=;";:+"g/0;"<:=/=<;+/"710.;.12"
of the alias.
5T5TR" %1;=;+";:+"+2<1K+/"0P.;<:"-2;.3";:+"K+0./+K"
character is displayed.
5T5Th" C19+2;=/.34"7-0:"]aB"ekf"0P.;<:T"&:+"<-/-
sor should jump to the next character.
5T5Ti" %+7+=;"?"=2K"Y"-2;.3";:+"K+0./+K"=3.=0".0"<19-
plete.
§ Tips:
!"&:+"<-/01/"0P.;<:"]aY"ejf"=2K"]aB"ekf"<=2">+"
7/+00+K"8/++34";1"31<=;+";:+"<-/01/">=<M"=2K"81/;:";1"
the desired character position. Change character as
desired by rotating the encoder switch.
!"$3.=0"2=9+0"<=2";=M+"-7";1"QU"<:=/=<;+/0T
P Delay(ms) <1
Val: 120
PARAMETER
NUMBER
OPTIONAL
PARAMETER ALIAS
(SET BY USER)
PARAMETER VALUE
SELECT PARAMETER
NUMBER INDICATOR
]aB
P _ <0
Val: 120
ALIAS EDIT
CURSOR

©2012 by e-Gizmo Mechatronix Central
N=L+"^"18"QR"7=L+0 EZ HMI Display Terminal
To change/enter parameter value
5T5T^" ]+3+<;";:+"7=/=9+;+/"2-9>+/"=0"K+0</.>+K".2"
5T5TQA5T5T?T
5T5TQU" C19+2;=/.34"7-0:";:+"+2<1K+/"0P.;<:"-2;.3"
;:+"ejf"9=/M+/"=77+=/0"12";:+">1;;19"3.2+"
rightmost position.
5T5TQQ" N/+00";:+"<-/01/"710.;.12"0P.;<:"]aY"ejf"1/"
]aB"ekf";1"710.;.12";:+"<-/01/";1";:+"K+0./+K"
digit position.
5T5TQ5" %1;=;+";:+"+2<1K+/"-2;.3";:+"K+0./+K"F=3-+".0"
displayed.
To Exit Parameter Entry Mode
5T5TQ?" C19+2;=/.34"7/+00"]a5"-2;.3"e]=F+"D:=2L-
+0lf"9+00=L+"=77+=/0T"&:+"m+0([1(D=2<+3"
selection should also appear on the bottom
line.
5T5TQY" N/+00"<-/01/"0P.;<:"]aY"ejf"1/"]aB"ekf"
until the cursor coincides with the desired
response.
5T5TQB" N/+00"]a?";1"+2;+/";:+"<:1.<+"=2K"+c.;T
Exit Selection:
Yes – To save all changes to non-volatile
memory
No – To exit without saving to non-volatile
memory. The edited data will remain in effect
but will be reset to the last saved values once
;:+"71P+/".0"<4<3+K"6))";1"6[T
Cancel"n"%+A+2;+/"7=/=9+;+/"+K.;"91K+T
Important: The edit parameter mode exits with a
cleared LCD display. User application program must
reload the display to its previous condition upon
exiting this function. User application program can
detect this condition by using the Ttest function as
described in the communications section.
§ Tips:
!"&:+"212AF13=;.3+"9+91/4"<=2">+"/+P/.;;+2"-7";1"
QUU*UUU";.9+0T"
!"m1-/":10;"<12;/133+/"<=2"/+=K";:+"7=/=9+;+/"+F+2"
P:.3+".;".0">+.2L"=Kd-0;+KT"]++"0+<;.12"YTi"81/"91/+"
details.
P MyParameter10
Val: 3726<
_
SW4 “<” OR SW5 “>”
TO MOVE CURSOR POSITION
]a5""""""]a?""""""j"]aY"""""]aB"k
Save Changes?
Yes/No/Cancel
_

©2012 by e-Gizmo Mechatronix Central N=L+"QU"18"QR"7=L+0EZ HMI Display Terminal
3. DIALOG/USER INPUT MODE
&:+"G.=31L"8-2<;.12"7/1F.K+0"=",-.<M"P=4"81/"41-/"
applications programs to collect user input data. You
<=2"3=-2<:".;"P.;:"=24"7/197;"9+00=L+"41-"3.M+*"3.9-
ited only by the 16 characters the LCD can display.
It can accept numeric and alphanumeric user input
up to 14 characters in length.
The Dialog function can only be launched under a
user application program control. It has two operat-
.2L"91K+0*"91K+"U".0";:+"0.973+/"18";:+";P1*"3.9.;-
.2L";:+"-0+/";1"="m+0([1(D=2<+3"/+07120+T"C1K+"Q"
allows the user to enter numeric or alphanumeric
.27-;0T"]++"0+<;.12"YT^"81/"91/+"K+;=.30T"&:.0"0+<;.12"
will discuss the function at the user interaction level
only.
3.1 Mode 0: Yes/No/Cancel response
?TQTQ" N/+00"<-/01/"0P.;<:"]aY"ejf"1/"]aB"ekf"
until the cursor coincides with the desired
response.
?TQT5" N/+00"]a?";1"0+2K";:+"0+3+<;+K"/+07120+"
and exit Dialog mode.
3.2 Mode 1: Numeric/Alphanumeric
In this mode, the input character set is divided into
;:/++"L/1-70";1"9=M+"9+00=L+"<19710.;.12";=0M"
easier. The active input character set selection is in-
dicated by a single character on the leftmost position
of the bottom line:
" ["A" [-9>+/"=2K"]49>130
" $"A" D=7.;=3"3+;;+/0"=2K"eopqrf
" ="A" 31P+/<=0+"3+;;+/0"=2K"estuf"
?T5TQT" N/+00"]a5"/+7+=;+K34"=0"9=4">+"2+<+00=/4"
until the desired character input set is se-
lected.
?T5T5T" %1;=;+";:+"+2<1K+/"0P.;<:"-2;.3";:+"K+0./+K"
character is displayed.
?T5T?" N/+00"<-/01/"0P.;<:"]aB"ekf";1"71.2;";:+"
cursor to the next character position. You can
-0+";:+"<-/01/"0P.;<:"]aY"ejf"1/"]aB"ekf"
;1"0M.7"1/"L1">=<M";1"=24"710.;.12"P.;:.2";:+"
input display area.
?T5TY" %+7+=;"0;+70"QA?"-2;.3";:+"K+0./+K".27-;".0"
completed.
?T5TB" C19+2;=/.34"7/+00"]a?";1"0+2K".27-;"9+0-
sage and exit Dialog mode
MyPrompt
Yes/No/Cancel
_
]a5""""""]a?""""""j"]aY"""""]aB"k
MyPrompt
N UserInput1234
_
USE < SW4 OR SW5>
TO MOVE CURSOR
Important: &:+"G.=31L")-2<;.12"+c.;0"P.;:"="<3+=/+K"
LCD display. User application program must reload
the display to its previous condition upon exiting this
function. User application program can detect this
condition by using the Ttest function as described in
0+<;.12"YTBT

©2012 by e-Gizmo Mechatronix Central
Page 11 of 16 pages EZ HMI Display Terminal
4. COMMUNICATIONS FUNCTIONS
Communications settings:
v=-K"%=;+W" ^RUU
Data: 8 Bit
Parity: none
E=2K0:=M+W" 212+
Summary of Functions
c - Clear Display
Q" A"G.073=4";1"3.2+"U"H&17"%1PJ
5" A"G.073=4";1"3.2+"Q"Hv1;;19"%1PJ
?" A"D3+=/"w"G.073=4";1"3.2+"U
4 - Clear & Display to line 1
k" A"]+;"N/.2;"];=/;"710.;.12
9" A"]</133"G.073=4";1"3.2+"U
C" A"]</133"G.073=4";1"3.2+"Q
p - Goto Edit Parameter Mode
/" A"%+=K"N=/=9+;+/0
M" A"%+=K"="Z+4"H12+"0:1;"91K+J
Z" A"%+=K"="M+4"H3+F+3"91K+J
+" A"%+=K"-0+/"+2<1K+/
O" A"a/.;+"-0+/"+2<1K+/"F=3-+
v" A"]+;"v=<M3.L:;"v/.L:;2+00"UAQ^
T - Test
G" A"G.=31L"v1c(#0+/"'27-;
]" A"]+;"$-c"6-;7-;
%" A"%+0+;"$-c"6-;7-;
'" A"%+=K"$-c"'27-;
&:+"g/0;"<:=/=<;+/"=8;+/";:+"q]&Xr""9=/M+/".0"="0.2L3+"
<:=/=<;+/"8-2<;.12"07+<.g+/T"O=<:";/=209.00.12"9=4"
<12;=.2"d-0;"="8-2<;.12"07+<.g+/"1234*"1/"9=4"<12;=.2"
="0+/.+0"18"K=;=".2"=KK.;.12";1";:+"8-2<;.12"07+<.g+/T"
End of transmission is signaled by the qO&Xr9=/M+/T
q]&Xr and qO&Xr"=/+"K=;="7=<M+;"9=/M+/0"=2K"0:1-3K"
not be transmitted as literal string. They should be
0+2K".2";:+./"$]D''"/+7/+0+2;=;.12T"&:+"<1//+<;"P=4"
of transmitting the q]&Xr and qO&Xr"9=/M+/0"=/+"0:1P2"
in the following example:
Example 1: Clear LCD Display
Transmission Format: q]&Xrcq]&Xr
&:.0"0:1-3K">+";/=209.;;+K".2";:+./"$]D''"<1K+"/+7/+-
sentation as shown in the following table:
]49>13 ]&X c ETX
Hex UcU5 UcR? UcU?
@.0-=3"v=0.<W
Correct:
" ]+/.=3QT7/.2;H<:/H5JIfcfI<:/H?JJ
" a/12LW
" ]+/.=3QT7/.2;Heq]&XrcqO&XrfJ
Arduino:
Correct:
" ]+/.=3TP/.;+HUcU5Jx
" ]+/.=3T7/.2;Hec”);
" ]+/.=3TP/.;+HUcU?Jx
" a/12LW
" ]+/.=3T7/.2;Heq]&XrcqO&XrfJx
Line (Top Row)0
Line (Bot Row)1_
Important:
Communications Format
OF+/4"7=<M+;"18"K=;=";/=209.00.12"H=2K"/+07120+J"
are wrapped inside an q]&Xr"and qO&Xr"9=/M+/T"
q]&Xr"n"];=/;"18";/=209.00.12"9=/M+/*"$]D''"F=3-+""y"
UcU5
qO&Xr"n"O2K"18";/=209.00.12"9=/M+/*"$]D''"F=3-+""y"
UcU?

©2012 by e-Gizmo Mechatronix Central N=L+"Q5"18"QR"7=L+0EZ HMI Display Terminal
Oc=973+"5W"G.073=4"eE+331"a1/3Kzf"12";17"3.2+
&/=209.00.12")1/9=;W"q]&Xr1E+331"a1/3KzqO&Xr
@.0-=3"v=0.<W
ASCII ]&X 1 H e l l o ao r l d zETX
Hex UcU5 Uc?Q UcYi UcRB UcR< U<R< UcR8 Uc5U UcBh UcR8 Uch5 UcR< UcRY Uc5Q UcU?
]+/.=3QT7/.2;H<:/H5JIf1E+331"a1/3KzfI<:/H?JJ"
Arduino:
" ]+/.=3TP/.;+HUcU5Jx" " ((q]&Xr
" ]+/.=3T7/.2;He1E+331"a1/3KzfJx"" ((QE+331"a1/3Kz
" ]+/.=3TP/.;+HUcU?Jx" " ((qO&Xr
$3;+/2=;+34*"41-"<=2"-0+";:+"D($/K-.21"e{f"17+/=;1/"
;1"0+2K";:+"$]D''"<1K+"18"q]&Xr and qO&Xr, together
with the function and data:
" ]+/.=3T7/.2;He{UU51E+331"a1/3Kz{UU?fJx"
P:+/+W"e{UU5f"y"q]&Xr*"e{UU?f"y"qO&Xr
Notice that in both example, only the q]&Xr and qO&Xr"
9=/M+/"2++K";1">+"<12F+/;+K"9=2-=334";1";:+./"$]D''"
code, for the simple reason that they have no equiv-
alent printable characters. The three line implemen-
;=;.12"H312L":=2K"81/9=;J"9=4"9=M+"41-/"7/1L/=9"
longer, but is more human readable. Hence, for clar-
ity, all example codes given are shown in the long
81/9=;T"a+"3+=F+".;"-7";1"41-".8"41-"P=2;";1"<1K+".;".2"
short format.
Function Description
4.1. c- Clear LCD
Clear LCD display
Note: This function is not available while the EZ HMI
.0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+"1/"P:.3+".2"G.=31L"
mode.
)1/9=;W"" q]&XrcqO&Xr
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" 6Z"n"%+=K4
Example (Arduino):
" ]+/.=3TP/.;+HUcU5Jx" ((STX code
" ]+/.=3T7/.2;HecfJx" ((c – Clear LCD function
" ]+/.=3TP/.;+HUcU?Jx" ((ETX code
YT5T" >"A"]+;"N/.2;.2L"];=/;"N10.;.12"
Note: This function is not available while the EZ HMI
.0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+"1/"P:.3+".2"G.=31L"
mode.
)1/9=;W" q]&Xr>nnqO&Xr
a:+/+W"
" 22"y"0;=/;"7/.2;"710.;.12*"UAQB
" " U"A"3+8;"910;"710.;.12
" " QB"n"/.L:;910;"710.;.12
" " G+8=-3;"F=3-+yU
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" 6Z"n" %+=K4
" O%%"A""N/.2;"];=/;"710.;.12".2F=3.K
Example:
]+;"7/.2;"0;=/;"710.;.12";1"QU;:"<:=/=<;+/".2"="3.2+
(Arduino):
" ]+/.=3T7/.2;HUcU5Jx" ((q]&Xr
" ]+/.=3T7/.2;He>”);
" ]+/.=3T7/.2;HeQUfJx
" ]+/.=3T7/.2;HUcU?Jx" ((qO&Xr

©2012 by e-Gizmo Mechatronix Central
N=L+"Q?"18"QR"7=L+0 EZ HMI Display Terminal
YT?T" N/.2;.2L(G.073=4")-2<;.120
1"n"N/.2;";1"S.2+"U"H&17"%1PJ
2"n"N/.2;";1"S.2+"Q"Hv1;;19"%1PJ
3"n"D3+=/"=2K";:+2"N/.2;"9+00=L+";1"S.2+"U
4- Clear and then Print message to Line 1
Note: These functions are not available while the
Ob"EC'".0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+"1/"P:.3+".2"
Dialog mode.
Message can contain any printable characters up
to 16 characters long. Long messages will be auto-
matically truncated to 16 characters.
)-2<;.120"1and 2will simply write over any pre-
+c.0;.2L"9+00=L+"12"="3.2+*";=M.2L";:+"07=<+"18"1234"
;:10+"2++K+K">4";:+"3=;+0;"9+00=L+T")1/"+c=973+*".8"
41-/"7/1L/=9"K.073=4+K"e];/.2L"&:+1/4f"12"3.2+"Q">+-
81/+:=2K*"=2K"41-"7/.2;"=21;:+/"9+00=L+"=0"eQ5?f*"
;:+"/+0-3;"P.33">+"eQ5?.2L"&:+1/4fT"&:.0"8+=;-/+".0"
useful for programs that need to refresh just a small
portion of the displayed message from time to time.
';":+370"/+K-<+"0</++2"/+8/+0:"|.<M+/T"
Use functions 3and 4if you want to erase all pre-
existing message on a line before printing the new
message.
Use >"N/.2;"];=/;"N10.;.12"8-2<;.12">+81/+"<=33.2L"=24"
one of the printing functions if you want to start print-
ing on any arbitrary position along the line.
)1/9=;W"" q]&Xr1wqO&Xr
a:+/+W"
" Py"-0+/"9+00=L+*"-7";1"QR"<:=/=<;+/0"312L
Example 1 (Arduino):
G.073=4"e`?`?912f";1"3.2+"U
" ]+/.=3TP/.;+HUcU5Jx" //STX code
" ]+/.=3T7/.2;He1”); // 1 – print to line 0 function
" ]+/.=3T7/.2;He`?`?912fJx" // w
" ]+/.=3TP/.;+HUcU?Jx" //ETX
Alternatively:
" ]+/.=3T7/.2;He{UU51`?`?912{UU?fJx
Oc=973+"5"H$/K-.21JW"
G.073=4"e+A\.}91f";1"3.2+"Q"2+=/"<+2;+/"710.;.12
// Set start position
" ]+/.=3TP/.;+HUcU5Jx" //STX code
// Start printing on 4th character position
" ]+/.=3T7/.2;He>”);
" ]+/.=3T7/.2;HeYfJx"
" ]+/.=3TP/.;+HUcU?Jx" //ETX
// clear line & print message
" ]+/.=3TP/.;+HUcU5Jx" " //STX code
// 4 – clear print to line 1 function
" ]+/.=3T7/.2;He4”);
" ]+/.=3T7/.2;He+A\.}91fJx" // m=e-Gizmo
" ]+/.=3TP/.;+HUcU?Jx" " //ETX
YTY" ]</133.2L"G.073=4")-2<;.120
m"n"K.073=4"="0</133.2L"9+00=L+";1"3.2+"U
M– display a scrolling message to line 1
Note: This function is not available while the EZ HMI
.0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+"1/"P:.3+".2"G.=31L"
mode.
Long messages can be displayed on a line using
;:+"]</133.2L"G.073=4")-2<;.12T"C+00=L+0"-7";1"h^"
characters long can be displayed on a line.
Tips:
!"]</133.2L"9+00=L+".0"91/+"/+=K=>3+".8"7/+<+K+K">4"
QB">3=2M"07=<+0T"
!"S1P+/"SDG"<12;/=0;".8";:+"<:=/=<;+/0"=77+=/"1F+/-
lapping as they are scrolled.
)1/9=;W"" q]&XrmwqO&Xr
q]&XrMwqO&Xr
a:+/+W"
Py"-0+/"9+00=L+*"-7";1"h^"<:=/=<;+/0"312L
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" 6Z"A"%+=K4

©2012 by e-Gizmo Mechatronix Central Page 14 of 16 pagesEZ HMI Display Terminal
Example 1 (Arduino):
]</133.2L"G.073=4"eN/1L/=99+/0":=F+"91/+"8-2zf";1"
line 1
" ]+/.=3TP/.;+HUcU5Jx" //STX code
// M – scrolling display to line 1 function
" ]+/.=3T7/.2;HeM”);
" ]+/.=3T7/.2;HeN/1L/=99+/0":=F+"91/+"8-2zfJx"
" ]+/.=3TP/.;+HUcU?Jx" //ETX
YTBT" T"n"&+0;"D199-2.<=;.12"S.2M
#0+";1";+0;";:+"<199-2.<=;.120"3.2M"=2K"K+;+/9.2+"
device status.
)1/9=;W"" q]&XrTqO&Xr
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" OG'&""y"<-//+2;34".2"+K.;"91K+
" G'$"""y"<-//+2;34".2"K.=31L"91K+
" %O)""y"K.073=4"/+8/+0:"/+,-+0;"H0++"+c73=-
nation below)
" 6Z" y""%+=K4
Tip: The Parameter and Dialog function exits with
=">3=2M"SDG"0</++2T"$33"K=;="K.073=4+K"7/.1/";1";:+"
8-2<;.12"/+,-+0;"=/+"+/=0+KT"&:+"%O)"/+07120+"/+-
minds the user of this condition, and user code must
reload the LCD with the desired display. Any display
8-2<;.12"/+,-+0;"P.33"<3+=/";:+"%O)"<12K.;.12T
4.6. BA"v=<M3.L:;"v/.L;:2+00
&:+"SDG">=<M3.L:;">/.L:;2+00"<=2">+"=Kd-0;+K".2"Qi"
0;+70*"P.;:"Q"0+;;.2L".;";1";:+"K.99+0;"=2K"Q^"H=2K"UJ"
to the brightest setting.
)1/9=;W"" q]&XrBnnqO&Xr
a:+/+W
" 22"n"v/.L:;2+00"3+F+3*"UAQi
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" O%%""" "y".2F=3.K"3+F+3
" 6Z" y""%+=K4
Example (Arduino):
]+;"SDG">=<M3.L:;">/.L:;2+00";1"B
" ]+/.=3TP/.;+HUcU5Jx" //STX code
" ]+/.=3T7/.2;HeB”); // LCD Backlight function
" ]+/.=3T7/.2;HeBfJx" // nn brightness level
" ]+/.=3TP/.;+HUcU?Jx" //ETX
4.7. p- Edit Parameter Mode
Note: This function is not available while the EZ HMI
is in Dialog mode.
EZ HMI has a built-in function that allows you to
enter and save on its non-volatile memory up to 48
040;+9"7=/=9+;+/0"HK=;=JT"]++"0+<;.12"5"eN$%$CO-
&O%]"=2K"N$%$CO&O%"O[&%m"C6GOf"81/"-0=L+"
and details.
Tips:
!"m1-"<=2"/+=K"=24"7=/=9+;+/"P:.3+".;".0">+.2L"91K.-
g+K".2";:+"OK.;"N=/=9+;+/"C1K+T
!"N=/=9+;+/0"F=3-+0"=/+"+c<3-0.F+"81/"-0+/"07+<.g+K"
applications. No stored parameter value has any
.2|-+2<+"12";:+"17+/=;.12"18"Ob"EC'T
)1/9=;W"" q]&XrpqO&Xr
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
EDIT - Currently in Edit Parameter Mode
4.8. r n"%+=K"="7=/=9+;+/
Note: This function is not available while the EZ HMI
is in Dialog mode.
%+=K"="7=/=9+;+/"K=;="8/19"ObAEC'T
)1/9=;W"" q]&XrrnnqO&Xr
a:+/+W
" 22"n"N=/=9+;+/".2K+c*"UAYhT
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
parameter value

©2012 by e-Gizmo Mechatronix Central
N=L+"QB"18"QR"7=L+0 EZ HMI Display Terminal
YT^T" D"n"67+2"="G.=31L"H#0+/"'27-;J
Note: This function is not available while the EZ HMI
.0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+T
&:+"67+2"="G.=31L")-2<;.12"7/1F.K+0"=2"+=04"P=4"
for a user to interact with a host controller. Using this
function, the user can easily display a prompt mes-
sage, and then get the user respond, which may be
="0.973+"m+0([1(D=2<+3"/+07120+*"1/"="[-9+/.<"1/"
$37:=2-9+/.<"-0+/".27-;T"]++"0+<;.12"?"eG'$S6\(
#]O%"'[N#&f"81/"-0=L+"=2K"K+;=.30T
)1/9=;W" "q]&XrDnwqO&Xr
a:+/+W
n – Dialog type:
" " U"n"m+0([1(D=2<+3*
" " Q"n"[-9+/.<($37:=2-9+/.<"H-7";1"QY"
characters)
w- User Prompt (16 character maximum)
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" #0+/"+2;+/+K"2-9+/.<(=37:=2-9+/.<"K=;=
DIA - Entered Dialog mode
Example (Arduino):
D/+=;+"="G.=31L";:=;"/+;-/20"="m([(D"-0+/"/+07120+
" ]+/.=3TP/.;+HUcU5Jx" //STX code
// Dialog with Yes/No/Cancel selection
" ]+/.=3T7/.2;HeD”);
" ]+/.=3T7/.2;HeUfJx
" ]+/.=3T7/.2;He&+0;"'27-;WfJx""// “Test Input:” prompt
" ]+/.=3TP/.;+HUcU?Jx //ETX
YTQUT" k, K"A"%+=K"Z+4
k"n"%+=K"8-2<;.12"M+4"0;=;+"H12+"0:1;"91K+J
K"n"%+=K"8-2<;.12"M+4"0;=;+"H3+F+3"91K+J
Note: This function is not available while the EZ HMI
.0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+"1/"P:.3+".2"G.=31L"
mode.
%+=K";:+"0;=;+"18"=24"12+"18";:+"81-/"8-2<;.120"M+40T"
&:+"M+4"0;=;+"<=2">+"/+=K".2";P1"P=40A"12+"0:1;"
mode kand level mode K.
'2"12+"0:1;"91K+*"="7/+00+K"M+4"P.33">+"|=LL+K"=0"
eQf"1234".8".;":=0">++2"K+;+<;+K"=0"21;"7/+00+K"K-/-
.2L"="7/+F.1-0"%+=K"Z+4"/+,-+0;T"'2"1;:+/"P1/K0*"
P:+2+F+/"="M+4".0"7/+00+K*".;"P.33"/+;-/2"="eQf"12";:+"
g/0;"%+=K"Z+4"M"/+,-+0;*"0->0+,-+2;"%+=K"Z+4"k
/+,-+0;"P.33"/+;-/2"="eUf"+F+2".8";:+"=KK/+00+K"M+4"
/+9=.2+K"7/+00+KT"#0+/"9-0;"/+3+=0+";:+"M+4"=2K"
%+=K"Z+4"M"9-0;"0++";:+"M+4".2"/+3+=0+K"0;=;+">+-
81/+".;"<=2"/+71/;".;";1">+".2"7/+00+K"eQf"0;=;+"=L=.2T"
This feature is useful in preventing the host control-
ler from unintentionally repeating the execution of
019+";=0M".2"/+07120+";1"="M+4"<310-/+T
#0+";:+"3+F+3"91K+"Z".8"41-"P=2;";1"/+=K";:+"<-//+2;"
0;=;+"18";:+"=KK/+00+K"M+4T"&:=;".0*"=0"312L"=0";:+"
=KK/+00+K"M+4".0"7/+00+K*"%+=K"Z+4"Kwill report it
.2"eQf"0;=;+"=;"+F+/4"/+,-+0;T"$0"=3P=40*".8";:+"M+4".0"
21;"7/+00+K*".;"P.33">+"/+71/;+K".2"eUf"0;=;+T
)1/9=;W"" q]&XrknqO&Xr
q]&XrKnqO&Xr
a:+/+W
" 2"n"Z+4"[-9>+/"
" " U"n"]a5
" " Q"n"]a?
" " 5"n]aY"ejf
" " ?"n"]aB"ekf
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
" Q"n".8"2"M+4".0"7/+00+K
" U"n"K".8"2"M+4".0"21;"7/+00+K"
" U"A"k".8"2"M+4".0"=3/+=K4"K+;+<;+K"=0"7/+00+K"
=2K"-0+/"M++7"7/+00.2L".;T
" O%%"A".2F=3.K"M+4"2-9>+/
11. e, E"A"%+=K"8/19(a/.;+";1"O2<1K+/"
Note: This function is not available while the EZ HMI
.0".2"N=/=9+;+/"O2;/4"("OK.;"C1K+"1/"P:.3+".2"G.=31L"
mode.
$"-0+/"/+L.0;+/"M++7.2L"="<174"18"+2<1K+/"F=3-+"<=2"
be read and loaded with a value by the user using
this function. The encoder value is a 16-bit signed
integer register which can assume any value with
I?5hRh(A?5hRi"/=2L+T"@=3-+"/1330";1"17710.;+"0.L2"
each time the encoder is adjusted past it minimum
and maximum value.
)1/9=;W"" q]&XreqO&Xr
q]&XrEqO&Xr
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
e"A" ].L2+K"+2<1K+/"F=3-+
E"A" 6Z

©2012 by e-Gizmo Mechatronix Central Page 16 of 16 pagesEZ HMI Display Terminal
YTQ5T" S,R,I""Ob"EC'"$-c.3.=/4"'(6"8-2<;.120
S"n"]+;"=2"Ob"EC'"1-;7-;"HS1L.<"QJ
R"n"%+0+;"=2"Ob"EC'"1-;7-;"HS1L.<"UJ
I n"%+=K"=2"Ob"EC'".27-;
&:+"Ob"EC'":=0"=2"=-c.3.=/4"K.L.;=3"'(6"71/;"H<12-
2+<;1/"NQJA"<120.0;.2L"18"?"1-;7-;"71/;0"=2K"5".27-;"
ports, that you can control and use in your target
applications.
)1/9=;W"" q]&XrSnqO&Xr
q]&XrRnqO&Xr
q]&XrInqO&Xr
a:+/+W
" 2"n"'(6"2-9>+/"
" " 6-;7-;"N1/;
" " """U"n"NDY
" " """Q"nNDB
" " """5n"NDR
Input Port
" " H"a.;:"P+=M"7-33"-7*"21/9=334"eQfJ
" " """U"n"NDh
" " """Q"n"NGU
%+07120+W"H[1;+W"a/=77+K"P.;:"q]&Xr &"qO&Xr)
S,Rfunction
" " 6Z"A"%+=K4"
" " O%%" A'2F=3.K"'(6"2-9>+/
Ifunction
" " U" A"" .27-;"/+=K0"31L.<"U
" " Q" A" .27-;"/+=K0"31L.<"eQf
" " O%%" A" '2F=3.K"'(6"2-9>+/
Example (Arduino):
]+;"NDB";1"31L.<"eQf
" ]+/.=3TP/.;+HUcU5Jx" //STX code
" ]+/.=3T7/.2;HeS”); // Set an output
" ]+/.=3T7/.2;HeQfJx" // output 1 = PC5
" ]+/.=3TP/.;+HUcU?Jx" //ETX
Oc=973+"H$/K-.21JW"%+=K"0;=;+"18"NDh"
" ]+/.=3TP/.;+HUcU5Jx" //STX code
" ]+/.=3T7/.2;HeI”); // Read an INPUT
" ]+/.=3T7/.2;HeUfJx" // input 0 = PC7
" ]+/.=3TP/.;+HUcU?Jx" //ETX