Pro-face PS Series User manual

Developer Manual
PS Series Type G
Application Development Kit
(ADK)

1
Preface
Thank you for purchasing Pro-face PS Series Type G Application Development Kit (hereafter referred to as
“ADK”). This manual is the Developer Manual for the ADK, which contains the libraries and definition files
necessary for developing applications that will run on Pro-face PS Series Type G Programmable Operator
Interface (hereafter referred to as “PS-G unit”). Please read this manual thoroughly before using theADK.
© 2001, Digital Electronics Corporation. All rights reserved.
For details concerning trademarks, please refer to “About Trademarks”.
Important
(1) The copyrights to all programs and manuals included in the “PSSeries Type G Application Development Kit
(ADK)”(hereafter referred to as “this product”) are reserved by the Digital Electronics Corporation. Digital
grants theuseof this product to its users as described in the“END-USER LICENSE AGREEMENT”
documentation. Any actions violatingthe above-mentioned agreement is prohibited by both Japanese and foreign
regulations.
(2) The contents of this manual have been thoroughly inspected. However, if you should find any errors or
omissions in this manual, please inform your local representative of your findings.
(3) Regardless of article (2), the Digital Electronics Corporation shall not be held liable by the user for any damages,
losses, or third party claims arisingfrom the uses of this product.
(4) Differences may occur between the descriptions found in this manual and the actual functioningof this product.
Therefore, the latest information on this product is provided in data files (i.e. Readme.txt files, etc.) and in
separate documents. Please consult these sources as well as this manual prior to using the product.
(5) The specifications set out in this manual are for overseas products only. As a result, some differences may exist
between the specifications given here and for those of the identical Japanese product.
(6) Even though the information contained in and displayed by this product may be related to intangible or
intellectual properties of the Digital Electronics Corporation or third parties, the Digital Electronics Corporation
shall not warrant or grant the use of said properties to any users and/or other third parties.

2
Documentation Conventions
In this manual the following warning symbols are used to indicate important points concerning safe and
proper use of the ADK. Prior to operating the ADK, be sure to read these points carefully.
Warning Symbols
This manual’s warning symbols indicate the following levels of danger.
The following mark is used in this manual in addition to the safety and warning symbols.
WARNING
CAUTION
Failure to fully comply with points indicated by this
symbol may result in death or serious injury.
Failure to fully comply with points indicated by this
symbol may result in injury or equipment damage.
Indicates actions or procedures that should NOT be
performed.
Indicates actions or procedures that MUST be performed
to ensure proper operation.
Refers to related information or an additional explanation.

3
Term used in this manual Official Trademarks
Windows 95 Microsoft®Windows 95®operating system
Windows 98 Microsoft®Windows®98 operating system
Windows NT Microsoft®Windows NT®operating system
Windows 2000 Microsoft®Windows®2000 operating system
Windows CE Microsoft®Windows®CE operating system
MS-DOS Microsoft®MS-DOS®operating system
Pentium Intel®Pentium®processors
AcrobatReader 4.0 Adobe®Acrobat®Reader 4.0
eMbedded Visual Tools Microsoft®eMbeddedTM Visual Tools 3.0
eMbedded Visual C++ Microsoft®eMbeddedTM Visual C++®3.0
eMbedded Visual Basic Microsoft®eMbeddedTM Visual Basic®3.0
ActiveSync 3.1 Microsoft®ActiveSync®
3.1
MicrosoftCustom SDK Microsoft®Custom Software Development Kit for Windows®CE,
Version 3.0
Windows CE Platform SDK
(HPC Pro) Microsoft®Software Development Kit for Windows®CE,
Handheld P/C Professional Edition Version 3.01
About Trademarks
The company names and product names described in this manual are referred to in this manual by their
trademarks (including registered trademarks) or service marks. These are abbreviated as follows:
The abbreviated trademarks in this manual correspond to the following official trademarks:
Trademark Holder
Microsoft, MS,Windows, Windows 95,Windows 98,
Windows NT, Windows 2000,Windows CE,
Windows Explorer,eMbedded Visual C++,
eMbedded Visual Basic
Microsoft Corporation
Intel,Pentium Intel Corporation
Pro-face Digital Electronics Corporation
IBM, VGA, PC/AT IBM
Adobe,Acrobat Adobe Systems Incorporated

