Pro-face PS Series Developer's Manual
  1. Manuals
  2. Brands
  3. Pro-face Manuals
  4. Microcontrollers
  5. PS Series
  6. Developer's manual
Pro-face PS Series Developer's Manual

Pro-face PS Series Developer's Manual

Type g application development kit (adk)
Hide thumbs
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PS Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Pro-face PS Series

Summary of Contents for Pro-face PS Series

  • Page 1 PS Series Type G Application Development Kit (ADK) Developer Manual...
  • Page 2 Interface (hereafter referred to as “PS-G unit”). Please read this manual thoroughly before using the ADK. Important (1) The copyrights to all programs and manuals included in the “PS Series Type G Application Development Kit (ADK)” (hereafter referred to as “this product”) are reserved by the Digital Electronics Corporation. Digital grants the use of this product to its users as described in the “END-USER LICENSE AGREEM ENT”...

  • Page 3: Documentation Conventions

    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. Failure to fully comply with points indicated by this WARNING symbol may result in death or serious injury.

  • Page 4: About Trademarks

    Windows NT, Windows 2000, Windows CE, Microsoft Corporation Windows Explorer, eMbedded Visual C++, eMbedded Visual Basic Intel, Pentium Intel Corporation Pro-face Digital Electronics Corporation IBM, VGA, PC/AT Adobe, Acrobat Adobe Systems Incorporated The abbreviated trademarks in this manual correspond to the following official trademarks:...

  • Page 5: Ps Series Type G Model Numbers

    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.

  • Page 6: Cd-Rom Contents

    CD-ROM Contents The CD-ROM provided with this ADK package contains the following: Item Description PS Series Type G PDF manual for the PS Series Type G Application Development Kit Application Development Kit (ADK) (ADK) Developer Manual (This manual) Software for viewing PDF files Acrobat Reader 4.0...

  • Page 7: Usage Precautions

    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.

  • Page 8: Table Of Contents

    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 ..................
  • Page 9 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 ..................

  • Page 10: Overview

    Development Environment 1 Overview 2 Hardware Environment 3 Software Environment 4 Installing Application Development Tools 5 Remote Connection Procedure...
  • Page 11 PS Series Type 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.
  • Page 12 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.
  • Page 13 PS Series Type 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> Windows NT Workstation 4.0 with Service Pack 5 or...

  • Page 14: Development Software

    Platform SDK applications under (HPC Pro) emulation on your computer. Microsoft Custom Standard [Windows CE] library files PS Series Type G Library and header PS Series Type G Platform SDK files that allow Application Development Kit (Platform Developer programs such as...

  • Page 15: Adk Files

    PS Series Type 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.
  • Page 16 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...

  • Page 17: Installing Application Development Tools

    PS Series Type 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>...
  • Page 18 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 the ADK 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.
  • Page 19 PS Series Type 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.
  • Page 20 1 Development Environment (11) Click the button on the dialog box that appeared in step (1), and immediately double-click the icon (connection establishment program). Personal computer PS-G unit The connection with the PS-G unit will not be established if the timing of the double- clicking of is not correct .
  • Page 21 PS Series Type G Application Development Kit (ADK) Developer Manual (12) When the connection is successfully established, the following screen will appear on the PC. Select [No] for [Would you like to set up a partnership?] and click the button.

  • Page 22: Remote Connection Procedure

    1 Development Environment 5 Remote Connection Procedure To transfer a program from the personal computer used for developing applications to the PS-G unit and then debug the program while it is running on the PS-G unit, use ActiveSync 3.1 to establish the connection between the personal computer and the PS-G unit.
  • Page 23 PS Series Type G Application Development Kit (ADK) Developer Manual eMbedded Visual Tools - Platform Manager Configuration From the [Platform Manager Configuration] screen, register a device name in your PC for the PS-G unit. This enables you to designate the PS-G unit as the download destination. The device properties should also be set according to the communication settings.
  • Page 24 1 Development Environment (3) Click the button to display the [Device Properties] dialog box. From [Available Transport Components], select [Microsoft ActiveSync]. If you intend to use Ethernet, select [TCP/IP Transport for Windows CE]. Transfering a program via an Ethernet network greatly shortens the transfer time.

  • Page 25: Ps-G Unit Settings

    PS Series Type G Application Development Kit (ADK) Developer Manual 5.2 PS-G Unit Settings Control Panel - Communications Settings (1) 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].

  • Page 26: Connection

    1 Development Environment (4) Click the [PC Connection] tab, and then the button. (5) Select the desired baud rate setting. (6) Click the button to register and complete the [Communications Properties] settings. (7) In the Control Panel, click on the icon to save the remote connection settings to the CF Card.
  • Page 27 PS Series Type G Application Development Kit (ADK) Developer Manual 1-18...

  • Page 28: Chapter 2 Application Development

    Application Development 1 Development using eMbedded Visual C++ 2 Development using eMbedded Visual Basic 3 Debugging Programs Using the Emulator 4 Auto Start...

  • Page 29: Creating A Project

    PS Series Type G Application Development Kit (ADK) Developer Manual 1 Development using eMbedded Visual C++ The following explains the procedure for using eMbedded Visual C++ to create a simple application to display an on-screen window. 1.1 Creating a Project (1) Start eMbedded Visual C++ and select [New] from the [File] menu.
  • Page 30 2 Application Development (3) Select the necessary items and click the button to proceed to the next step. (4) Again, select the necessary items and click the button to proceed to the next step. (5) Click the button, and the following page's [New Project Information] screen will appear.
  • Page 31 PS Series Type G Application Development Kit (ADK) Developer Manual (6) Click the button and your new project creation is completed.

  • Page 32: Building And Downloading A Program

    2 Application Development 1.2 Building and Downloading a Program Here, as an example we will create a program to display the text "Hello PS Series Type G" in the center of a window. Add the following description to the OnDraw view class.

  • Page 33: Running A Program

    PS Series Type G Application Development Kit (ADK) Developer Manual Program debugged using the PS-G unit (1) Connect the personal computer to be used for development and the PS-G unit via ActiveSync3.1. For details, refer to "Chapter 1 5 Remote Connection Procedure."...

  • Page 34: Development Using Embedded Visual Basic

    2 Application Development 2 Development using eMbedded Visual Basic The following explains the procedure for using eMbedded Visual Basic to create a simple application to display an on-screen window. 2.1 Creating a Project (1) After starting Visual Basic, the following [New Project] dialog box appears. You can also select [New Project] from the [File] menu to display the [New Project] dialog box.
  • Page 35 PS Series Type G Application Development Kit (ADK) Developer Manual (3) After the project type is selected, the following screen will appear. (4) (4) Select [Project 1 - Properties] from the [Project] menu, and the [Project Properties] dialog box will appear.

  • Page 36: Downloading And Running A Program

    2 Application Development 2.2 Downloading and Running a Program Here, we will create a program to display the text "Hello PS Series Type G" in the center of a window. (1) Select a label from the toolbox, and paste it on the form. Input “Hello PS Series Type G” into...
  • Page 37 PS Series Type G Application Development Kit (ADK) Developer Manual (2) Select [Project 1 - Properties] from [Project]. In the [Project Properties] screen that appears, designate a target device from the [Run on Target] pull-down menu. If you intend to debug a program (Windows CE HPC Pro project) by running it using the emulator, select [Handheld PC Pro Emulation].
  • Page 38 2 Application Development (5) After program download is completesd, you can run the program by simply double-clicking the program file's icon. To debug the program, execute the PC's debugger. For details, refer to "Chapter 2 3. Debugging Programs Using the Emulator." It is also possible to run a program that has been copied to a CF Card on the PS-G unit.

  • Page 39: Debugging Programs Using The Emulator

    PS Series Type G Application Development Kit (ADK) Developer Manual 3 Debugging Programs Using the Emulator If you intend to debug a program without using the PS-G unit’s special hardware interfaces (such as RAS or the touch panel), you can effectively debug the program using the emulator included in the Windows CE Platform SDK (HPC Pro) in your PC.
  • Page 40 2 Application Development • Debugging can be started by simply clicking the saved exec file. You can also debug the program by running it to a specified break point, set earlier via the eMbedded Visual Tools debug feature. • To close the emulator, click [Suspend] in the [Start] menu. 2-13...

  • Page 41: Auto Start

    PS Series Type G Application Development Kit (ADK) Developer Manual 4 Auto Start An application can be automatically started when the PS-G unit is turned ON. The following explanation describes this procedure. To automatically start an application in object store memory (1) Create a shortcut for the application and place it in the PS-G’s [\Windows\Startup] folder, or...

  • Page 42: Chapter 3 Library Interface Reference

    Library Interface Reference 1 Backlight Driver 2 SRAM Driver 3 GMU-BUS Driver 4 RAS Driver 5 Touch Panel Driver...
  • Page 43 PS Series Type G Application Development Kit (ADK) Developer Manual To use the PS-G unit’s special hardware interfaces in your applications, the required header file(s) should be included in the application’s source file so that the necessary interface library files can be linked to the object file.

  • Page 44: Backlight Driver Apis

    3 Library Interface Reference 1 Backlight Driver The function of this driver is to set and control the backlight status. This driver’s functionality is equivalent to the control panel icon. 1.1 Backlight Driver APIs API name Description GetBLDriverVersion Retrieves driver version information BLDriverOpen Opens the backlight driver BLDriverClose...

  • Page 45: Function Specifications

    PS Series Type G Application Development Kit (ADK) Developer Manual 1.2 Function Specifications GetBLDriverVersion Call format BOOL WINAPI GetBLDriverVersion (WORD *pMajor, WORD *pMinor) Return value TRUE: Normal FALSE: Error Argument WORD *pMajor Pointer to the version information (Major, 0 to 99)
  • Page 46 3 Library Interface Reference BLDriverClose Call format BOOL WINAPI BLDriverClose (void) Return value TRUE: Normal FALSE: Error Argument None Processing performed Closes the backlight driver, disabling setting operations. However, the thread operation of the driver continues. E.g.) BOOL ret = BLDriverClose ( ); GetBLStatus Call format BOOL WINAPI GetBLStatus (BYTE *pStatus)
  • Page 47 PS Series Type G Application Development Kit (ADK) Developer Manual SetBLOnOff Call format BOOL WINAPI SetBLOnOff (BOOL bSwitch) Return value TRUE: Normal FALSE: Error Argument BOOL bSwitch TRUE: Turns the backlight ON. FALSE: Turns the backlight OFF. Processing performed Controls the backlight.
  • Page 48 3 Library Interface Reference SetBLAction Call format BOOL WINAPI SetBLAction (BYTE Action) Return value TRUE: Normal FALSE: Error Argument BYTE Action D2: Input from touch panel 1: Enabled 0: Disabled D1: Input from keyboard 1: Enabled 0: Disabled D0: Input from mouse 1: Enabled 0: Disabled Processing performed...
  • Page 49 PS Series Type G Application Development Kit (ADK) Developer Manual SetBLTmOut Call format BOOL WINAPI SetBLTmOut (DWORD TmOut) Return value TRUE: Normal FALSE: Error Argument DWORD TmOut Specified timer value for turning the backlight OFF in the case of idle time...

  • Page 50: Sram Driver

    3 Library Interface Reference 2 SRAM Driver The function of this driver is to read/write data from/to SRAM. Up to 256KB is available. If a function’s return value exceeds 256KB during access, an error will occur. 2.1 SRAM Driver APIs API name Description GetSramDriverVersion...
  • Page 51 PS Series Type G Application Development Kit (ADK) Developer Manual SramDriverOpen Call format BOOL WINAPI SramDriverOpen (void) Return value TRUE: Normal FALSE: Error Argument None Processing performed Opens SRAM driver, enabling driver operations. E.g.) BOOL ret = SramDriverOpen ( );...
  • Page 52 3 Library Interface Reference SramByteRead Call format BOOL WINAPI SramByteRead (DWORD Offset, BYTE *pData) Return value TRUE: Normal FALSE: Error Argument DWORD Offset Offset from the beginning of SRAM to the data to be read (in byte units) (0 to 3ffffh) BYTE *pData Pointer to the address where readout will be stored Processing performed...
  • Page 53 PS Series Type G Application Development Kit (ADK) Developer Manual SramLongRead Call format BOOL WINAPI SramLongRead (DWORD Offset, DWORD *pData) Return value TRUE: Normal FALSE: Error Argument DWORD Offset Offset from the beginning of SRAM to the data to be read (in double word...
  • Page 54 3 Library Interface Reference SramWordWrite Call format BOOL WINAPI SramWordWrite (DWORD Offset, WORD Data) Return value TRUE: Normal FALSE: Error Argument DWORD Offset Offset from the beginning of SRAM to the destination of the data to be written (in word units) (0 to 1ffffh) WORD Data Data to be written...

  • Page 55: Gmu-Bus Driver

    PS Series Type G Application Development Kit (ADK) Developer Manual 3 GMU-BUS Driver This driver provides GMU-BUS control. Interrupt support is provided via registration of the user callback routine. 3.1 GMU-BUS Driver APIs API name Description GetGmuDriverVersion Retrieves the driver version.
  • Page 56 3 Library Interface Reference GmuDriverOpen Call format BOOL WINAPI GmuDriverOpen (void) Return value TRUE: Normal FALSE: Error Argument None Processing performed Opens the GMU-BUS driver, enabling driver operations. E.g.) BOOL ret = GmuDriverOpen ( ); GmuDriverClose Call format BOOL WINAPI GmuDriverClose (void) Return value TRUE: Normal FALSE: Error...
  • Page 57 PS Series Type G Application Development Kit (ADK) Developer Manual GmuByteRead Call format BOOL WINAPI GmuByteRead (DWORD Offset, BYTE *pData) Return value TRUE: Normal FALSE: Error Argument DWORD Offset Offset from the beginning of the GMU to the data to be read (in byte units)
  • Page 58 3 Library Interface Reference GmuLongRead Call format BOOL WINAPI GmuLongRead (DWORD Offset, DWORD *pData) Return value TRUE: Normal FALSE: Error Argument DWORD Offset Offset from the beginning of the GMU to the data to be read (in double word units) DWORD *pData Pointer to the address where readout will be stored Processing performed...
  • Page 59 PS Series Type G Application Development Kit (ADK) Developer Manual GmuWordWrite Call format BOOL WINAPI GmuWordWrite (DWORD Offset, WORD Data) Return value TRUE: Normal FALSE: Error Argument DWORD Offset Offset from the beginning of the GMU to the destination of the data to be...
  • Page 60 3 Library Interface Reference SetGmuCallbackIntA Call format BOOL WINAPI SetGmuCallbackIntA (GMUPROC lpCallbackFunc) Return value TRUE: Normal FALSE: Error Argument GMUPROC lpCallbackFunc Long pointer to the interrupt processing function When set to NULL, cancels the registration of the function selected for interrupt processing. Processing performed Registers the function used for interrupt processing when a GMU IntA occurs.

  • Page 61: Ras Driver

    PS Series Type G Application Development Kit (ADK) Developer Manual 4 RAS Driver This driver provides RAS function control. It supports the watchdog timer, remote reset input, standard signal inputs (two), standard signal output (one), and alarm output (one). Each of the actions to be performed can also be designated from the control panel. This driver provides functions equivalent to the control panel.
  • Page 62 3 Library Interface Reference <Watchdog timer functions> Setting/display API name Description dialog control resister/registry User application SetWdtControl Starts/stops the watchdog timer. WDT_CNTL Retrieves the start/stop setting for GetWdtControl WDT_CNTL the watchdog timer. Retrieves the information on GetWdtTimeout occurrence of the watchdog timer WDT_STT time-out.

  • Page 63: Details Of Function Specifications

    PS Series Type G Application Development Kit (ADK) Developer Manual 4.2 Details of Function Specifications <Common functions> GetRasDriverVersion Call format BOOL WINAPI GetRasDriverVersion (WORD *pMajor, WORD *pMinor) Return value TRUE: Normal FALSE: Error Argument WORD *pMajor Pointer to the version information (Major, 0 to 99)
  • Page 64 3 Library Interface Reference RasDriverClose Call format BOOL WINAPI RasDriverClose (void) Return value TRUE: Normal FALSE: Error Argument None Processing performed Closes the RAS driver, disabling setting operations. However, driver thread operation continues. E.g.) BOOL ret = RasDriverClose ( ); BuzzerControl Call format BOOL WINAPI BuzzerControl (short length)
  • Page 65 PS Series Type G Application Development Kit (ADK) Developer Manual AlarmControl Call format BOOL WINAPI AlarmControl (BOOL bSwitch) Return value TRUE: Normal FALSE: Error Argument BOOL bSwitch TRUE: ALARMOUT output FALSE: Stops ALARMOUT output Processing performed Controls the ALARMOUT port.
  • Page 66 3 Library Interface Reference SetRasRegister Call format BOOL WINAPI SetRasRegister (WORD RegNo, BYTE Data) Return value TRUE: Normal FALSE: Error Argument WORD RegNo Register designation *1 BYTE Data Data to be set in the register Register designation #define RAS_IN_MASK 0 #define RAS_IN_OUT #define WDT_CR #define WDT_COUNT...
  • Page 67 PS Series Type G Application Development Kit (ADK) Developer Manual <Watchdog timer functions> SetWdtEnable Call format BOOL WINAPI SetWdtEnable (BOOL bEnable) Return value TRUE: Normal FALSE: Error Argument BOOL bEnable TRUE: Enables the watchdog timer. FALSE: Disables the watchdog timer.
  • Page 68 3 Library Interface Reference SetWdtCounter Call format BOOL WINAPI SetWdtCounter (BYTE Counter) Return value TRUE: Normal FALSE: Error Argument BYTE Counter Initial counter value (5 to 255) for the watchdog timer (in sec.) Processing performed Sets the initial counter value for the watchdog timer. (WDT COUNT) E.g.) // Sets 10 seconds as the initial counter value for the watchdog timer.
  • Page 69 PS Series Type G Application Development Kit (ADK) Developer Manual SetWdtMask Call format BOOL WINAPI SetWdtMask (BOOL bMask) Return value TRUE: Normal FALSE: Error Argument BOOL bMask TRUE: Sets the mask for the watchdog timer alarm. FALSE: Removes the mask for the watchdog timer alarm.
  • Page 70 3 Library Interface Reference SetWdtBuzzer Call format BOOL WINAPI SetWdtBuzzer (BOOL bBuzzer) Return value TRUE: Normal FALSE: Error Argument BOOL bBuzzer TRUE: Enables the buzzer. FALSE: Disables the buzzer. Processing performed Enables/disables the buzzer to operate in the event of watchdog timer time-out. E.g.) BOOL ret = SetWdtBuzzer (TRUE);...
  • Page 71 PS Series Type G Application Development Kit (ADK) Developer Manual SetWdtReboot Call format BOOL WINAPI SetWdtReboot (BOOL bReboot) Return value TRUE: Normal FALSE: Error Argument BOOL bReboot TRUE: Enables reboot. FALSE: Disables reboot. Processing performed Enables/disables reboot in the event of watchdog timer time-out.
  • Page 72 3 Library Interface Reference GetWdtPopup Call format BOOL WINAPI GetWdtPopup (BOOL *pPopup) Return value TRUE: Normal FALSE: Error Argument BOOL *pPopup Pointer to the pop-up message setting Processing performed Retrieves the setting for whether or not the pop-up message is enabled to appear in the event of watchdog timer time-out.
  • Page 73 PS Series Type G Application Development Kit (ADK) Developer Manual GetWdtMessage Call format BOOL WINAPI GetWdtMessage (wchar_t *pMessage) Return value TRUE: Normal FALSE: Error Argument wchar_t *pMessage Pointer to the pop-up message storage area Processing performed Retrieves the pop-up message which appears in the event of watchdog timer time-out.
  • Page 74 3 Library Interface Reference GetWdtControl Call format BOOL WINAPI GetWdtControl (BOOL *bCont) Return value TRUE: Normal FALSE: Error Argument BOOL *bCont Pointer to the start/stop setting of the watchdog timer TRUE: The watchdog timer has been started. FALSE: The watchdog timer has been stopped. Processing performed Retrieves the start/stop setting of the watchdog timer.
  • Page 75 PS Series Type G Application Development Kit (ADK) Developer Manual ClearWdtTimeout Call format BOOL WINAPI ClearWdtTimeout (void); Return value TRUE: Normal FALSE: Error Argument Nothing Processing performed Clears the watchdog timer time-out state. (WDT_STT) E.g.) // Clears the watchdog timer time-out state.
  • Page 76 3 Library Interface Reference <DIN functions> SetDinEnable Call format BOOL WINAPI SetDinEnable (WORD inp, BOOL bEnable) Return value TRUE: Normal FALSE: Error Argument WORD inp 0 or 1: DIN port number BOOL bEnable TRUE: Enables DIN port input. FALSE: Disables DIN port input. Processing performed Enables/disables DIN0/DIN1 port input.
  • Page 77 PS Series Type G Application Development Kit (ADK) Developer Manual SetDinAlarmOut Call format BOOL WINAPI SetDinAlarmOut (WORD inp, BOOL bAlm) Return value TRUE: Normal FALSE: Error Argument WORD inp 0 or 1: DIN port number BOOL bAlm TRUE: Enables alarm output.
  • Page 78 3 Library Interface Reference SetDinBuzzer Call format BOOL WINAPI SetDinBuzzer (WORD inp, BOOL bBuzzer); Return value TRUE: Normal FALSE: Error Argument WORD inp 0 or 1: DIN port number BOOL bBuzzer Enables/disables buzzer output. Processing performed Enables/disables buzzer output while the DIN0/DIN1 port is active. E.g.) // Disables buzzer output through the DIN port.
  • Page 79 PS Series Type G Application Development Kit (ADK) Developer Manual SetDinDout Call format BOOL WINAPI SetDinDout (WORD inp, BOOL bRasout); Return value TRUE: Normal FALSE: Error Argument WORD inp 0 or 1: DIN port number BOOL bRasout Enables/disables DOUT output.
  • Page 80 3 Library Interface Reference SetDinPopup Call format BOOL WINAPI SetDinPopup (WORD inp, BOOL bPopup); Return value TRUE: Normal FALSE: Error Argument WORD inp 0 or 1: DIN port number BOOL bPopup Enables/disables pop-up message output. Processing performed Enables/disables pop-up message output while the DIN0/DIN1 port is active. E.g.) // Enables pop-up message output.
  • Page 81 PS Series Type G Application Development Kit (ADK) Developer Manual SetDinMessage Call format BOOL WINAPI SetDinMessage (WORD inp, wchar_t *pMessage); Return value TRUE: Normal FALSE: Error Argument WORD inp 0 or 1: DIN port number wchar_t *pMessage Pointer to the pop-up message.
  • Page 82 3 Library Interface Reference <Remote reset functions> SetRstEnable Call format BOOL WINAPI SetRstEnable (BOOL bEnable) Return value TRUE: Normal FALSE: Error Argument BOOL bEnable TRUE: Enables remote reset input. FALSE: Disables remote reset input. Processing performed Enables/disables remote reset input. E.g.) BOOL ret = SetRstEnable (TRUE);...

  • Page 83: Register Details

    PS Series Type G Application Development Kit (ADK) Developer Manual 4.3 Register Details RAS_IN_MASK RAS IN MASK register Read/Write Register Note RMT_ IN1_ IN0_ 8th to 15th bits RAS IN MASK RST_ MASK MASK invalid "0". MASK RMT_RST_MASK Remote reset mask 1: External remote reset input is enabled.
  • Page 84 3 Library Interface Reference LEDG Front green LED control 1: The front green LED is ON. 0: The front green LED is OFF. (Default) RAS_ALM Control of Alarm Output and front bezel LED When the WDT_ALM_MASK register is 0 and the WDT_STT register is 1, Alarm Output is ON and the orange LED is ON (the red LED is also ON), regardless of the RAS_ALM register status.
  • Page 85 PS Series Type G Application Development Kit (ADK) Developer Manual WDT_CR Watchdog timer control register Read/Write Register Note WDT_ WDT_ WDT_ WDT_ 8th to 15th bits WDT CR ALM_ CNTL invalid "0". MASK WDT_ALD Watchdog timer automatic load The data in the counter resister is loaded into the watchdog timer as the initial value.
  • Page 86 3 Library Interface Reference WDT_COUNT Watchdog timer counter register Read/Write Register Note WDT_ WDT_ WDT_ WDT_ WDT_ WDT_ WDT_ WDT_ COUNT COUNT COUNT COUNT COUNT COUNT COUNT COUNT COUNT 8th to 15th bits invalid "0". (MSB) (LSB) WDT_COUNT 0 to 7 Initial value for the timer.

  • Page 87: Touch Panel Driver

    PS Series Type G Application Development Kit (ADK) Developer Manual 5 Touch Panel Driver The function of this driver is to enable/disable buzzer activation and input when the touch panel is touched. 5.1 Touch Panel Driver APIs API name Description GetTouchDriverVersion Retrieves information on the driver version.
  • Page 88 3 Library Interface Reference TouchDriverOpen Call format BOOL WINAPI TouchDriverOpen (void) Return value TRUE: Normal FALSE: Error Argument None Processing performed Opens the touch panel driver, enabling setting operations. E.g.) BOOL ret = TouchDriverOpen ( ); TouchDriverClose Call format BOOL WINAPI TouchDriverClose (void) Return value TRUE: Normal FALSE: Error...
  • Page 89 PS Series Type G Application Development Kit (ADK) Developer Manual SetTouchClickBuzzer (BOOL bState) Call format BOOL WINAPI SetTouchClickBuzzer (BOOL bState) Return value TRUE: Normal FALSE: Error Argument BOOL bState TRUE: Turns the buzzer ON. FALSE: Turns the buzzer OFF. Processing performed Enables/disables the buzzer to activate when the touch panel is clicked.
  • Page 90 3 Library Interface Reference SetTouchInput (BOOL bState) Call format BOOL WINAPI SetTouchInput (BOOL bState) Return value TRUE: Normal FALSE: Error Argument BOOL bState TRUE: Enables input. FALSE: Disables input. Processing performed Enables/disables input when the touch panel is touched. E.g.) // Enables input when the touch panel is touched. BOOL ret = SetTouchInput (TRUE);...
  • Page 91 PS Series Type G Application Development Kit (ADK) Developer Manual 3-50...

  • Page 92: Index

    Index About Trademarks ..........3 RAS Driver ............3-20 ADK Files ............1-6 RAS Driver APIs ..........3-20 Auto Start ............2-14 Registers Details ..........3-42 Remote Connection Procedure ......1-6 Remote reset functions ......3-21, 3-41 remote tools ..........1-4, 1-8 Backlight Driver ..........
  • Page 93 Tel: +31 (0)20 6464 134 Fax: +31(0)20 6464 358 http://www.pro-face.com support@digital.co.jp http://www.proface.com support@proface.com South Korea Italy Pro-face Korea Co., Ltd. Pro-face HMI B.V. Italy Room #701, Jaeyoung Building Via Carcano 44 678-10 Deungchon-dong 20033 Desio (MI) Kandgseo-Ku, Seoul 157-030 KOREA ITALY...

This manual is also suitable for:

Ps600g-t11-j1Ps600g-t41-j124vPs600g-t41-e124vPs400g-t41-j124vPs400g-t41-e124v

Table of Contents