Rockwell-automation 2711P Software Development Kit User Manual Manual de usuario

Software Development Kit2711PUser Manual

Publication 2711P-UM005A-EN-P - March 200710 Introduction to the PanelView Plus CE TerminalCPUThe system processor is an Intel mlCP 650MHz, ult

Publication 2711P-UM005A-EN-P - March 2007100 Messages

Publication 2711P-UM005A-EN-P - March 2007IndexCc++ name mangling 98Ddeveloping CE drivers and applications 29Eerror codes 99exception debug messages

Publication 2711P-UM005A-EN-P - March 20072 Index

Publication 2711P-UM005A-EN-P - March 2007 2Supersedes Publication 6182H-UM002B-EN-P - November 2003 Copyright © 2007 Rockwell Automation, Inc. All ri

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 11The external CF connector is controlled by a PCMCIA

Publication 2711P-UM005A-EN-P - March 200712 Introduction to the PanelView Plus CE TerminalInput/OutputAn INTEL 82801BA I/O CONTROLLER HUB (ICH

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 13PCI The PanelView Plus CE device uses a PCI bus for

Publication 2711P-UM005A-EN-P - March 200714 Introduction to the PanelView Plus CE TerminalATMEL MicrocontrollerAn Atmel 8-bit microcontroller

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 15Touch ScreenAn integral, resistive analog touch scre

Publication 2711P-UM005A-EN-P - March 200716 Introduction to the PanelView Plus CE Terminal• PanelView Plus CE components are a collection of a

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 17Default Registry that was extracted from the OS is u

Publication 2711P-UM005A-EN-P - March 200718 Introduction to the PanelView Plus CE TerminalRestoring the Default RegistryThere are times when i

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 19When the device is started in Safe Mode, the backgro

Important User InformationSolid state equipment has operational characteristics differing from those of electromechanical equipment. Safety Guidelines

Publication 2711P-UM005A-EN-P - March 200720 Introduction to the PanelView Plus CE TerminalThe startup process copies all folders and their con

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 21The Display Module keypad is supported by two separa

Publication 2711P-UM005A-EN-P - March 200722 Introduction to the PanelView Plus CE Terminal• Support for assignment of special functions to key

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 23Keypad HandlerThe Rockwell Automation supplied keypa

Publication 2711P-UM005A-EN-P - March 200724 Introduction to the PanelView Plus CE TerminalRegistry keys used by KHSTUB.EXEThe operating system

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 25allows for interchange of Display Module without rep

Publication 2711P-UM005A-EN-P - March 200726 Introduction to the PanelView Plus CE Terminalvalue of the registry key \HKLM\Loader\SystemPath. N

Publication 2711P-UM005A-EN-P - March 2007Introduction to the PanelView Plus CE Terminal 27Process PrioritiesAll executable files start in user

Publication 2711P-UM005A-EN-P - March 200728 Introduction to the PanelView Plus CE Terminal

29 Publication 2711P-UM005A-EN-P - March 2007Chapter 2Developing CE Applications Overview This chapter covers topics on developing CE applications fo

3 Publication 2711P-UM005A-EN-P - March 2007Table of ContentsPrefaceUsing this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Publication 2711P-UM005A-EN-P - March 200730 Developing CE ApplicationsInstalling the ApplicationOnce the user has obtained an installation pac

Publication 2711P-UM005A-EN-P - March 2007Developing CE Applications 31Persistency ConsiderationsInstallation of a new application program on t

Publication 2711P-UM005A-EN-P - March 200732 Developing CE Applications2. Install Microsoft embedded Visual C++ 4.0 software. This is the devel

33 Publication 2711P-UM005A-EN-P - March 2007Chapter 3PanelView Plus CE SDK OverviewThe PanelView Plus CE SDK provides developers with access to an e

Publication 2711P-UM005A-EN-P - March 200734 PanelView Plus CE SDKVisual Basic .NETMicrosoft Visual Studio .NET 2003 is the PC development envi

35 Publication 2711P-UM005A-EN-P - March 2007Chapter 4PanelView Plus CE-Specific Extensions to the WinCE APIOverviewThis chapter covers these topics:•

Publication 2711P-UM005A-EN-P - March 200736 PanelView Plus CE-Specific Extensions to the WinCE APIHardware WatchdogWatchdog_TagThe function co

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 37Requirements: Software WatchdogThese functio

Publication 2711P-UM005A-EN-P - March 200738 PanelView Plus CE-Specific Extensions to the WinCE APIdwTimeoutTimeout in milliseconds. This param

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 39Return Values: Remarks: The function Watchdo

Publication 2711P-UM005A-EN-P - March 20074 Table of ContentsSystem Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Publication 2711P-UM005A-EN-P - March 200740 PanelView Plus CE-Specific Extensions to the WinCE APIIf the value of dwTimeout is within the rang

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 41Watchdog_SW_TagThis function tags the softwa

Publication 2711P-UM005A-EN-P - March 200742 PanelView Plus CE-Specific Extensions to the WinCE APISystem ParametersThe system maintains inform

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 43Remarks:The functions use a model that is si

Publication 2711P-UM005A-EN-P - March 200744 PanelView Plus CE-Specific Extensions to the WinCE API• RM_PARAMETER_BACKLIGHT_STATUSThis paramete

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 45• RM_PARAMETER_BOARD_REVISIONThis parameter

Publication 2711P-UM005A-EN-P - March 200746 PanelView Plus CE-Specific Extensions to the WinCE APIReturn Values: Remarks: The buffer at *pvDat

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 47pdwSizeA pointer to a caller allocated DWORD

Publication 2711P-UM005A-EN-P - March 200748 PanelView Plus CE-Specific Extensions to the WinCE APIA timer number identifies a specific timer.

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 49Requirements: UserTimerClaimThis function is

Publication 2711P-UM005A-EN-P - March 2007Table of Contents 5Chapter 5Device DriversOverview . . . . . . . . . . . . . . . . . . . . . . . . .

Publication 2711P-UM005A-EN-P - March 200750 PanelView Plus CE-Specific Extensions to the WinCE APIRemarks: A timer must be claimed for any oth

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 51pdwFrequencyPointer to an application alloca

Publication 2711P-UM005A-EN-P - March 200752 PanelView Plus CE-Specific Extensions to the WinCE APIUserTimerGetWaitEventThis function registers

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 53Calling this API a second time with the same

Publication 2711P-UM005A-EN-P - March 200754 PanelView Plus CE-Specific Extensions to the WinCE APIReturn Values: Remarks: This function provid

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 55Parameters: dwTimerNumberThe Timer Number is

Publication 2711P-UM005A-EN-P - March 200756 PanelView Plus CE-Specific Extensions to the WinCE APIUserTimerGetValueThis function gets the coun

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 57Requirements: UserTimerStopThis function sto

Publication 2711P-UM005A-EN-P - March 200758 PanelView Plus CE-Specific Extensions to the WinCE APIRequirements: Hardware MonitorThe PanelView

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 59Hardware Monitor FunctionsThese functions pe

Publication 2711P-UM005A-EN-P - March 20076 Table of Contents

Publication 2711P-UM005A-EN-P - March 200760 PanelView Plus CE-Specific Extensions to the WinCE APINote that registering a warning event will n

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 61Remarks: This function unregisters and frees

Publication 2711P-UM005A-EN-P - March 200762 PanelView Plus CE-Specific Extensions to the WinCE APIRemarks: This function returns a bit wise Or

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 63Remarks: Note that monitor parameters will v

Publication 2711P-UM005A-EN-P - March 200764 PanelView Plus CE-Specific Extensions to the WinCE APIlfLowerWarningLevelDouble precision floating

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 65hm_GetMonitorWarningLevelsThis function gets

Publication 2711P-UM005A-EN-P - March 200766 PanelView Plus CE-Specific Extensions to the WinCE APIThe monitor level specified in lfUpperWarnin

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 67Remarks: This function performs a reboot of

Publication 2711P-UM005A-EN-P - March 200768 PanelView Plus CE-Specific Extensions to the WinCE APIReturn Values: Remarks: The watchdog registe

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 69KeypadThese functions support front panel co

7 Publication 2711P-UM005A-EN-P - March 2007PrefaceUsing this ManualRead this preface to familiarize yourself with the rest of the manual. The prefac

Publication 2711P-UM005A-EN-P - March 200770 PanelView Plus CE-Specific Extensions to the WinCE APIKeypad Driver/Handler OverviewThe keypad dri

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 71• IOCTL_KPD_SET_TYPEMATIC_PARAMSThis sets th

Publication 2711P-UM005A-EN-P - March 200772 PanelView Plus CE-Specific Extensions to the WinCE APIRequirements: Registry Keys for Keypad Drive

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 73• [HKEY_LOCAL_MACHINE\Drivers\BuiltIn\Keypad

Publication 2711P-UM005A-EN-P - March 200774 PanelView Plus CE-Specific Extensions to the WinCE APIMembersnIndexThe record index.nType Event Ty

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 75Remarks: The Event is written to the system

Publication 2711P-UM005A-EN-P - March 200776 PanelView Plus CE-Specific Extensions to the WinCE APIGet Last EventThis function reads the last o

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 77Get First EventThis function reads the first

Publication 2711P-UM005A-EN-P - March 200778 PanelView Plus CE-Specific Extensions to the WinCE APIGet Next EventThis function reads the “next”

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 79Return Values: Remarks: This first time GetN

Publication 2711P-UM005A-EN-P - March 20078 Additional ResourcesFor additional information, refer to these publications, that you can download

Publication 2711P-UM005A-EN-P - March 200780 PanelView Plus CE-Specific Extensions to the WinCE APIRecommended PanelView Plus CE MechanismsThes

Publication 2711P-UM005A-EN-P - March 2007PanelView Plus CE-Specific Extensions to the WinCE API 81// Turn on the keypad handler.SendNotifyMess

Publication 2711P-UM005A-EN-P - March 200782 PanelView Plus CE-Specific Extensions to the WinCE APIUnLock PagesThis Win32 function unlocks a sp

83 Publication 2711P-UM005A-EN-P - March 2007Chapter 5Device DriversOverviewThis chapter provides an overview of developing a device driver and sampl

Publication 2711P-UM005A-EN-P - March 200784 Device DriversThe following flow chart illustrates the preferred method for driver initialization.

Publication 2711P-UM005A-EN-P - March 2007Device Drivers 85Sample CodeThe code sample describes the preferred process for driver initialization

Publication 2711P-UM005A-EN-P - March 200786 Device Drivers#define DRV_USE_IO // set to use port IO #define DRV_USE_PCI

Publication 2711P-UM005A-EN-P - March 2007Device Drivers 87 \ KernelIoControl(IOCTL_HAL_REQUEST_SYSINTR, \ (PVOID)&a

Publication 2711P-UM005A-EN-P - March 200788 Device Drivers PDDKISRINFO pdii, PDDKPCIINFO pdpi ); #endif // defined(DRV_USE_PCI)DRV_Deinit

Publication 2711P-UM005A-EN-P - March 2007Device Drivers 89 pDrvData->Gii.CheckPort = TRUE; #if defined(DRV_USE_IO) pDrvData->Gii.

9 Publication 2711P-UM005A-EN-P - March 2007Chapter 1Introduction to the PanelView Plus CE TerminalThis chapter provides an overview of the PanelView

Publication 2711P-UM005A-EN-P - March 200790 Device Drivers // // Attempt to use lower level DDK function to get // info

Publication 2711P-UM005A-EN-P - March 2007Device Drivers 91#if defined(DRV_USE_ISR) // // If a DLL name was not assigned yet, just defau

Publication 2711P-UM005A-EN-P - March 200792 Device Drivers if (INVALID_HANDLE_VALUE == (pDrvData->hEvent = CreateEvent(NULL,FALSE,FALSE,

Publication 2711P-UM005A-EN-P - March 2007Device Drivers 93 // // If the pointer is invalid, just return // if (0 == hDeviceCont

Publication 2711P-UM005A-EN-P - March 200794 Device Drivers pDrvData->hEvent = INVALID_HANDLE_VALUE; } // // release the

Publication 2711P-UM005A-EN-P - March 2007Device Drivers 95 } if (dwStatus == ERROR_SUCCESS) { pdii->cbSi

Publication 2711P-UM005A-EN-P - March 200796 Device Drivers// /////////////////////////////////////////////////////////////////////DWORD WINAPI

97 Publication 2711P-UM005A-EN-P - March 2007Appendix AMessagesSerial Debug MessagesThe boot loaders and WinCE support a Debug Monitor that, when ena

Publication 2711P-UM005A-EN-P - March 200798 MessagesException Debug MessagesPanelView Plus CE supports an exception handler named crashlog.exe

Publication 2711P-UM005A-EN-P - March 2007Messages 99PathThe notion of path is much the same as any other Windows or DOS system. WinCE searches