4
PS Series Type G Model Numbers
The PS Series Type G units consist of the following models.
Please note that the term PS-G in this manual refers only to the PS600G-T41-E124V and the PS400G-T41-
E124V.
The Japanese version of the PS Series Type G Application Development Kit should be used to develop
applications for PS-G units with preinstalled Japanese Windows CE 3.0. To develop applications for
PS-G units with preinstalled English Windows CE 3.0, use the English version of the PS Series Type G
Application Development Kit.
Series Model Description International standards
PS600G-T11-J1 Preinstalled with Windows CE 3.0 (Japanese).
Input voltage AC100V Not supported
PS600G-T41-J124V Preinstalled with Windows CE 3.0 (Japanese).
Input voltage DC24V
CE Marking, UL/c-UL
(CSA) compliant.
PS600G-T41-E124V Preinstalled with Windows CE 3.0 (English).
Input voltage DC24V
CE Marking, UL/c-UL
(CSA) compliant.
PS400G-T41-J124V Preinstalled with Windows CE 3.0 (Japanese).
Input voltage DC24V
CE Marking, UL/c-UL
(CSA) compliant.
PS400G-T41-E124V Preinstalled with Windows CE 3.0 (English).
Input voltage DC24V
CE Marking, UL/c-UL
(CSA) compliant.
PS-600G
PS-400G

5
CD-ROM Contents
The CD-ROM provided with thisADK package contains the following:
Item
PS Series Type G
Application Development Kit
(ADK) Developer Manual
(This manual)
Acrobat Reader 4.0
Microsoft Custom
SDK Standard [Windows CE] library files
PS Series Type G
Platform SDK
(Platform Developer
Components for the
Microsoft Custom
SDK)
Library and header
files that allow
programs such as
RAS, etc. to access
specific PS-G unit
hardware.
ActiveSync 3.1
PS Series Type G
Application Development Kit
(ADK)
Enables communication between the PS-G
unit and the personal computer used for
developing applications.
Description
PDF manual for the PS Series Type G
Application Development Kit (ADK)
Software for viewing PDF files
(Self-extracting file)

6
Usage Precautions
WARNINGS
During Program Development
Do not design emergency stop switches that require activation via the PS-G unit’s touch panel. For
industrial machinery or equipment, installation of a physically activated mechanical-type emergency
switch is likely to be required by law. Also, for devices or equipment other than the above, be sure to
install a safety switch that complies with all relevant laws and regulations.
CAUTIONS
Handling of CD-ROM disk
Be sure to remove the CD-ROM disk before turning your personal computer’s power OFF.
Do not attempt to remove the CD-ROM disc while the drive lamp is lit.
Do not touch the CD-ROM data surface.
Keep this disc away from excessively high or low temperatures, and environments with prolonged high
humidity and dust.
Do not turn OFF your personal computer’s power while a program is running.

