User guide

DOC101014-1_Hatteland Display API_AIPC.docx rev: 7
Created: 17.11.2011 Modified: 07.10.2013 7 of 27
Hatteland Display AS, Åmsosen, N-5578 Nedre Vats, Norway
Tel: [phone] - [e-mail] - www.hatteland-display.com
Hatteland Display API
All intellectual properties belongs to Hatteland Display AS
• hatteland-hwapi-devel-1.3-334.x86_64.rpm – add-on for developers that contains header files
and static API library.
2.2.4 Installation procedure
In command prompt navigate to the folder where installation packages are located. For 32bit system,
use _x86 files, for 64 bit system x86_64.
For most users first three packages should be installed in this order:
1. hatteland-hwapi-kmod
2. hatteland-hwapi
3. hatteland-hwapi-apps
Every package can be installed with the following command:
rpm –Uvh name of package
3 AIPC
For AIPC architecture the ICH8 (I/O Controller Hub) must communicate with the PCA9555 (I/O
expander) and the Watch dog over the SMBus. The API must interact with the ICH8 on the IO register
space to control the SMBus, and through SMBus read and write to the PCA9555 and Watchdog
registers. With the API properly installed, the user does not need to focus about device address,
interface timing and for some commands even input data.
Figure 1 – System overview (AIPC)
The functions covered in this chapter include:
• Control of Digital IO ports
• Control of Watchdog functions
3.1 Timing
When using the API, avoid sending commands closer than 10mS apart. Avoiding to follow this
instruction might lead to SMBus write/Read errors or even loss of data.
When using the AIPC_Read_GPI command, please make sure that 500mS has passed before the
relays changed state.
3.2 PCA 9555 Functions