e-Gizmo EZ HMI Reference Manual

e-Gizmo
EZ HMI Display Terminal
Technical Manual and Communication Functions Reference Manual
%+FT"Q/U
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.
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.
!"#$%&"'()*"%+,-./+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.
Page 1 of 16 pages
$/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
EZ HMI Display Terminal
CONTROLS and TERMINALS
16CHARACTERSX2LINES
LCDORVFDDISPLAY
EXIT
SELECT
FUNCTIONSWITCHES
UART PORT
<ENTER
>
ROTARY ENCODERSWITCH
WITHPUSHFUNCTION
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
EXT DCINPUT
7.5V-9VDC
AUXDIO
SW2 SW3 SW4 SW5
LCDCONTRAST
ADJUST
UART PORT POWER
Figure 4. EZ HMI showing AUX DIO port location and LCD contrast adjustment.
©2012 by e-Gizmo Mechatronix Central
N=L+"5"18"QR"7=L+0EZ 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
5 PC4 G.L.;=3"6-;7-;"U ? NDB G.L.;=3"6-;7-;"Q 4 PC6 G.L.;=3"6-;7-;"5 B PC7 G.L.;=3"'27-;"U 6 NGU 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.
[1"d-97+/"12"`NQ
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.
PUSH
ROTATE
Pin No: C$%Z'[\ Description 1 TXD #$%&"&X"G$&$"6#&N#&
5 %XG #$%&"%X"G$&$"'[N#& ? GND Ground 4 I@ #$%&"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
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.
N=L+"?"18"QR"7=L+0
©2012 by e-Gizmo Mechatronix Central
EZ HMI Display Terminal
WIRING CONFIGURATIONS
Important:"a./+"3+2L:;0"9-0;"21;"+c<++K"Q"C+;+/.
+5V
SOURCE
HOST CONTROLLER(MICROCONTROLLER)
with5VSupplyVoltage
Figure 6. UART wiring interface with a 5V logic microcontroller host with separate power source.
+5V
TXD
RXD
GND
JUMPERINSTALLED ONJP15VPOSITION
GND
7.5-9.0VDC DCINPUT
HOST CONTROLLER(MICROCONTROLLER)
with5VSupplyVoltagedrawnfromEZHMI
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.
TXD
+5VINPUT
RXD
GND
JUMPERINSTALLED ONJP15VPOSITION
7.5-9.0VDC DCINPUT
©2012 by e-Gizmo Mechatronix Central
Page 4 of 16 pagesEZ HMI Display Terminal
+5V
SOURCE
HOST CONTROLLER(MICROCONTROLLER)
with5VSupplyVoltage
VCC
TXD
RXD
GND
JUMPERINSTALLED ONJP15VPOSITION
GND
Figure 8. The EZ HMI, conversely, can be powered from a +5V sourced by the host controller circuit.
VCC
HOST CONTROLLER(MICROCONTROLLER)
with3.0-3.3VSupplyVoltage
+3.0-3.3V SOURCE
VCC
TXD
RXD
GND
GND
VCC
Figure 9. UART wiring interface to host controllers with 3.0-3.3V working logic levels. Make sure the jumper in JP1 is removed.
7.5-9.0VDC DCINPUT
N=L+"B"18"QR"7=L+0
NOJUMPER!
©2012 by e-Gizmo Mechatronix Central
EZ HMI Display Terminal
Figure 10. EZ HMI Schematic Diagram
©2012 by e-Gizmo Mechatronix Central
Page 6 of 16 pagesEZ 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. 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.
!")-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.
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
AdjustParameter
Mode
]++";:+"]+<;.12"YTQ";1"YTY"81/"91/+"K+;=.30"12";:+"
usage of the display functions
&=>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
Page 7 of 16 pages
©2012 by e-Gizmo Mechatronix Central
EZ HMI Display Terminal
PARAMETER NUMBER
P Delay(ms)<1 Val: 120
2.2 Parameter Entry Mode display Screen
To select and display parameter value:
OPTIONAL
PARAMETER ALIAS
(SET BY USER)
PARAMETERVALUE
SELECT PARAMETER NUMBERINDICATOR
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.
]aB
ALIASEDIT CURSOR
§ 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
©2012 by e-Gizmo Mechatronix Central
P _<0
Val: 120
Page 8 of 16 pagesEZ 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
P MyParameter10 Val: 3726<
SW4“<”ORSW5“>”
TOMOVECURSORPOSITION
]a5""""""]a?""""""j"]aY"""""]aB"k
_
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 T test 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.
SaveChanges?
Yes/No/Cancel
_
N=L+"^"18"QR"7=L+0
©2012 by e-Gizmo Mechatronix Central
EZ 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.
]a5""""""]a?""""""j"]aY"""""]aB"k
MyPrompt
Yes/No/Cancel
_
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 NUserInput
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 T test function as described in
0+<;.12"YTBT
1234
_
©2012 by e-Gizmo Mechatronix Central
N=L+"QU"18"QR"7=L+0EZ 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
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?
_
Arduino:
Correct:
" ]+/.=3TP/.;+HUcU5Jx " ]+/.=3T7/.2;Hec”); " ]+/.=3TP/.;+HUcU?Jx
" a/12LW
" ]+/.=3T7/.2;Heq]&XrcqO&XrfJx
Page 11 of 16 pages
©2012 by e-Gizmo Mechatronix Central
EZ 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 a o r l d z ETX 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
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+
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
(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+"Q5"18"QR"7=L+0EZ HMI Display Terminal
YT?T" N/.2;.2L(G.073=4")-2<;.120
Oc=973+"5"H$/K-.21JW"
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"1 and 2 will 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 3 and 4 if 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
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.
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
N=L+"Q?"18"QR"7=L+0
)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
EZ HMI Display Terminal
Example 1 (Arduino):
4.7. p - Edit Parameter Mode
]</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
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
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
©2012 by e-Gizmo Mechatronix Central
Page 14 of 16 pagesEZ 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
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"K will 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
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.
)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.
%+=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 k and 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";:+"
N=L+"QB"18"QR"7=L+0
)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
EZ 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,R function
" " 6Z"A"%+=K4" " " O%%" A'2F=3.K"'(6"2-9>+/
I function
" " 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
©2012 by e-Gizmo Mechatronix Central
Page 16 of 16 pagesEZ HMI Display Terminal
Loading...