7
Table of Contents
Preface...................................................................................................................... 1
Documentation Conventions..................................................................................... 2
About Trademarks..................................................................................................... 3
PS Series Type G Model Numbers ........................................................................... 4
CD-ROM Contents.................................................................................................... 5
Usage Precautions ................................................................................................... 6
Chapter 1 Development Environment
1 Overview............................................................................................................ 1-2
2 Hardware Environment ...................................................................................... 1-3
3 Software Environment ....................................................................................... 1-5
3.1 Development Software............................................................................................ 1-5
3.2 ADK Files ............................................................................................................... 1-6
4 Installing Application DevelopmentTools ........................................................... 1-8
5 Remote Connection Procedure ....................................................................... 1-13
5.1 Personal Computer Settings ................................................................................. 1-13
5.2 PS-G Unit Settings ............................................................................................... 1-16
5.3 Connection ............................................................................................................ 1-17
Chapter 2 Application Development
1 Development using eMbedded Visual C++........................................................ 2-2
1.1 Creating a Project...................................................................................................2-2
1.2 Building and Downloading a Program ..................................................................... 2-5
1.3 Running a Program ................................................................................................ 2-6
2 Development using eMbeddedVisual Basic...................................................... 2-7
2.1 Creating a Project...................................................................................................2-7
2.2 Downloading and Running a Program .................................................................... 2-9
3 Debugging Programs Using the Emulator ....................................................... 2-12
4 Auto Start......................................................................................................... 2-14
Chapter 3 Library Interface Reference
1 Backlight Driver.................................................................................................. 3-3
1.1 Backlight Driver APIs .............................................................................................. 3-3
1.2 Function Specifications........................................................................................... 3-4
2 SRAM Driver...................................................................................................... 3-9
2.1 SRAM Driver APIs .................................................................................................. 3-9
2.2 Function Specifications........................................................................................... 3-9

8
3 GMU-BUS Driver ............................................................................................. 3-14
3.1 GMU-BUS Driver APIs ......................................................................................... 3-14
3.2 Function Specifications......................................................................................... 3-14
4 RAS Driver....................................................................................................... 3-20
4.1 RAS Driver APIs ................................................................................................... 3-20
4.2 Details of Function Specifications ......................................................................... 3-22
4.3 Register Details ................................................................................................... 3-42
5 Touch Panel Driver........................................................................................... 3-46
5.1 Touch Panel Driver APIs ....................................................................................... 3-46
5.2 Function Specifications......................................................................................... 3-46
Index

1
1 Overview
2 Hardware Environment
3 Software Environment
4 Installing Application Development Tools
5 Remote Connection Procedure
Development
Environment

1-2
PS SeriesType G Application Development Kit (ADK) Developer Manual
1 Overview
The Application Development Kit (ADK) containing libraries and definition files used for
developing PS-G unit applications.
The new PS-G unit is a high-performance programmable operator interface that uses the Hitachi
SH4 RISC CPU (200MHz) and is preinstalled with Windows CE 3.0.
To develop applications that will run on the PS-G unit, you will need both the eMbedded Visual
Tools and theADK-software.
eMbedded Visual Tools offer functionality similar to a regular Win32 application development
environment (such as Visual Studio), and allow you to easily create applications for the PS-G unit.
Since you can utilize your Win32 application programming knowledge and use familiar
debugging tools, you can quickly create Windows CE applications for the PS-G unit. Also, the use
of the Windows CEAPI, a subset of the Win32 API, helps to further improve development
efficiency.
•Since the eMbeddedVisual Tools package is not included in the ADK
package, you will need to purchase it separately.
•Certain Win32 APIs cannot be used with Windows CE.For details,
please refer to the MSDN and check whether the APIs you intend to use
are supported byWindows CE.

1-3
1 Development Environment
2 Hardware Environment
The following describes the hardware configuration required for developing and running PS-G
unit applications.
Connect the PS-G unit to a personal computer via the data transfer cable provided with ADK.
This allows an application developed on the personal computer to be easily download to the PS-
G. If the personal computer you are using has a CF Card adaptor, you can run an application on
the PS-G unit after copying it to the CF Card and then loading the card data into the PS-G unit.
A CF Card is also required to save applications downloaded to the PS-G unit or data entered via
the Control Panel of the PS-G unit.
•Use only Digital Electronics Corporation CF Cards.Other vendor CF
Cards may fail to meet PS-G specifications.
•Be sure to back up your CF Card data regularly.
CF Card
GP077-CF20 16MB
GP077-CF30 32MB
PS-G
Personal computer
(application development)
DataTransfer Cable
(provided with ADK)
PSG-CB01

