Appendix 4: Programming The Lcm - Lanner HCP-72i1 User Manual

Appendix 4:
Programming the LCM
The LCD panel module (LCM) is designed to provide
real-time operating status and configuration information
for the system. For sample LCM code, see LCM foler in
the Driver and Manual CD. The driver and the program
library can also be found in the folder.
The system supports the following 2 kinds of LCM:
• Parallel Text-based LCM: The LCM connects to the
motherboard's parallel port. The LCD screen can
display 2 lines, 16 (or 20) characters per line.
• USB and Serial Text or Graphic-based LCM: Our next
generation LCM. Lanner engineers design a common
source code to be deployed on these two differently
interfaced LCM modules. Jumpers are used to select
between text and graphic types. See next section.
For Parallel Text-based LCM
Build
To build program source code on Linux platform, please
use the following steps as a guideline:
1. Extract the source file:
# tar -xzvf plcm_drv_v0XX.tgz
(0XX is the version of the program.)
2. Change directory to the extracted folder:
# cd plcm_drv_v0XX
(0XX is the version of the program.)
Note: Apply our Parallel Text-based LCM to the
environment of virtualization, please use the version 013
or above of the program.
3. Type make to build source code:
# make
After compiling, the executable programs (plcm_test,
plcm_cursor_char, ppdev_test, Test) and the driver
(plcm_drv.ko) will appear in the program's folder.
Note: The OS supported by Parallel Text-based LCM
function includes platforms based on Linux Kernel series
2.4.x, Linux Kernel series 2.6.x and Linux Kernel series
3.0.x or above.
www.lannerinc.com
Install
Install the driver and create a node in the /dev directory
by:
#insmod plcm_drv.ko
#mknod /dev/plcm_drv c 248 0
Note:
If you cannot install the driver,
check whether you have enabled the
parallel port in the BIOS setting .
Once the message of "insmod: error
inserting 'plcm_drv.ko': -1 Input/output
error" appears, please check that whether
the major number is repeated or not.
The major number needed with the
mknod command varies with different
software versions; please look up
the Readme file for this value.
Execute
This section contains sample executable programs that
you could test on your platform. It demonstrates some
useful functionality that the LCM provides. Note that the
installation needs to be completed before proceeding
with these executions.
To execute, run the command:
#./plcm_test
Backlight Off/On turning off/on the backlight of the
LCM display
Display Off turning off the LCM display
Cursor Off/On NOT showing/showing the cursor on the
LCM display
Blinking off/On turning off/on the cursor blinking
Writing "Lanner@Taiwan" displaying the specific
sentences
Reading "Lanner@Taiwan" reading the specific sentence
CGram Test displaying the user-stored characters
Keypad Testing Get the keypad input: the 1st button is
read in as Left, the 2nd button is read in as Up, the 3rd
button is read in as Right, and the 4th button is read in as
Down)
111