1-4
PS SeriesType G Application Development Kit (ADK) Developer Manual
The following describes the personal computer hardware required to develop applications. Refer
to each package’s hardware environment specifications for details.
<Required Personal Computer Hardware>
CAUTION
Windows 98 is not recommended if you want to both develop and debug
applications, as problems with emulation functions or remote tools may occur
during debugging.When developing applications that require performance of both
the build and the debug process, be sure to use a personal computer running
Windows NT 4.0 orWindows 2000.
Operating System
Computer
Memory
Hard-disk Space
CD-ROM Drive A CD-ROM drive is required.
Windows NT Workstation 4.0 with Service Pack 5 or
later, Windows 2000 Professional, or Windows 98
Second Edition.
Windows compatible PC with Pentium processor
(Pentium 150MHz or faster processor is
recommended)
32MB for Windows NT 4.0 or Windows 2000 (48MB
recommended)
24MB of RAM for Windows 98 (48MB recommended)
Installing eMbedded Visual C++ and Windows CE
Platform SDK (HPC Pro), or eMbedded Visual Basic
and Windows CE Platform SDK (HPC Pro) requires
360MB or more.
Installing the ADK software requires free space of
100MB or more.

1-5
1 Development Environment
3 Software Environment
To develop applications that will run on the PS-G unit, you need both the eMbedded Visual Tools
and the ADK.
The eMbedded Visual Tools contain both eMbedded Visual C++ and eMbedded Visual Basic.
ADK supports both of these visual programming tools.
3.1 Development Software
The following software should be installed when developing applications.
Item
Windows CE
Platform SDK
(HPC Pro)
This program must
be installed to run
Windows CE
applications under
emulation on your
computer.
Microsoft Custom
SDK Standard [Windows CE] library files
PS Series Type G
Platform SDK
(Platform Developer
Components for the
Microsoft Custom
SDK)
Library and header
files that allow
programs such as
RAS, etc. to access
specific PS-G unit
hardware.
ActiveSync 3.1
TCP/IP protocol
Enables communication between the PS-G
unit and the personal computer used for
developing applications.(This program is
included in the ADK package.)
TCP/IP protocol must be used to download
the applications to the emulator via Ethernet
for debugging. (Be sure to set the
appropriate network parameters for your
development environment.)
Description
eMbedded Visual Tools
Install eMbedded Visual C++ or eMbedded
Visual Basic.
PS Series Type G
Application Development Kit
(ADK)

1-6
PS SeriesType G Application Development Kit (ADK) Developer Manual
The eMbedded Visual Tools package contains the following remote tools. These tools allow the
personal computer used for development to acquire necessary information from the PS-G unit
(connected via Microsoft ActiveSync3.1), debug applications and check program operation.
•Remote Spy++ (Spy)
Determines what kind of messages the target device receives or uses to check window
handles, classes, and other items.
•Remote Registry Editor (Registry Editor)
Used for editing the target device registry.
•Remote ZoomIn (Zoom)
Enables you to capture target device screen images and view them on the personal
computer used for developing applications.
•Remote File Viewer (File Viewer)
Enables you to browse files on the target device.
•Remote Heap Walker (Heap Walker)
Checks the heap ID and the current heap.
•Remote Process Viewer (Process Viewer)
Enables you to check the processes, threads and modules that are currently being executed
on the target device, and check for available memory areas.
3.2 ADK Files
Each ADK contains the following two software development kits: Microsoft Custom SDK and PS
Series Type G Platform SDK. After an ADK is installed, individual SDK files are automatically
extracted to the following folders.
Microsoft Custom SDK
Standard library files for Windows CE
\Windows CE Tools \Wce300\Bin
\Psgwce30 \Atl
\Help
\Include
\Lib
\Mfc
\Target
\Template
\Vbsdk

1-7
1 Development Environment
PS Series Type G Platform SDK
\Windows CE Tools \Wce300\Psgwce30\Include\bldrvapi.h
\sramdrvapi.h
\gmudrvapi.h
\rasdrvapi.h
\tchdrvapi.h
\Windows CE Tools \Wce300\Psgwce30\Lib\Sh4\bldrvif.lib
\sramdrvif.lib
\gmudrvif.lib
\rasdrvif.lib
\touchdrvif.lib
\bldrvif.exp
\sramdrvif.exp
\gmudrvif.exp
\rasdrvif.exp
\touchdrvif.exp
\Windows CE Tools \Wce300\Psgwce30\Vbsdk\Sh4\bldrvif.lib
\sramdrvif.lib
\gmudrvif.lib
\rasdrvif.lib
\touchdrvif.lib
\bldrvif.exp
\sramdrvif.exp
\gmudrvif.exp
\rasdrvif.exp
\touchdrvif.exp
\bldrvdef.bas
\sramdrvdef.bas
\gmudrvdef.bas
\rasdrvdef.bas
\touchdrvdef.bas

1-8
PS SeriesType G Application Development Kit (ADK) Developer Manual
4 Installing Application Development Tools
Before installing an ADK, be sure to check that the personal computer to be used for application
development meets the specified requirements by referring to the table <Required Personal
Computer Hardware> in "Chapter 1 2. Hardware Environment."
CAUTION
Windows 98 is not recommended if you want to both develop and debug
applications, as problems with emulation functions or remote tools may occur
during debugging.When developing applications that require performance of both
the build and the debug process, be sure to use a personal computer running
Windows NT 4.0 orWindows 2000.
To install the application development tools, follow the procedure below.
Be sure to follow the procedures given here, in sequence. If you do not, the tools may not operate
correctly.
(1) Install the eMbedded Visual Tools.
(2) Install the ADK for eMbedded Visual C++ or eMbedded Visual.
(3) Install ActiveSync 3.1.
Installing the eMbedded Visual Tools
(1) Install the eMbedded Visual Tools software.
eMbedded Visual Tools contains both eMbedded Visual C++ and eMbedded Visual Basic.
Install either or both, depending on your needs.
Installing the ADK
(1) Insert the ADK CD-ROM into your personal computer's CD-ROM drive and install either the
ADK for eMbedded Visual C++ or eMbedded Visual Basic.
•To install ADK for Visual C++
Install ADK for Visual C++ by double-clicking on the [psgsdk.exe] file located in the CD-
ROM’s [\us\psg-adk\vc] folder. After the installation screen appears, follow each screen’s
instructions.
•To installADK for Visual Basic
Install ADK for Visual Basic by double-clicking on the [psgsdk.exe] file located in the CD-
ROM’s [\us\psg-adk\vb] folder. After the installation screen appears, follow each screen’s
instructions.

1-9
1 Development Environment
Installing ActiveSync 3.1 and connecting with the PS-G unit
(1) Install ActiveSync 3.1 by double-clicking on the [msasync.exe] file located in theADK CD-
ROM's [\us\async] folder, and then follow each screen's instsructions.
As the installation progresses, the computer enters the PS-G connection standby mode.
However, at this stage, do not establish the connection. This is done by not clicking the
button until step (11).
(2) Turn ON the power to the PS-G unit, and connect the data transfer cable (provided with the
ADK) from the COM port on the personal computer to the serial I/F (COM1) on the PS-G
unit.
(3) To open the PS-G unit's Control Panel, click the [Start] button and then point to [Settings].
From the menu that appears, click [Control Panel].
(4) Double click to open the [Communications Properties] screen.

1-10
PS SeriesType G Application Development Kit (ADK) Developer Manual
(5) Enter a name in the [Device name] field so that the PS-G unit will be recognized by the
personal computer.
(6) Click the [PC Connection] tab, and then the button.
(7) Select the desired baud rate setting.
(8) Click the button to register the [Communications Properties] settings.
(9) In the Control Panel, click on the icon to save the remote connection settings to the
CF Card. Then, reboot the PS-G unit.
(10) After the PS-G unit is rebooted, open the [\Windows] folder, located in My Computer.

1-11
1 Development Environment
Personal computer PS-G unit
(11) Click the button on the dialog box that appeared in step (1), and immediately
double-click the icon (connection establishment program).
The connection with the PS-G unit will not be established if the timing of the double-
clicking of is not correct . If the connection fails, the following screen will appear on
both the PC and the PS-G unit. In this case, retry step (11).
Personal computer PS-G unit