Home

IPC Settings - Pro-face America HMI Store

1. Reserved If a type of data is alarm block 1 to 80 one alarm block stores three types of data maximum active data history data and log data based on the GP Pro EX settings However this API confirms whether effective data is available based on the following priorities and if any data exists the data will be subjected 1 Alarm History 2 Alarm Log 3 Active Alarm If none of the above is available the error occurs Return value Normal End 0 Problem Error Code GP Pro EX Reference Manual 37 94 API Function List Function Name Extended Read of SRAM Backup Data format Read the following data in SRAM save the data as a file in PC The saved file format for filing data is saved in a binary format and other files are saved in CSV This allows to access to data which cannot be retrieved in backup data by comparing with EasyBackupDataRead INT WINAPI EasyBackupDataReadEx LPCSTR sSaveFileName LPCSTR sNodeName INT iBackupDataType INT iSaveMode INT iNumber 0 INT iStringTable 0x0000 GP Pro EX Reference Manual 37 95 Argument Return value sSaveFileName In The file path of a destination file of read data Text pointer Normal End 0 sNodeName In The participated station name of the source data to be read Text Problem Error pointer A station name is fixed to WinGP Code iSaveMode In How to save 0 Ne
2. End Exits ProjectCopy GP Pro EX Reference Manual 37 163 Settings Guide 37 9 Restrictions You cannot start more than one WinGP If you run PCRuntime exe on the same IPC running WinGP WinGP will not open after restarting and the WinGP window in operation is displayed in front If the number of parts on one screen exceeds 1280 in IPC a warning message appears Reduce the number of parts placed on the screen You can place and transfer parts even when this message is displayed If the number of addresses on one screen exceeds 3000 in IPC a warning message appears Reduce the number of addresses placed on the screen You can place and transfer the addresses even when this message is displayed If many parts are placed in IPC a warning appears when you save This is because the parts and addresses limits change when converted into another series in Change Display Unit If the specified number of alarm history and word monitoring in the new model exceeds the limit of the post conversion model an error appears when you change the display unit however you can change the model You can set the data size up to 8 blocks For blocks 1 to 8 you can register bit word monitoring up to a total of 10000 If the total capacity of SRAM used in the GP Pro EX settings exceeds 5MB a warning appears at the time of error checking and sampling and alarm features do not operate properly You can use up to SMB data to save and transfer the
3. Function Name Bit data INT WINAPI WriteDeviceBit LPCSTR sNodeName LPCSTR sDeviceName WORD pwData WORD wCount Function Name 16 bit data INT WINAPI WriteDevice 16 LPCSTR sNodeName LPCSTR sDeviceName WORD pwData WORD wCount Continued GP Pro EX Reference Manual 37 89 API Function List Function Name 32 bit data INT WINAPI WriteDevice32 LPCSTR sNodeName LPCSTR sDeviceName DWORD pdwData WORD wCount Function Name 16 bit BCD data INT WINAPI WriteDeviceBCD16 LPCSTR sNodeName LPCSTR sDeviceName WORD pwData WORD wCount Function Name 32 bit BCD data INT WINAPI WriteDeviceBCD32 LPCSTR sNodeName LPCSTR sDeviceName DWORD pdwData WORD wCount Function Name Single float number data INT WINAPI WriteDeviceFloat LPCSTR sNodeName LPCSTR sDeviceName FLOAT pflData WORD wCount Function Name Double float number data INT WINAPI WriteDeviceDouble LPCSTR sNodeName LPCSTR sDeviceName DOUBLE pdbData WORD wCount Function Name Text data INT WINAPI WriteDeviceStr LPCSTR sNodeName LPCSTR sDeviceName LPCSTR psData WORD wCount Function Name General data INT WINAPI WriteDevice LPCSTR sNodeName LPCSTR sDeviceName _LPVOID pData WORD wCount WORD wAppKind Function Name General data Variant type INT WINAPI WriteDeviceVariant LPCSTR sNodeName LPCSTR sDeviceName LPVARIANT pData WORD wCount WORD wAppKind Cache Re
4. Cause and Troubleshooting SAAF 168 1062206808 3232760488 0xC0B002A8 Failed to write to a saved file If the hard disk capacity of the PC is insufficient please increase it and execute the operation again Or please restart the PC and execute again Ist line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 142 API Function List Error Code Decimal Hexa Message decimal 9300 2454h Cannot find network project file 9301 2455h Reserved 9329 2471h 9330 2472h Cannot execute the command because resources are insufficient Terminated program 9331 2473h The system resource was dead locked Terminated program 9332 2474h System Error 9333 2475h Cannot execute the command because program versions do not match Terminated program 9334 2476h Reserved 9339 247Bh 9340 247Ch An error occurred when accessing the lt s gt file 9341 247 Dh Pro Server is being used by too many applications 9342 247Eh_ OS resources are insufficient insufficient memory 9343 247Fh_ The set connector is used by another application 9344 2480h Pro Server has not been started Could not reference data 9345 2481h Pro Server has been terminated Could not reference data 9346 2482h Canno
5. GP Pro EX Reference Manual 37 45 Retrieve WinGP information or Operate WinGP from user application Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub WriteBCD32_Click ByVal sender As System Object ByVal e As System EventArgs Handles WriteBCD32 Click Try Write data Dim nDataAry 1 As Integer nDataAry 0 CInt Val amp h Me WBuf_BCD16 Text Write Dim iResult As Integer ProEasy WriteDeviceBCD32 WinGP Buf_BCD32 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub WriteFloat_Click ByVal sender As System Object ByVal e As System EventArgs Handles WriteFloat Click Try Write data Dim nDataAry 1 As Single nDataAry 0 CSng Val Me WBuf_Float Text GP Pro EX Reference Manual 37 46 Retrieve WinGP information or Operate WinGP from user application Write Dim iResult As Integer ProEasy WriteDeviceFloat WinGP Buf_Float nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub WriteDouble_Click ByVal sender As System Object ByVal e As System EventArgs Handles WriteDouble C
6. IPC API allows to retrieve WinGP information or operate WinGP from user applications 1 In System Settings open Display Unit Video Movie Font Peripheral Settings Peripheral List Device PLC Printer Input Equipment Settings Script 1 0 Settings 120 Driver FTP Server Modem Video Modules GP Pro EX Reference Manual 37 34 Retrieve WinGP information or Operate WinGP from user application 2 Open the IPC Settings tab and select the Use API Communication check box to specify the port to enable from 0 to 65535 ele ene e Be sure not to use the same port as that for communication with the other device PLC or for FTP communication e Please do not use the port number 8000 which is designated as the port number for transfer 3 Save the project file and transfer the file to the IPC 4 Acknowledge the communication between WinGP and the device PLC 5 Set up a programming application to use API lt When using the device access API in VB NET gt GP Pro EX Reference Manual 37 35 Retrieve WinGP information or Operate WinGP from user application Open the solution explorer in VB NET and right click Browse Settings to select Add Browse Solution Explorer WindowsApplication1 Bi Ha TO Solution WindowsApplication1 1 project EE WindowsApplication1 Add Reference Add Web Reference 2 System Windows Forms 2 System XML lE AssemblyIn
7. Online was 1062272921 terminated terminated To finish the operation 3232694375 put WinGP online and retry 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 127 API Function List SAAA Error Info Error Code Error Message Cause and Troubleshooting 0xC0B00001 System Error Please reboot your PC If not SAAA001 solved install it again 1062207487 3232759809 0xC0B00002 Cannot process due to a shortage SAAA002 of OS resource or memory 1062207486 3232759810 OxCOB00003 Cannot execute any new process SAAA003 until the server returns a 1062207485 processing result 3232759811 OxCOB00004 The process was interrupted A fatal error occurred Restart SAAA004 because Pro Server EX was WinGP and WinGP SDK after 1062207484 terminated executing a forced transfer in GP 3232759812 Pro EX 0xC0B00005 The process was interrupted SAAA005 because Pro Server EX was 1062207483 terminated during the process 3232759813 OxCOB00006 Cannot process because Pro SAAA006 Server EX has already been 1062207482 terminated 3232759814 st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 128 API
8. Try Gets the state Dim RetVal As Int32 GetDisplayScreenNumber ghWinGP CurScrNo Any error GP Pro EX Reference Manual 37 59 Retrieve WinGP information or Operate WinGP from user application If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal Trim GetDisplayScreenNumber End If Catch ex As Exception MsgBox ex Message End Try Try Gets the screen count Dim ScreenCount As Int32 0 Dim RetVal As Int32 GetEnumScreenNumberCount ghWinGP ScreenCount Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal Trim GetEnumScreenNumberCount End If Gets the screen number If ScreenCount gt 0 Then Gets the screen number Dim ScreenNumber ScreenCount 1 As Int32 RetVal EnumScreenNumber ghWinGP ScreenCount ScreenNumber 0 Any error If RetVal lt gt API_LERROR E_SUCCESS Then MsgBox Err Str RetVal Trim EnumScreenNumber End If Delete all Me CB_DispScreen Items Clear Set the get screen number Dim idx As Int32 For idx 0 To ScreenNumber Length 1 Me CB_DispScreen Items Add ScreenNumber idx Next Display the screen number currently displayed For idx 0 To ScreenNumber Length 1 GP Pro EX Reference Manual 37 60 Retrieve WinGP information or Operate WinGP from user application If CurScrNo Val Me CB_DispScreen Items idx Then Me CB_DispScreen SelectedIn
9. XXXDeviceDouble O XXXDeviceStr O XXXDevice O O O O O O O O GP Pro EX Reference Manual 37 91 API Function List pxxData Pointer for read write data The following table shows the data types for access and the relevant argument types Data types for access Argument type Bit data WORD pwData 16 bit data WORD pwData 32 bit data DWORD pdwData 16 bit BCD data WORD pwData 32 bit BCD data DWORD pdwData Single float number data FLOAT pflData Double float number data DOUBLE pdbData Text data LPTSTR psData General data LPVOID pData General data for VB LPVARIANT pData wCount The number of read write data For the Read WriteDeviceStr function the amount of text data is expressed in 1 byte units If the symbol refers to a 16 bit device use two characters to specify the number If it refers to a 32 bit device use four characters The below table shows the maximum amount of read write data Data types for access Read Write Bit data 255 16 bit data 1020 32 bit data 510 16 bit BCD data 1020 32 bit BCD data 510 Single float number data 510 Double float number data 255 Text data 1020 characters Single byte GP Pro EX Reference Manual 37 92 API Function List wAppKind Data Type Value Value Data type Value Data type 1 Bit data 7 Unsigned 32 bit data 2 Signed 16 bit data
10. Gets the screen number GP Pro EX Reference Manual 37 67 Retrieve WinGP information or Operate WinGP from user application If ScreenCount gt 0 Then Gets the screen number Dim ScreenNumber As Long ReDim ScreenNumber ScreenCount 1 As Long RetVal EnumScreenNumber ghWinGP ScreenCount ScreenNumber 0 Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal EnumScreenNumber End If Set the screen number you got Me CB_DispScreen Clear Dim idx As Long For idx 0 To ScreenCount 1 Me CB_DispScreen AddItem ScreenNumber idx Next Display the screen number currently displayed For idx 0 To ScreenCount 1 If CurScrNo Val Me CB_DispScreen List idx Then Me CB_DispScreen ListIndex idx Exit For End If Next End If Screen MousePointer vbDefault Changes the cursor back to the original End Sub Private Sub SetDispScreen_Click Screen MousePointer vbHourglass Changes the cursor to an hourglass Gets the screen number Dim ScrNo As Long ScrNo Val Me CB_DispScreen Text Changes the screen number Dim RetVal As Long RetVal SetDisplayScreenNumber ghWinGP ScrNo GP Pro EX Reference Manual 37 68 Retrieve WinGP information or Operate WinGP from user application Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal SetDisplayScreenNumber End If Gets the screen number again
11. again 0xC0B00207 Cannot execute because of the Please confirm that there are not SAAF007 version inconsistency of DLL and two or more different versions of 1062206969 EXE for Pro Server EX This Pro Server EX or DLLs of 3232760327 program will be shut down WinGP SDK ina PC Only 1 version of Pro Server EX or WinGP SDK can be installed in a PC 0xC0B00209 The file Core ID was not found Please reboot your PC If it does SAAF009 not solve the problem please 1062206967 install WinGP SDK again 3232760329 0xC0B0020B ProNet dll has not been correctly SAAF011 installed 1062206965 3232760331 Ist line Error code 2nd line Integrated error code 3rd line Error code with decimal code 4th line Error code without decimal code GP Pro EX Reference Manual 37 134 API Function List Error Code Error Message Cause and Troubleshooting OxCOB0020C Cannot start Pro Server EX Cannot start WinGP SDK SAAF012 Please close all the applications because WinGP SDK or an 1062206964 that use Pro Studio EX or Pro application using WinGP SDK 3232760332 Server EX and try again did not possibly stop normally Please close WinGP SDK and all the applications running on it and then try again 0xC0B00211 This API is not supported The API you tried to use is SAAF017 unavailable Please consider 1062206959 another method
12. C Documents and Settings User My Documents ProductionContral x Parameter3 allow multiple instances 7 l Parameter4 Exec_Process EXE path parameter titlebar search option Searches all the titlebars that match parameter 3 using the defined search option in parameter 4 0 Partial words 1 Whole words only If the search comes up empty then run the executable defined in parameter 1 Use parameter 2 when the executable requires a parameter Parameter2 O Partial words Parameter Specify the EXE file path S 37 6 2 Switch Startup Settings page 37 72 Parameter 2 Select the option Argument to run the executable using the Parameter Up to 255 characters can be used to set the Parameter SF 37 6 2 Switch Startup Settings page 37 72 Parameter 3 Select Allow Multiple Instances or Prevent Multiple Instances If you select Prevent Multiple Instances enter the window title E 21 7 2 Triggering Application page 21 67 Parameter 4 Select 0 Partial words or 1 Whole words only E 21 7 2 Triggering Application page 21 67 5 Click OK to enter the parameter configured in procedure 4 in Script Expression Area For example Exec_Process C Program Files Microsoft Office Office EXCEL EXE C Documents and Settings User My Documents ProductionProcess xls 0 GP Pro EX Reference Manual 37 76 API Function List 37 7 API Function List
13. Function list Direct read API of single handle system Function Name Bit data INT WINAPI ReadDeviceBit LPCSTR sNodeName LPCSTR sDeviceName WORD owData WORD wCount Function Name 16 bit data INT WINAPI ReadDevice16 LPCSTR sNodeName LPCSTR sDeviceName WORD owData WORD wCount Function Name 32 bit data INT WINAPI ReadDevice32 LPCSTR sNodeName LPCSTR sDeviceName DWORD odwData WORD wCount Function Name 16 bit BCD data INT WINAPI ReadDeviceBCD16 CLPCSTR sNodeName LPCSTR sDeviceName WORD owData WORD wCount Function Name 32 bit BCD data INT WINAPI ReadDeviceBCD32 LPCSTR sNodeName LPCSTR sDeviceName DWORD odwData WORD wCount Function Name Single float number data INT WINAPI ReadDeviceFloat LPCSTR sNodeName LPCSTR sDeviceName FLOAT ofIData WORD wCount Function Name Double float number data INT WINAPI ReadDeviceDouble LPCSTR sNodeName LPCSTR sDeviceName DOUBLE odbData WORD wCount Function Name Text data INT WINAPI ReadDeviceStr LPCSTR sNodeName LPCSTR sDeviceName LPSTR psData WORD wCount Function Name General data INT WINAPI ReadDevice LPCSTR sNodeName LPCSTR sDeviceName LPVOID pData WORD wCount WORD wAppKind Function Name General data Variant type INT WINAPI ReadDevice Variant LPCSTR sNodeName LPCSTR sDeviceName LPVARIANT pData WORD wCount WORD wAppKind e Single handle system API
14. WinGP SDK Pro SDK DotNet EasySmpl Imports ProEasyDotNet one ProEasy object o Public Class Form1 Inherits System Windows Forms Form Region code generated with Windows form designer Public Sub New MyBase New This call is necessary for Windows form designer InitializeComponent InitializeComponent Adds initialization i ere after the call ProEasy Initialization Dim iResult As Integer ProEasy EasyInit WinGP Initialize SDK once at the beginning If iResult Then GP Pro EX Reference Manual 37 38 Retrieve WinGP information or Operate WinGP from user application Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg End If End Sub Form overwrites the dispose to execute post processing on the component list Protected Overloads Overrides Sub Dispose ByVal disposing As Boolean If disposing Then If Not components Is Nothing Then components Dispose End If End If MyBase Dispose disposing End Sub Snip Codes designed by Windows form designer are omitted hereafter End Region Private Sub ReadBit_Click By Val sender As System Object ByVal e As System EventArgs Handles ReadBit Click End Sub Private Sub Read16_Click ByVal sender As System Object ByVal e As System EventArgs Handles Read16 Click ere the symbol Buf_16 USR201 configured in GP Pro EX is used You can also specify the device address directly og How to
15. records are not added even if the system has not reached the Number of Stored Items e When the number of error messages exceeds Number of Files to Save in Error Settings the oldest file is deleted to add a new file Continued GP Pro EX Reference Manual 37 157 Settings Guide Setting Description File Name Specifies the file name prefix of the error log file using 0 to 16 single byte characters The file name is specified in the below format Prefix Date Time _ ID Extension For example Prefix Test Saved Date Time 2006 7 14 16 18 ID 0 from Serial No 0 Numbers to differentiate files when several files are created at the same time Extension log fixed character File name Test200607141618_0 log e If no file name is specified the file is named simply as Save Date Time and ID GP Pro EX Reference Manual 37 158 Settings Guide E Set Destination Folder Destination Folder CF Card USB Storage Setting Description CF Card Specify the folder with a full path to replace CF Card The path should be set within 239 characters by single or double byte characters USB storage Specify the folder with a full path to replace USB Storage USB memory The path should be set within 239 characters with single or double byte characters e You can set folders to replace CF Card or USB Storage on the network However file n
16. 3 Active Alarm If none of the above is available the error occurs 1 Targets Active Alarms 2 Targets Alarm History 3 Targets Alarm Log If the subjected data type is not in the alarm block specified by iBackupDataType an error occurs Group number of a sampling group to be 0x8002 read A value between 1 to 64 Other than those above Reserved iStringTable In Reserved Always specify 0 Function Name Write SRAM backup data The binary format filing data is written in the SRAM INT WINAPI EasyBackupDataWrite LPCSTR sSourceFileName LPCSTR sNodeName INT iBackupDataType Argument Return value sSourceFileName In The file path of filing data file in a binary format to be written Text Normal End 0 pointer Problem Error sNodeName In The name of a participated station of the location where the data is Code written to Text pointer The station name is fixed to WinGP iBackupDataType In 1 Fixed indicates filing data GP Pro EX Reference Manual 37 96 API Function List e API for Systems Function Name Message handling control Most of WinGP SDK API functions handles Windows messages within the functions if the process takes a while You can specify if you use this Windows message process or control this process If the control is used Windows messages are accumulated in the message queue and not processed during the function
17. 3232694279 OxCOAFO008 Cannot execute State Transition RYAA008 of TdaInfo because a small 1062273016 service is now in transition 3232694280 OxCOAFO009 The device name XX specified RYAA009 as the destination NODE does not 1062273015 exist 3232694281 XX Device PLC name st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 123 API Function List Error Code Error Message Cause and Troubleshooting OxCOAFOO0A Cannot execute the operation due A fatal error occurred Restart RYAA010 to the invalid state of the small WinGP and WinGP SDK after 1062273014 service executing a forced transfer in GP 3232694282 Pro EX OxCOAFOOOB Cannot execute the operation RYAAO11 because the small service is not in 1062273013 operation 3232694283 OxCOAFOO0OC Cannot execute the operation RYAA012 because the small service is in 1062273012 suspension 3232694284 OxCOAFOO0OD The I F of an unsupported small RYAA013 service was called 1062273011 3232694285 OxCOAF0010 Could not register the item Please close another application or RYAA016 because of insufficient memory restart the OS 1062273008 3232694288 OxCOAF0011 Accessed a device in which no A fatal error occurred Restart RYAA017 item is registered Win
18. 5 Number of alarms saved in the 768 gt 10000 history 6 The number of registered alarm 2048 10000 messages 7 Max DRAM size 320 KB 5 MB E Features not available in WinGP In WinGP the following GP features are unavailable Buzzer AUX output USB connection for two dimensional code reader Printer operation using scripts Movie record play feature Video display on the VM unit Memory loader feature Modem transfer feature Backlight burnout detection CF Card initialization in offline mode User data initialization in offline mode Pass through feature The backlight OFF screen display ON and OFF features of the system data area e For the features supported by the IPC see below SF 4 3 List of Supported Functions by Device page 1 5 GP Pro EX Reference Manual 37 4 WinGP Overview E Features available only in WinGP Feature Feature Details Switch Parts The Start application switch to start other applications and the Exit WinGP switch to exit WinGP are available Trigger Action Start other applications EXE operation Exit WinGP Exit WinGP operation Script Start other applications EXE operation Exit WinGP Exit WinGP operation Device access API The API writes to the device PLC connected to the IPC Handling API The API obtains the WinGP state from the third party software tools and changes the settings Error log feature Saves the er
19. Codes designed by Windows form designer are omitted hereafter End Region 5 Gets the startup state Private Sub Bt_GetStartState_Click ByVal sender As System Object ByVal e As System EventArgs Handles Bt_GetStartState Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Try Gets the state API Dim Status As Int32 Dim RetVal As Int32 GetRuntimeStartState gh WinGP Status Any error If RetVal lt gt API_LERROR E_SUCCESS Then MsgBox Err Str RetVal Trim 0 GetRuntimeStartState End If Display the state Select Case Status Case 0 Me StartState Text Starting Case 1 Me StartState Text Online Case 2 Me StartState Text Offline Case 3 Me StartState Text Transfer mode Case 4 Me StartState Text Ending Case 5 Me StartState Text Not execute End Select GP Pro EX Reference Manual 37 57 Retrieve WinGP information or Operate WinGP from user application Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub Private Sub GetScreenState_Click ByVal sender As System Object ByVal e As System EventArgs Handles BT_GetScreenState Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Try Gets the state Dim Status As Int32 Dim RetVal As Int32 GetScreenState gh WinGP Status Any error If RetVal lt gt API_LERROR E_SUCCESS Then MsgB
20. Error code Function Name CF card file to save define type Function to save the file contents of the file to the CF card Files you can save are limited to the file type defined in pWriteFileType INT WINAPI EasyFileWriteCard LPCSTR sNodeName LPCSTR pReadFileName LPCSTR sWriteFileType WORD wWriteFileNo Argument sNodeName wWriteFileNo The station name is fixed as WinGP pReadFileName The file name full path of the source file to save to the CF card sWriteFileType See Function to read CF card file file type Special Items section File type of file to save to CF card File number of file to save to CF card Return value Normal 0 Problem Error code Function Name Delete CF card file optionally define file name Function to delete the file on the CF card You can optionally define the file to delete INT WINAPI EasyFileDeleteInCfCard _LPCSTR sNodeName LPCSTR sFolderName GP Pro EX Reference Manual 37 109 LPCSTR sFileName Argument Return value sNodeName The station name is fixed as WinGP Normal 0 sFolderName Folder name of file on the CF card file to delete Maximum 32 single Problem Error byte characters code sFileName File name in the 8 3 string format to delete from the CF card Continued API Function List Special Item Supported File Types Data Class File Type Folder Filing Data ZF
21. Error Code Becinal aera Message decimal 9403 24BBh The error occurred in the function of OLE Data cannot be converted 9404 24BCh The effective data for the specified data type variant does not exist in the original data or is not enough 9405 24BDh Original data and destination data types cannot be converted by data type variant 9406 24BEh The specified argument is not enabled 9407 24BFh Can not create the time bar 9408 24C0h The symbol name is not registered 9409 24C1h Cannot open the distribution sheet 9410 24C2h The specified time bar has already been locked 9411 24C3h The specified time bar has already been linked 9412 24C4h The specified handle is not linked 9413 24C5h The specified handle is not linked to the database 9414 24C6h_ Specified handle is locked or played Please execute after clearing to its status 9415 24C7h The argument is wrong 9416 24C8h _ Designate the internal format of the argument s Variant as either Date type or compatible with Date 9417 24C9h_ The specified time is out of the valid range 9418 24CAh The invalid argument has been set 9419 24CBh Database of appointed handle is closed 9420 24CCh_ Database access error 9421 24CDh_ INI file s in the action contents cannot be opened 9422 24CEh_ s of INI file s in the action contents cannot be analyzed 9423 24CFh Action s uses action contents not yet installed in the network pr
22. Function List Error Code Error Message Cause and Troubleshooting OxCOB00007 The specified connector has Please reboot your PC If not SAAA007 already been registered The solved install it again 1062207481 application is already in 3232759815 execution 0xC0B00008 An error occurred in an OLE SAAA008 function Cannot convert the data 1062207480 3232759816 OxCOBO000A Cannot refer to the resource SAAA010 because Pro Server EX has not 1062207478 been started 3232759818 OxCOBOO00B Cannot request the system to SAAA011 execute processing because Pro 1062207477 Server EX has not been started 3232759819 OxCOBO000C The system is broken Cannot 1062207476 3232759820 0xC0B00011 An error occurred when accessing SAAA017 the XX file The file is locked 1062207471 shared or broken 3232759825 XX File name 0xC0B00012 Too many connectors to register SAAA018 1062207470 3232759826 0xC0B00029 Failed to get device info from the There is a possibility that the SAAA041 PRW file screen project file is corrupted 1062207447 Restart WinGP and WinGP 3232759849 SDK after executing a forced O0xCOB0002A Failed to get symbol info from the transfer in GP Pro EX SAAA042 PRW file 1062207446 3232759850 0xC0B0002B Failed to get the device address SAAA043 from the PRW file 1062207445 3232759851 OxCOB0002C Failed to get setting info from the SAAA044 P
23. Manual 37 48 Retrieve WinGP information or Operate WinGP from user application E VB6 program example Sample Program Location In GP Pro EX CD ROM WinGP SDK Pro SDK VB EasySmpl Option Explicit Private Sub Form_Load Dim iResult As Long iResult EasyInit If iResult Then Dim sErrMsg As String Dim iMsgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMsg End If End Sub Private Sub WriteBit_Click Write data Dim nDataAry 1 As Integer nDataAry 0 CInt Val Me WBuf_Bit Text Write Dim iResult As Long iResult WriteDeviceBit WinGP Buf_Bit nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If End Sub GP Pro EX Reference Manual 37 49 Retrieve WinGP information or Operate WinGP from user application Private Sub Write16_Click Write data Dim nDataAry 1 As Integer nDataAry 0 CInt Val Me WBuf_16 Text Write Dim iResult As Long iResult WriteDevice16 WinGP Buf_16 nDataAry 0 1 Here the symbol Buf_16 USR201 configured in GP Pro EX is used You can also specify the device address directly Fog How to specify device addresses directly page 37 38 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMs MsgBox sErrMsg End If End Sub Priv
24. Reference Manual 37 147 API Function List Error Code Decimal nexa Message decimal 9581 256Dh DB name is not designated 9582 256Eh Cannot access to DB 9583 256Fh Cannot edit DB because it is locked edited by another program e g Data View 9584 2570h Either the node name or the device name is not designated 9585 2571h Cannot use DB because it has been closed DB in use is automatically closed once when NPJ is saved loaded 9586 2572h The database may be broken 9587 2573h Data not saved 9588 2574h Cannot find data at the designated time 9589 2575h No polling setups exist 9590 2576h The database has not been opened Or it has already been closed 9591 2577h Already polling start 9592 2578h Old data will be overwritten instead of newest data 9593 2579h Delete record 9594 257Ah Exceeds designated file size 9595 257Bh __ Designated file number does not exist 9596 257Ch Reserved 9599 257Fh 9600 2580h Cannot continue the process due to a resource lack in GP 9601 2581h Reserved 9619 2593h 9620 2594h The network project item has been registered redundantly The network project file has been broken 9621 2595h i Reserved 9639 25A7h 9640 25A8h The Provider information data that is not registered in the network project file were sent from other node Network projects differ between theProvid
25. Sheet name to which Same Symbol name belongs XX Same Symbol name 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 132 API Function List Error Code Error Message Cause and Troubleshooting access the whole array In API Communication for WinGP only XX elements from the head are accessible XX Symbol name XX Array Element number OxCOBOO0E1 Warning The symbol group name In the GP Pro EX Symbol setting SAAA225 is the same as a symbol sheet screen please change the name to 1062207263 name To use the same name avoid name overlapping 3232760033 please specify the sheet name which this symbol group belongs to Symbol Sheet XX Symbol Group Sheet XX Name XX XX Existing Symbol Sheet name XX Symbol Sheet name to which Same Symbol name belongs XX Same Symbol name OxCOBOO0E4 Warning The array variable XX 1 Consider registering the array by SAAA228 has too many elements for API splitting it into multiple parts in 1062207260 Communication for WinGP to GP Pro EX 3232760036 2 If the array cannot be split when importing the GP Pro EX project file to the network project in Pro Server EX there is a function that automatically splits array variables that exceed the number that can be accessed simultaneously a
26. Text CShort nDataAry 0 Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub ReadBCD32_Click ByVal sender As System Object ByVal e As System EventArgs Handles ReadBCD32 Click Try Read data Dim nDataAry 1 As Integer Read Dim iResult As Integer ProEasy ReadDeviceBCD32 WinGP Buf_BCD32 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Me Buf_BCD32 Text CInt nDataAry 0 Catch ex As Exception MsgBox ex Message End Try End Sub GP Pro EX Reference Manual 37 41 Retrieve WinGP information or Operate WinGP from user application Private Sub ReadFloat_Click ByVal sender As System Object ByVal e As System EventArgs Handles ReadFloat Click Try Read data Dim nDataAry 1 As Single Read Dim iResult As Integer ProEasy ReadDeviceFloat WinGP Buf_Float nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Me Buf_Float Text CSng nDataAry 0 Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub ReadDouble_Click ByVal sender As System Object ByVal e As System EventArgs Handles ReadDouble Click Try Read data Dim nDataAry 1 As Double Read Dim iResult As Integer ProEasy ReadDeviceDouble WinGP Buf Double nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessag
27. WinGP NOTE e Please refer to the settings guide for details 441 14 Switch Lamp Parts Settings Guide page 11 38 e For details of the part placement method and the address shape color and label setting method refer to the Part Editing Procedure SF 9 6 4 Editing Parts page 9 38 Lilie 1 On the Parts P menu point to Switch Lamp C and then click Special Switch P or click on the tool bar to place the switch Base 1 Untitled E Dees er eeee Qoraan Qevvevevnvavee 3 Gan GP Pro EX Reference Manual 37 27 Development Process 2 Double clicking the Switch part opens the Settings dialog box E Switch Lamp x Parts ID Switch Feature Switch Common Lamp Feature Color Label SL_0000 Comment M Switch Feature fe Oy Bees Multi function List 4a w Special Switch t Cwi Word Screen Special Selector Bk Switch Switch Chanae Switch Switch Special Action Window Display Switch Window Parts ID Select Shape nl I No Shape Help H 3 In Select Shape select the Switch shape NOTE e Some switch shapes do not allow you to change the color 4 In Special Action select Exit WinGP E Switch Lamp Parts ID Switch Feature Switch Common Lamp Feature Color Label ISL_O000 Comment M Switch Feature f Ss 5 p apnea Multi function List 4a A wo Special Switch C
28. and compare it with the set value to see whether the screen number has been changed successfully Dim NowScrNo As Long RetVal GetDisplayScreenNumber ghWinGP NowScrNo If RetVal API_ERROR E_SUCCESS Then If NowScrNo ScrNo Then MsgBox Screen change number No Str NowScrNo End If End If Screen MousePointer vbDefault Changes the cursor back to the original End Sub Private Sub GetProjectInfo_ClickQ Screen MousePointer vbHourglass Changes the cursor to an hourglass Parameter range to get Dim ProjectFileName As String 256 Dim ProjectComment As String 256 Dim ProjectFastTime As String 256 Dim ProjectLastTime As String 256 Dim ProjectIDownload As String 256 Dim HMIEditorVersion As String 256 Dim ControlEditorVersion As String 256 Dim MakingPerson As String 256 Gets the project information Dim RetVal As Long RetVal GetProjctInformation ghWinGP _ ProjectFileName _ ProjectComment _ ProjectFastTime _ ProjectLastTime _ ProjectIDownload _ HMIEditorVersion _ ControlEditorVersion _ MakingPerson GP Pro EX Reference Manual 37 69 Retrieve WinGP information or Operate WinGP from user application Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal GetProjctInformation End If Display the information you got Me Prj_File Text StrConv ProjectFileName vbFromUnicode Me Prj_Comment Text StrConv ProjectComment vbFromUni
29. com mands will be queued However cache write and direct write commands cannot be mixed e To cancel a queuing command call CancelQueuingAccess e The maximum number of queuing commands is 1500 the maximum byte number is under 1 MB GP Pro EX Reference Manual 37 113 API Function List Function Name Execute Queuing Device Read Write Request Accesses to device data according to queuing device read write request Single INT WINAPI ExecuteQueuingAccess Argument Return value Normal 0 Problem Error code Special Item e When access to all devices succeeded ExecuteQueuingAccess returns the successful completion and when access to any device failed it returns an access error If you want to know whether each access was successful or not call IsQueuingAcceessSucceeded to check for details e No action can be registered to queuing access Function Name Cancel Queuing Device Read Write Request Cancels queuing device read write request Single INT WINAPI CancelQueuingAccess Argument Return value Normal 0 Problem Error code Special Item Until ExecuteQueuingAccess is called after calling BeginQueuingWrite or BeginQueuingRead the queuing device access request continues If the request is no longer required call this API The API cancels the request and ends the queuing operation GP Pro EX Reference Manual 37 114 API Function List Function
30. different screen resolutions screen size but the data will not be displayed properly if the IPC has a lower resolution Example 1 IPC Create a 800X600 screen and send to a 320X240 IPC Created data m Trigger mode Full Screen Only parts that can be displayed in 320X240 resolution are displayed starting from the top left end Transfer Trigger mode Window Screen Trigger mode Window Screen Display Position is specified X Display Position none Coordinate is 0 and Y Coordinate is 0 Only parts that can be displayed in Only parts that can be displayed in 320X240 resolution are displayed 320X240 resolution are displayed starting from the top left end starting from the top left end GP Pro EX Reference Manual 37 167 Settings Guide Example 2 IPC Create a 800X600 screen and send to a 1600X1200 IPC Created data Transfer oy Trigger mode Full Screen With 800X600 resolution the screen is enlarged to 1600X1200 and displayed Trigger mode Window Screen Trigger mode Window Screen Display Position is specified X Coordinate is Display Position none 0 and Y Coordinate is 0 Displayed centered in 800X600 In 800X600 resolution displayed starting from resolution the top left end e When viewing screen data on a large sized screen with a high resolution a portion of the window frame will appear outside the screen To make sure the window is not outside the
31. during the process 3232760430 0xC0B0026F Cannot connect to the specified Please use the WinGP node name SAAF 111 node because it does not exist 1062206865 3232760431 0xC0B00272 The parameter value is invalid Please review the inputted SAAF114 parameter and set a correct value 1062206862 3232760434 OxC0B00273 Failed to get the file list in the CF Please confirm that the specified SAAF115 card file type is correct Also please 1062206861 check the access right to the 3232760435 destination folder If there is no problem with the access right please check whether the drive has enough free space 0xC0B00274 Could not connect to GP3000 WinGP NODE may be busy SAAF116 Series NODE WinGP NODE Please execute it again after a brief 1062206860 interval Or if the connection with 3232760448 WinGP NODE is established using the transfer tool please exit the tool and then execute it again 0xC0B002A6 Read SRAM Backup Data is now Please execute Read SRAM SAAF 166 being used Backup Data again 1062206810 3232760486 OxCOB002A7 Parameter Error in Read SRAM _ Please execute Read SRAM SAAF 167 Backup Data Backup Data using a correct 1062206809 parameter 3232760487 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 141 API Function List Error Code Error Message
32. e The IP address 127 0 0 1 is a virtual address that indicates the computer you are currently using on the network GP Pro EX Reference Manual 37 23 Development Process 7 Select the 127 0 0 1 check box displayed in IP Address and click OK Add Edit Delete Search end PASY Auto Manual 127 0 0 1 Do Not Use Manual 8 When the following dialog box appears click Yes The dialog box will not appear if you transfer the same project again ie 127 0 0 1 x 9 Transferring all projects will be executed Is that OK 33 3 Transferring Project Files via Ethernet LAN page 33 12 Project file transfer is available using ProjectCopy Copy Tool Please see the following setup procedures Transferring from CF Card or USB storage page 37 20 GP Pro EX Reference Manual 37 24 Development Process E Start Run WinGP 1 Connect the IPC to the device PLC NOTE e Please refer to the GP Pro EX Device PLC Connection Manual about communication settings and connection cables 2 On the Start menu select Program P gt Pro face gt WinGP gt WinGP to launch WinGP BS ce proexz 00 gt B ProjectCopy gt Ra wingp EB wince x B Startup ir Documents gt amp Internet Explorer a Outlook Express amp Settings a ba p ES Search L e Alternatively double click the shortcut on the desktop screen m Exit WinGP Exit WinGP The fo
33. event is often used for cyclic processing in Windows program Program carefully for programs using the timer event otherwise API double calling might result 1 Call read and display the device read API cyclically once every second 2 Pressing the button calls the device write API and writes the value into the device In such program an error results at the timing below During reading triggered by a timer event in 1 the 2 button is pressed and the 2 processing starts During the 2 writing a timer event occurs and the 1 reading is performed GP Pro EX Reference Manual 37 119 API Function List e Solutions to avoid API double calling The below shows solutions to avoid API double calling 1 In the user program improve the algorithm to prevent API double calling For example e Always cancel the timer at the start of the timer processing routine and the button processing routine e During a processing triggered by 1 button pressed ignore any other button pressed or if the button is pressed again 2 Do not allow message processing in API Call EasySetWaitType with the argument 2 In this case other messages than that causing double calling are not processed either which may lead to other problems such as the applications performing unintended operations Reading Text in VB There are two ways to read texts in VB as shown below 1 Using ReadDeviceStr in VB to read texts In this case you need to specify fix the
34. file access right and then execute it again 0xC0B00224 In Write SRAM Backup Data the Please confirm that the file SAAF036 specified file size is too large It specified in Write SRAM Backup 1062206940 must be 96KB or less Data is correct Also please specify 3232760356 a file of the size of 96Kbytes or less 0xC0B00225 Numeric value error Please seta Please confirm that the string is SAAF037 correct value valid as a numeric value 1062206939 3232760357 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 136 API Function List Error Code Error Message Cause and Troubleshooting 0xC0B00226 The specified data count is 0 or Please check the data count SAAF038 out of range 1062206938 3232760358 OxC0OB00227 The max number of access Please consider dividing it for SAAF039 destinations is too high It must be successful access 1062206937 1500 or less 3232760359 OxCO0B00228 The total buffer size of the data to SAAF040 access is too high It must be 1062206936 1MB or less 3232760360 0xC0B00230 Cannot start Pro Server EX Please reboot your PC If it does SAAF048 not solve the problem please 1062206928 install WinGP SDK again 3232760368 0xC0B00238 Reading out logging data froma Please change the setti
35. is busy sending screen data or saving SRAM backup data to another PC 9741 260Dh An error occurred in reading the SRAM backup data The item ID differs from the previous ID 9742 260Eh_ An error occurred in reading the SRAM backup data The data type differs from the previous type 9743 260Fh_ An error occurred in reading the SRAM backup data The block No differs from the previous No 9744 2610h SRAM backup data read error The requested data amount is 0 or differs from the previous amount Continued GP Pro EX Reference Manual 37 149 API Function List Error Code Decimal nexa Senan decimal 9745 2611h Reserved 9749 2615h 9750 2616h CF command error 9751 2617h CF Access error 9752 2618h No CF card unit 9753 2619h Reserved 9779 2633h 9780 2634h Transmission error occurred with PLC during data write Code 02x 04x 9781 2635h The designated SRAM backup data is not in the GP 9782 2636h The GP s SRAM backup data is incorrect Code 04x 9783 2637h New alarm block is not supported 9784 2638h Reserved 9789 263Dh 9790 263Eh No remote access right not connected remotely 9800 2648h Parameter error 9801 2649h Data count is over 9802 264Ah File create error 9803 264Bh_ EXCEL sheet create error 9804 264Ch Write file error 9805 264Dh_ File open error 980
36. or F FILE CSV Data ZR FILE Image Screen Zl or DATA Sound Data ZO or O DATA GP Pro EX exclusive trend graph data ZT TREND Compatibility GP Pro EX exclusive sampling data ZS TREND Compatibility Alarm1 Z1 or ZA ALARM Alarm2 Z2 or ZH ALARM Alarm3 Z3 or ZG ALARM Alarm4 8 Z4 Z8 ALARM GP Pro EX exclusive logging data ZL LOG compatible Capture data CP CAPTURE Sampling1 64 ZS1 ZS64 SAMP01 SAMP64 Function Name Change CF card file name Function to change the name of the file on the CF card INT WINAPI EasyFileRenameInCfCard LPCSTR sNodeName LPCSTR sFolderName LPCSTR sFileName LPCSTR sFileRename Argument Return value sNodeName The station name is fixed as WinGP Normal 0 sFolderName The folder name of a file to be renamed in CF Card max of 32 charac Problem Error ters code sFileName The file name to be renamed in CF Card Max 8 3 format text sFileRename The renamed file name Max 8 3 format text GP Pro EX Reference Manual 37 110 API Function List Function Name CFDelete Card File Deletes specified files in CF Card Files to be deleted are limited to the file type specified in the pDeleteFileType INT WINAPI EasyFileDeleteCard LPCSTR sNodeName LPCSTR pDeleteFileType WORD wDeleteFileNo Argument Return value sNodeName The station name is fixed as WinGP Normal 0 pDeleteFileType Delete File Types in CF Card refer to S
37. project files If you turn OFF the IPC without shutting down the OS the backup file for exiting WinGP cannot be saved and the record will be from the last save In an IPC with battery backup features a standby mode resume signal is sent when the power is OFF Upon receiving the signal WinGP saves the backup file The touch buzzer sound setting is a feature used to specify a unique buzzer used by the PC runtime The setting differs from the that of the IPC touch panel unit If you enable both the buzzer of the IPC touch panel unit and that of the PC runtime a buzzer will sound twice when you touch the PC runtime screen If you enable the IPC touch panel buzzer disable the PC runtime buzzer If you disabled Script Settings Comm Flow Control in the system settings the status EXIT_SIO_STAT cannot detect sending errors in SIO Port Operation If you select Prevent Multiple Instances in Start Application for special switch trigger actions and scripts multiple instances occur when Window Title is not input For the Window Title you wish to prevent multiple instances enter the exact window title in the Start Application for the special actions of special switch trigger actions and scripts You can transfer project files to the GP if it has Start Application and Exit WinGP settings for the special actions of special switch trigger actions and scripts on models other than IPC but the file will not run on GP GP Pro E
38. screen do not display the window titlebar window frame and menu bar or display in full screen mode Be aware that when you do not display the title bar or display in full screen mode the title bar s Exit button does not display e Ifyou change IPC models System Settings keeps the settings before the model change in IPC Settings Display Note that X Coordinate and Y Coordinate in Display Position return to the initial values of 0 and Window Size are initialized to XGA 1024X768 size regardless of the IPC you are converting to GP Pro EX Reference Manual 37 168 Settings Guide 37 9 3 Restrictions on using Windows XP Embedded 37 9 4 Windows XP Embedded has the Write Filter feature in system drive During the Write Filter operation files cannot be updated in the system drive The destination folder to update files has to be set in a drive which does not have Write Filter Thus you can change the folder to update files by settings Restriction on AP Communication m Handling API Restrictions All the text information on the handling API are in Unicode In API the version information and the project information are read in Unicode Convert the code if you wish to use the information in another text code ASCII etc You cannot use the handling API in IPC unless it has TCP IP settings Be sure to check that the network settings have TCP IP protocol installed E Device Access API Restrictions To use the devic
39. symbol or directly use the 32 bit data type to access it allows the 16 bit device to handle the data as a 32 bit device In such a case WinGP sees the two sequential 16 bit devices as one Index Specification of Symbol 16 Bits Only device names of device access API can specify the index of symbol The index specification of symbol is used to specify a value using after the symbol name as shown below It means a device which is moved forward by the numeric value specified in the symbol data type Symbol name Numeric Value For example Valve 2 If a symbol valve is assigned to D100 and is signed 16 bit it indicates D102 If it is assigned to D100 and is unsigned 32 bit it indicates D104 Windows Message Processing Many Windows programs are event driven programs that display dialogs and output sounds corresponding to events such as clicking an icon moving the mouse and pressing a key When any such event occurs Windows sends the application a message that indicates the type of event Upon receiving the message the applications acknowledge that the event has occurred and execute the processing In this document the part that receives messages in order from Windows and branches them into the respective processing DoEvents in VB and the part where GetMessage and DispatchMessage are performed in VC is called the message pump When normally programmed in VC and VB the message pump hides in the VC and VB framewo
40. the excel book xls path in Parameter For example C Documents and Settings user desktop ProductionProcess xls 7 To stop multiple instances select the Prevent Multiple Instances check box and enter Window Title S 11 14 4 Special Switch page 11 59 GP Pro EX Reference Manual 37 74 Executing the application from the WinGP 37 6 3 D Script startup settings e Please refer to the settings guide for details E a4 7D Triggering Application page 21 67 e On the Common menu you can select Global D Script or Extended Script to start EXE 1 On the Parts menu select D Script and click Create in the D Script List dialog box D Script List x Oo omm ee Edit Duplicate Delete Change ID 2 Click the Function tab The Built In Function Instruction allow you to easily place a command to use in the script Eal Create Egit DERE Duplicate Henane Glob amp Funta Tool IQ Sear 3 On the Built In Function Instruction pull down menu click Others and double click Start Application M Built In Function Instruction Others w GP Pro EX Reference Manual 37 75 Executing the application from the WinGP 4 Configure the settings in the dialog box as shown below Start Application x Exec_Process Parameterl Parameter2 Parameter3 Parameter4 Parameter C Program Files Microsoft Office Office EXCEL EXE
41. 2273000 write an in range value 3232694296 OxCOAFO019 The operation result to write is RYAA025 beyond the upper limit value 1062272999 3232694297 OxCOAFO01A Could not send processing request Please close another application or RYAA026 to the network destination due to restart the OS 1062272998 insufficient memory 3232694298 OxCOAFO01B The specified group was not A fatal error occurred Restart RYAA027 found WinGP and WinGP SDK after 1062272997 executing a forced transfer in GP 3232694299 Pro EX OxCOAFO01C The two compared access tickets RYAA028 differ in their nodes equipment 1062272996 or devices 3232694300 OxCOAFO001D The specified access ticket is not RYAA029 for this node 1062272995 3232694301 OxCOAFOO1E Could not register the cache Please close another application or RYAA030 because of insufficient memory restart the OS 1062272994 3232694302 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 125 API Function List Error Code Error Message Cause and Troubleshooting OxCOAF0020 The access ticket you tried to use A fatal error occurred Restart RYAA032 in block access is not of the block WinGP and WinGP SDK after 1062272992 type executing a forced transfer in GP 3232694304 Pro
42. 3232760337 0xC0B00212 The specified string is invalid as a Please reconfirm the address SAAF018 device address specification method 1062206958 Please confirm that no change has 3232760338 been made to devices and nodes Please confirm that the necessary device driver has been installed 0xC0B00213 The specified device supports bit Please confirm the device to access SAAF019 access only and access method 1062206957 3232760339 0xC0B00214 The specified device driver is not Please install device differences SAAF020 supported The necessary device 1062206956 driver has not been installed 3232760340 0xC0B00215 The parameter value is invalid Check the API argument SAAF021 1062206955 3232760341 0xC0B00216 The device no is out of range Please check the device no SAAF022 1062206954 3232760342 OxCOB00217 The specified device does not Please check the group symbol SAAF023 exist specification 1062206953 3232760343 0xC0B00218 The specified group symbol does Please check the group symbol SAAF024 not exist specification 1062206952 3232760344 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 135 API Function List Error Code Error Message Cause and Troubleshooting 0xC0B0021A In Queuing Access read access Please confirm that
43. 32759906 specified is a real network project Pro EX file OxCOB00063 Cannot write to the network Please confirm that the disk space SAAA099 project file is sufficient and that you have the 1062207389 access right to the file folder 3232759907 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 130 API Function List Error Code Error Message Cause and Troubleshooting OxCOB00064 The file is not a network project A fatal error occurred Restart SAAA100 file or its version is old Cannot WinGP and WinGP SDK after 1062207388 read the data executing a forced transfer in GP 3232759908 Pro EX OxCOBO00065 The specified device was not SAAA101 found in XX It may have been 1062207387 deleted or renamed Please check 3232759909 it again XX NODE name OxCOBO0066 The specified NODE XX has SAAA102 not been registered There is a 1062207386 conflict Please check it again 3232759910 XX NODE name 0xC0B00067 The specified NODE info is SAAA103 incorrect No NODE info exists 1062207385 3232759911 OxCOBO00068 The device setting in the system SAAA104 area of the specified NODE XX 1062207384 has an error Please check the 3232759912 device you set 0xC0B00069 XX XX is invalid as a device Please confirm t
44. 37 Using IPC Series Like a GP WinGP This chapter provides information about running project files created in GP Pro EX for the IPC Series device PLC communication and running applications on WinGP Please start by reading 37 4 Settings Menu page 37 32 and then turn to the correspond ing page SAT WinGP OVENWiEW nucon ean Ma e a N N 37 2 37 2 Operating Environment ccceeeeeeeeceeeeeeeeneeeceaaeseeeeeeceeaeeeseeeeeseeeseeaaeeeeeas 37 6 37 3 Development Process cccceccceeeeeseeeeeeeeseeceeseeeseneeeseeeneneeeeeenenseeeeennenees 37 10 37 4 Settings MeNi eeina ee eee aya ei ee 37 32 37 5 Retrieve WinGP information or Operate WinGP from user application 37 33 37 6 Executing the application from the WiNGP cccecccseeeeeeeeeeteteeeeeeeeees 37 71 37 0 APMPunctlonlist t stih sete eae ita tienda Gaal 37 77 37 8 Settings Guide a aeaoe aata aaia aa iadaaa ana as 37 154 87 9 Restrictions aaNet eee al aiai i a No ces 37 164 37 1 WinGP Overview 37 1 WinGP Overview 37 1 1 Whatis WinGP E Summary WinGP is an application that runs GP Pro EX projects and communicates with connected devices PLCs on Digital manufactured industrial computers hereafter referred to as IPC However because the GP and IPC are different pieces of hardware there are differences in the functions the IPC can use In addition to limitations there are features that fully utilize the extra memory capacity on th
45. 37 7 1 Handling API Summary API is to retrieve the WinGP status or change the settings of WinGP from the user created program application By linking the application and a DLL file of API when creating the application the application created by handling API operates on the IPC with WinGP Handling API DLL file This API is provided with a DLL file The file name is RtCtrlAPI dll and installed in WINDOWS folder Supported languages The below 5 programming languages can be used for handling API e Visual C e Visual Basic 6 0 e VB NET e Excel VBA CH Function list e Get WinGP handle Creates the WinGP handle for the communication destination and returns it to the application The below functions specify the handles retrieved by this function Function INT32 GetRuntimeHandle Name UINT32 ul_PortNo ul_PortNo i the IPC port number where the WinGP is Argument located Return value WinGP handle e WinGP handle release Releases the handle retrieved by the get WinGP handle function Function bool ReleaseRuntimeHandle Name INT32 1_RuntimeHandle Argument 1_RuntimeHandle 1 WinGP handle Return value true Succeed false Fail GP Pro EX Reference Manual 37 77 API Function List API Initialization Initialize the WinGP operations state get API Function Name bool InitRuntimeAPI void Argument None Return value t
46. 403 0xC0B00254 Array Index Specification Error Please check the array specification SAAF084 method 1062206892 3232760404 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code 4th line Error code without decimal code GP Pro EX Reference Manual 37 138 API Function List Error Code Error Message Cause and Troubleshooting 0xC0B00255 The specified device is an Please check the device address SAAF085 undefined symbol or an invalid specification method 1062206891 address 3232760405 OxCOB00256 The symbol name is invalid or SAAF 086 the group specification is too 1062206890 deeply nested 3232760406 0xC0B00257 Index specification is unavailable SAAF087 for a string type symbol 1062206889 3232760407 OxCOB00258 The specified index value is too SAAF088 high 1062206888 3232760408 0xC0B00259 Group symbol specification is Please check the device address SAAF089 unavailable for this device specification method 1062206887 specification 3232760409 0xC0B0025A Please specify a group symbol to SAAF090 specify a device 1062206886 3232760410 0xC0B0025B The symbol sheet name is invalid SAAF091 or it is unavailable for the 1062206885 specified device 3232760411 0xC0B0025C Device names are redundantly A fatal error occurred Restart SAAF092 specified WinGP and WinGP SDR after 1062206
47. 5 Startup on WinGP offline screen Maintenance Troubleshooting Start up by trigger action GP Pro EX Reference Manual 37 71 Executing the application from the WinGP 37 6 2 Switch Startup Settings 1 On the Parts menu select Switch Lamp and Special Switch or click on the tool bar to place the switch on the screen Base 1 Untitled E34 Drrrrreeras oraraa JEEE 3 2 Double clicking the Switch part opens the Settings dialog box Parts ID Switch Feature Switch Common Lamp Feature Color Label fSL_o000 Comment M Switch Feature ee S f pene Multi function List i a l pal wo Special Switch Cui Word Screen Special Selector BkSwitch Switch Change Switch Switch Select Shape I No Shape Special Action Window Display Switch v Window Parts ID 0 H Cancel Help H 3 In Select Shape select the Switch shape e Some switch shapes do not allow you to change the color GP Pro EX Reference Manual 37 72 Executing the application from the WinGP 4 In Special Action select Start Application me Switch Lamp Select Shape F No Shape Help H 5 Enter EXE path Switch Feature Switch Common Lamp Feature Color Label C t M Swi z f Glaus ommen M Switch Feature a Multi function List gt ay Special Switch oe Cua Word Screen Special Selector BRSwich Switch Chan
48. 6 264Eh Read only file 9807 264Fh Print out error 9808 2650h Save folder access error 9809 2651h Reserved 9810 2652h Unable to find message table file 9811 2653h Unable to open message table file 9812 2654h Unable to find designated sheet in message table file 9813 2655h Message table is incorrect 9814 2656h No equivalent enabled code 9815 2657h Error occurred during POP confirmation For details see the Log Viewer 9816 2658h Unable to send mail For details see the Log Viewer 9817 2659h Unable to send portion of mail For details see the Log Viewer BAT Tare Continued GP Pro EX Reference Manual 37 150 API Function List Error Code p Hexa Message Decimal decimal 9820 265Ch_ Unable to find designated database 9821 265Dh Unable to find designated Table Or there are no records in the designated Table 9822 265Eh_ Unable to find the designated field name 9823 265Fh_ Unable to find the designated data 9824 2660h Field data is incorrect 9825 2661h Validation failed 9826 2662h Error occurred while accessing the database 9827 2663h Unable to create the Pro Server handle 9828 2664h There are no character data 9829 2665h f Reserved 9839 266Fh 9840 2670h Unable to open Action Report Sheet Template or unable to append sheet 9841 2671h Failed to start EXCEL
49. 795 OxCO0A1001C Illegal Undefined Device Address REAA028 1063190500 3231776796 st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 122 API Function List RYAA Error Info Error Code Error Message Cause and Troubleshooting OxCOAFO001 The specified shared memory A fatal error occurred Restart RYAAO01 already exists WinGP and WinGP SDK after 1062273023 executing a forced transfer in GP 3232694273 Pro EX OxCOAFO002 The specified shared memory RYAA002 does not exist 1062273022 3232694274 OxCOAF0003_ A shared memory already exists Please close another application or RYAA003 but its memory size is less than restart the OS 1062273021 specified 3232694275 OxCOAF0004 Cannot create a shared memory RYAA004 due to insufficiency of memory or 1062273020 resource 3232694276 OxCOAFO005 Could not start TdasEngine A fatal error occurred Restart RYAA005 because it is already in execution WinGP and WinGP SDK after 1062273019 or termination executing a forced transfer in GP 3232694277 Pro EX OxCOAFO006 Could not stop TdasEngine RYAA006 because it is already in suspension 1062273018 or termination 3232694278 OxCOAFO0007 Could not register the operation in RYAA007 TdasEngine 1062273017
50. 8 32 bit Hex data 3 Unsigned 16 bit data 9 32 bit BCD data 4 16 bit Hex data 10 Single float number data 5 16 bit BCD data 11 Double float number data 6 Signed 32 bit data 12 Text data The Read WriteDevice function specifies the data type with parameters It allows you to change the data type dynamically lt Return value gt Normal end 0 Abnormal end Error code lt Supplementary gt When using Read WriteDeviceBit function pwData stores the same amount of data as in wCount starting from DO bit For example wCount is 20 Fl ee Cc Be Al eS By 7 Gl Ss 2 se 2 a PwData 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 PwData 1 we foe oe foe foe fe foe foe foe foe f 20 19 18 17 To handle sequential multiple data it is more efficient to read write in 16 32 bits using Read WriteDevice16 and Read WriteDevice32 than using Read WriteDeviceBit x will contain random values Mask it using an application program When using Read WriteDeviceBCD16 32 functions Use these functions for handling data as BCD internally in the device PLC Note that data pxxData summary to be sent to received from the functions is binary data not BCD BCD conversion is performed in the WinGP SDK Negative numbers cannot be handled Function Name Decimal notation a notation Read WriteDeviceBCD16 0 to 9999 0000 to 270F Read WriteDeviceBCD32 0
51. 884 executing a forced transfer in GP 3232760412 Pro EX OxCOB0025D Cannot use the specified symbol The symbol data type and the SAAF093 because its data type is different specified data type are different so 1062206883 from the one required here cannot be used Check the Symbol 3232760413 name or data type OxCOBO0025E Failed to analyze the option Please review the API parameters SAAF094 specifying string 1062206882 3232760414 OxCOB00262 Failed to read the file Please confirm that the specified SAAF098 file exists in the CF card folder If 1062206878 exists please confirm the right of 3232760418 access to the file 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code 4th line Error code without decimal code GP Pro EX Reference Manual 37 139 API Function List Error Code Error Message Cause and Troubleshooting 0xC0B00263 Failed to write to the file Please check the access right to the SAAF099 write destination If there is no 1062206877 problem with the access right 3232760419 please check whether the CF card has enough free space 0xC0B00264 The specified file was not found Please confirm that the specified SAAF100 file exists 1062206876 3232760420 0xC0B00265 Failed to delete the file Please confirm that the specified SAAF101 file exists in the CF card folder If 1062206875 exists please confir
52. 8h Read permission required to execute this command Log on to the network again 9369 2499h Write permission required to execute this command Log on to the network again 9370 249Ah Administrator permission required to execute this command Log on to the network again 9371 249Bh The specified number is not registered 9372 249Ch Reserved 9375 249Fh 9376 24A0h Cannot read the file Core ID 9377 24Ath Reserved 9389 24ADh 9390 24AEh Mode of Appointed handle is EASY_TB_STATUS_NOW or EASY_TB_STATUS_LAST_READ Please execute after changing its mode to EASY_TB_STATUS_PAST or EASY_TB_STATUS_INDEX 9391 24AFh_ Unable to open the designated LS Area 9392 24B0h Designated LS Area is not open 9393 24B1h__ Failed to aquire CF Card s File List 9394 24B2h Failed to read CF Card s file s 9395 24B3h Failed to write CF Card s file s 9396 24B4h CF Card is not inserted 9397 24B5h CF Card is not initialized 9398 24B6h_ CF Card is damaged 9399 24B7h Unable to access the designated file 9400 24B8h The function of Pro Easy DLL was doubly called up The function of PfnApiEasy DLL is already running 9401 24B9h The specified access handle for Pro Server EX is not effective 9402 24BAh Pro Server has stopped and can not perform processing Continued GP Pro EX Reference Manual 37 144 API Function List
53. 9842 2672h Unable to open Template Book 9843 2673h Action System Error 9844 2674h Unable to save Output Book 9845 2675h Designated Template Sheet s does not exist in Template Book 9846 2676h Failed to append sheet 9847 2677h Unable to interpret command s and cannot execute 9848 2678h Failed to print 9849 2679h Designated data type is not supported 9850 267Ah Pro Server version is old and cannot be started 9851 267Bh Action Report sheet is corrupted 9852 267Ch _ Designated group does not exist 9853 267 Dh Unable to paste image 9854 267Eh File header is corrupted unable to read 9855 267Fh_ Unable to open designated CSV file s 9856 2680h Action Area Size is too small 9857 2681h Unable to create or read temporary file 9858 2682h__ No usable files exist in GP GLC 9859 2683h Designated data type is not supported 9860 2684h A file name is too long and Output Book cannot be make 9861 2685h An error occurred while macro run Refer to Log Viewer for the details Continued GP Pro EX Reference Manual 37 151 API Function List Error Code P Hexa Message Decimal decimal 9862 2686h Unable to save GP Screen Capture data 9863 2687h Check if the Permission Flag has turned ON 9864 2688h The file name is error 9865 2689h The specified file does not exist in the CF card 9866 268Ah Not the br
54. Because the original information is one symbol there can be only one oSymbolInformation 2 Define the original information as group symbol and when the group includes a bit offset symbol the m_dwSizeOf property of the second oSymbolInformation and later is set to zero because it defines the access size for group access of members e When the member count is unknown use GetCountOfSymbolMember set up a Sym bolInformation workspace of the member count return value 1 then call this function GP Pro EX Reference Manual 37 104 API Function List e CF Card APIs Function Name Read CF card status Gets the CF card connection status of the IPC Single INT WINAPI EasyIsCFCard LPCSTR sNodeName Argument Return value sNodeName Station name is fixed to WinGP The node needs to be registered in a network project Function Status Return value 0x00000000 Normal There is no CF card or the cover 0x10000001 on the CF card slot is open 0x10000002 0x10000004 Detect CF card problem 0x10000008 Other Error unrelated to card GP Pro EX Reference Manual 37 105 API Function List Function Name Read CF card file list optional folder name The file list in the IPC CF card is output to the file sent as a parameter You can optionally define the folder of the file list you want to get INT WINAPI EasyGetListInCfCard LPCSTR sNodeName LPCSTR sDirectory INT oi
55. Count LPCSTR sSaveFileName Argument Return value sNodeName The station name is fixed as WinGP Normal 0 sDirectory Gets the folder name in uppercase characters Problem Error oiCount Number of files read code sSaveFileName Filename where directory information is stored In the defined file data stored in the stEasyDirInfo formatted array is in the quantity returned in the pioCount stored as binary data Saves the filename and extension in uppercase characters struct stEasyDirInfo BYTE bFileName 8 1 File name NULL terminated BYTE bExt 3 1 File extension NULL terminated BYTE bDummy 3 temporary DWORD dwFileSize File size BYTE bFileTimeStamp 8 1 File timestamp NULL terminated BYTE bDummy 2 3 temporary2 j Special Item More information about bFileTimeStamp 8 bytes are divided into two sections The top 4 bytes are used to store MS DOS formatted time and the bottom 4 bytes are used to store MS DOS formatted date both as hexadecimal values MS DOS formatted dates and times are set up in the following format Example When the DOS date time is 20C42C22 2C22 is the date and 20C4 is the time Translated the date and time is 2002 1 2 04 06 08 Bit Expansion Range 0 to 4 Day of month 1 31 5 8 Month of year 1 January 2 February 12 December Year starting with the year 1980 Add 1980 to the value indicated by these bits to come up with the actual year MS DOS formatted t
56. EX OxCOAF0021_ The small service to process was RYAA033 not found 1062272991 3232694305 OxCOAF0022 The size of block access to the The max buffer size for Device RYAA034 device exceeded the limit Block Write Read is 10KB Please 1062272990 set a size less than that 3232694306 OxCOAF0023 A different network project is A fatal error occurred Restart RYAA035 being used WinGP and WinGP SDK after 1062272989 executing a forced transfer in GP 3232694307 Pro EX OxCOAF0030 A communication error occurred Check that the LAN card settings RYAA048 during communication with the are correct 1062272976 destination node Please confirm 3232694320 that the network connection to the node has been properly established XX XX Destination node name OxCOAF0031 The destination node did not RYAA049 responded within the specified 1062272975 time Please confirm that the 3232694321 network connection to the node has been properly established XX XX Destination node name OxCOAF0032 The destination node did not RYAA050 responded within the specified 1062272974 time Please confirm that the 3232694322 network connection to the node has been properly established XX XX Destination node name OxCOAF0033 Communication with the Set WinGP node online RYAA051 destination Node stopped because 1062272973 the destination or local Node 3232694323 closed OxCOAF0040 Failed to read the device T
57. EX and WinGP are installed on one IPC Create and Transfer GP Pro EX Project Files From PC to IPC Transferring files with a USB cable LAN cable ers Transferring with USB cable LAN cable page 37 18 transfer Transferring from a CF Card or USB storage SZ E n Transferring from CF Card or ea USB storage page 37 20 When GP Pro EX and WinGP are installed on the same IPC 7 amp When GP Pro EX and WinGP are installed on the same IPC page 37 22 GP Pro EX Reference Manual 37 17 Development Process When using Windows XP Embedded a write protection is set at default Thus you need to disable the write protection filter setting before transfering a project file Select EWF Disable from EWFSetting Tool exe in Windows XP Embedded Windows XP Embedded users manual 3 1 Write filter setting process Create and Transfer GP Pro EX Project Files From PC to IPC e Transferring with USB cable LAN cable gt USB or LAN transfer 1 From the Start menu point to Program Files Pro face WinGP and then click WinGP Or double click on the desktop Bwince File E Help H BUROL sla PRE DI EVEZ AGA Cy bP yr ERIB TKKRSM download the GP3000Series Pro Server EX GP Pro EX e You cannot transfer files when the Screen Offline message i
58. ErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub Write16_Click_1 ByVal sender As System Object ByVal e As System EventArgs Handles Write16 Click Try Write data Dim nDataAry 1 As Short nDataAry 0 CShort Val Me WBuf_16 Text Write Dim iResult As Integer ProEasy WriteDevice16 WinGP Buf_16 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception GP Pro EX Reference Manual 37 44 Retrieve WinGP information or Operate WinGP from user application MsgBox ex Message End Try End Sub Private Sub Write32_Click ByVal sender As System Object ByVal e As System EventArgs Handles Write32 Click Try Write data Dim nDataAry 1 As Integer nDataAry 0 CInt Val Me WBuf_32 Text Write Dim iResult As Integer ProEasy WriteDevice32 WinGP Buf_32 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub WriteBCD16_Click ByVal sender As System Object ByVal e As System EventArgs Handles WriteBCD16 Click Try Write data Dim nDataAry 1 As Short nDataAry 0 CShort Val amp h Me WBuf_BCD16 Text Write Dim iResult As Integer ProEasy WriteDevice16 WinGP Buf_BCD16 nDataAry 1 If iResult Then
59. GP and WinGP SDK after 1062273007 executing a forced transfer in GP 3232694289 Pro EX OxCOAF0012 Accessed an out of range device Attempted to access an out of RYAA018 range device 1062273006 3232694290 OxCOAF0013 Failed to register the specified A fatal error occurred Restart RYAA019 cluster because an invalid item is WinGP and WinGP SDK after 1062273005 specified in it executing a forced transfer in GP 3232694291 Pro EX OxCOAF0014 The specified data type is invalid RYAA020 1062273004 3232694292 Ist line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 124 API Function List Error Code Error Message Cause and Troubleshooting OxCOAFO015 The specified access type is A fatal error occurred Restart RYAA021 illegal WinGP and WinGP SDK after 1062273003 executing a forced transfer in GP 3232694293 Pro EX OxCOAF0016 The specified data type is illegal RYAA022 1062273002 3232694294 OxCOAF0017 The no of data you specified is RYAA023 too many to write Please reduce 1062273001 it to XX or fewer 3232694295 XX Data number OxCOAF0018 The operation result to write is Attempted to write an out of range RYAA024 below the lower limit value value Please change the setting to 106
60. Guide E Window Frame Bwince File E Help H Setting Description Displays Window Title minimize or maximize window and close button Title Bar The window title set in the System Settings IPC Settings appears If no title is set blank space is displayed on the title Minimize Button Hides the window and displays the icon on the task bar Maximize Button Changes the window to full screen Close Button Exits WinGP e Help Menu Bar ae Version Information Displays Exit to exit WinGP Window Frame Changes the window size by dragging and dropping the cursor on the window frame If the size is changed to smaller than the original size the scroll bar is displayed GP Pro EX Reference Manual 37 161 Settings Guide E Right click Menu Displayed by right clicking the window frame of WinGP or clicking on the keypad Change Panel Offline O FullScreen Mode Minimize Application Close Setting Description Screen Change When you select Screen Change the Display Screen Selection dialog box appears and allows you to switch the display screen Display Number Select Eg Disp Number fi 4 Number Title cose e If offline this item is not displayed on the menu Specifies the screen number to switch from 1 to 9999 Screen If you select the number of a screen not specified in the project file the screen will not open N
61. Me Prj_Date Text ProjectFastTime ToString Me Prj_LastDate Text ProjectLastTime ToString Me Prj_HMI Text HMIEditorVersion ToString Me Prj_Person Text MakingPerson ToString Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub 13 Exit Exit following a confirmation dialog WinGP does not end if you select Do not exit in the dialog You can go back to the Return value with API_ERROR E_SUCCESS Private Sub StopWinGP_Q_ Click ByVal sender As System Object ByVal e As System EventArgs Handles StopWinGP_Q Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Try Exit APD Dim RetVal As Int32 StopRuntime ghWinGP 1 Any error If RetVal lt gt API_LERROR E_SUCCESS Then MsgBox Err Str RetVal Trim StopRuntime End If Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub End Class GP Pro EX Reference Manual 37 64 Retrieve WinGP information or Operate WinGP from user application m VB6 Program Example Sample Program Location In GP Pro EX CD ROM WinGP SDK Pro SDK VB RtCtrlSmpl The sample program executable file operates properly on Japanese and English operating systems only To run the executable file in other operating system environments re create the executable file in that operating system
62. Name Cancel Queuing Device Read Write Request Asks to check whether the device access to ExecuteQueuingAccess succeeded or not after ExecuteQueuingAccess is called Single INT WINAPI IsQueuingAccessSucceeded INT ilndex Argument Return value ilndex In Checking Request No XX Error Code f f f 0 Device access Until ExecuteQueuingAccess is called after calling BeginQueuingWrite to the or BeginQueuingRead API for device access is called several times in specified No order to queue the device access request However the actual device access was results can only available after ExecuteQueuingAccess is executed succ ssfil To find out the result of device access indicates a request number a number from 0 of the device after ExecuteQueuingAccess is executed Special Item For example BeginQueuingWrite Q WriteDevice16 Node1 LS100 Data 10 WriteDevice16 Node1 LS200 Data 10 WriteDevice16 Node1 LS300 Data 10 ExecuteQueuingAccess Whether the access to LS200 in Node 1 was successful with the above registration check IsQueuingAccessSucceeded 1 If 0 is returned the access was successful GP Pro EX Reference Manual 37 115 API Function List Data Type e Basic data type to specify the data type or receive the data as response in API Definition name Dec ek xada ema Descripti
63. NodeProperty LPCSTR sNodeName DWORD dwTimeLimit LPSTR osGPType LPSTRosSystemVersion LPSTR osCom Version LPSTR osECOM Version Argument sNodeName dwTimeLimit osGPType osCom Version The station name is fixed as WinGP In Response Timeout Value The set up range in millisecond units is 1 to 2147483647 or zero Zero is the default value which indicates 3000 milliseconds not zero milliseconds The following areas return information about object stations Please reserve 32 bytes or more of memory Out model code osSystemVersion Out system version Out PLC protocol driver version blank osECOM Version Out 2 Way driver version blank Return value Normal End 0 Problem Error Code GP Pro EX Reference Manual 37 102 API Function List Function Name Finds the symbol group byte size Find the total buffer byte size required to access the device and group symbols INT WINAPI SizeOfSymbol LPCSTR sNodeName LPCSTR sSymbolName INT oiByteSize Argument Return value sNodeName The station name is fixed as WinGP Normal End 0 sSymbolName In Device symbol name or group symbol name to search for Problem Error oiByteSize Out Byte size to search for Code Special Item In sSymbolName you can define one element as device symbol non array group array group or all array groups Function Name Finds the number of members in the group Finds the numb
64. RX file 1062207444 3232759852 Ist line Error code 2nd line Integrated error code 3rd line Error code with decimal code 4th line Error code without decimal code GP Pro EX Reference Manual 37 129 API Function List Error Code Error Message Cause and Troubleshooting OxCOB0002D Failed to create a temporary file Please specify a file of which SAAA045 extension is prw 1062207443 3232759853 OxCOBO0002E Cannot open the PRX file There is a possibility that the SAAA046 screen project file is corrupted 1062207442 Restart WinGP and WinGP 3232759854 SDK after executing a forced transfer in GP Pro EX OxCOBO0002F Failed to delete the temporary file Please execute it again SAAA047 1062207441 3232759855 0xC0B00030 The specified screen file has an There is a possibility that the SAAA048 error XX screen project file is corrupted 1062207440 Restart WinGP and WinGP 3232759856 SDK after executing a forced 0xC0B00031 The PRW file does not have transfer in GP Pro EX SAAA049 necessary data 1062207439 3232759857 0xC0B00032 The specified file is not a PRW SAAA050 file 1062207438 3232759858 OxCOB00062 The network project file is A fatal error occurred Restart SAAA098 broken Cannot read Please WinGP and WinGP SDK after 1062207390 confirm whether the file you executing a forced transfer in GP 32
65. Server EX to 1 10 or later The following message appears and WinGP cannot be installed Pro Server EX Version 1 10 or lower is already installed ProExSetup x WinGP cannot be installed in PC in which Pro Server with Pro Studio is installed Install WinGP after uninstalling Pro Server with Pro Studio Use Pro Server EX 1 10 or later if you want to use the function of Pro Server with Pro Studio Pro Server EX Version 1 10 or higher is already installed WinGP can be installed WinGP SDK will not be installed Neither Pro Server with Pro Studio for Windows nor Pro Server EX have been installed WinGP can be installed WinGP SDK will also be installed When you install Pro Server with Pro Studio for Windows or Pro Server EX to IPC with WinGP installed WinGP might not operate properly The below shows the actions S W to install Set Editor Language Pro Server with Pro Studio for Windows Neither Pro Server with Pro Studio for Windows nor WinGP will operate Do not install Pro Server with Pro Studio for Windows on an IPC with WinGP installed GP Pro EX Reference Manual 37 165 Settings Guide S W to install Set Editor Language Pro Server EX older than Ver1 10 After the installer or Pro Server EX older than Ver1 10 starts the following error message appears and the install will not be completed Even if Pro Server EX is not installed the error
66. Specifies whether to display the window border e If Display Titlebar is selected Window Frame is always displayed and the check box is selected Display Titlebar Specifies whether to display the title bar in the window display Window Title Specifies the window title name to display on the title bar in no more than 63 single byte characters ee Specifies whether to display the Minimize widow button r utton D He Mamia Specifies whether to display the Maximize window button g Button z Close Specifies whether to display the Close window button Menu Bar Specifies whether to display the menu bar Specifies the window size with Width and Height Use 0 maximum resolution of the selected model for Width and Height settings Window Size e The value can be specified between 0 to 1024 when using PS 2000B GP Pro EX Reference Manual 37 155 Settings Guide E Historical Data Retentive Settings Historical Data Retentive Settings Historical Data Storage Location Retentive Condition Frequency 10 Frequency P Indicate Write Status Status Address ad Setting Description Historical Data Storage Location Specifies the full path to the location to save the backup data replacing the backup SRAM in no more than 255 single byte characters drive name folder name If no settings are found the initial value NAND PRJOO1 USER SCREEN in the folder where WinGP is ins
67. Systems Co Ltd H series SIO H series Ethernet Meidensha Corporation Ltd UNISEQUE series Ethernet GE Fanuc Automation Series90 Ethernet Series 90 30 70 SNP Series 90 30 70 SNP X LS Industrial Systems Co Ltd MASTER K series Cnet XGT Series FENet Saia Burgess Controls Ltd Saia S Bus SIO Sharp MS Corporation JW series PC link SIO JW PC link Ethernet FANUC Ltd Power Mate series Mitsubishi Heavy Industries Ltd DIASYS Netmation MODBUS TCP Matsushita Electric Works Ltd FP series PC link SIO Systems Co Ltd Fuji Electric FA Components amp MICREX F series SIO JTEKT Corporation TOYOPUC CMP LINK Ethernet TOYOPUC CMP LINK SIO RKC Instrument Inc Controller MODBUS SIO Temperature controller GP Pro EX Reference Manual 37 8 Operating Environment 37 2 3 Model Environment In this section the following system configuration is used as a model to explain the operations and features In other system configurations the display and part names may differ If so replace the names with those with similar features used in your system configuration E Standard Configuration Hardware Aner A Model system specifications Remarks OS Windows 2000 Q QnA serial communication series Device ete manufactured by Mitsubishi Electric Corporation IPC PS 3650A GP Pro EX Reference Manua
68. TR owsErrorMessage Argument Return value iErrorCode In error code returned by the WinGP SDK function Normal Any osErrorMessage Out pointer to the area where the converted string ASCID is stored value other than prepare for 1024 bytes or more owsErrorMessage Out pointer to the area where the converted string UNICODE is stored prepare for 2048 bytes or more Zero Failed to convert string for example unused error code 0 GP Pro EX Reference Manual 37 98 API Function List Special Item e EasyLoadErrorMessage is used to call a function in the WinGP API and when the func tion returns an error code this message is converted into a message e The WinGP SDK remembers only one set of error status information for each handle As aresult after an error occurs in the API call EasyLoadErrorMessage right away Do not call a different API function or else the API will overwrite the error status information and EasyLoadErrorMessage will not return the desired error status GP Pro EX Reference Manual 37 99 API Function List Other APIs Function Name Read IPC Time as DWORD Function to acquire the current time as a numeric value DWORD format from the defined station This function is valid only with the time stored in LS2048 6 words DWORD WINAPI EasyGetGPTime LPCSTR sNodeName DWORD odwTime Argument Return value sNodeName The station name is fixed a
69. UINT16 pus_VersionInfo 1_RuntimeHandle i The WinGP handle it gets the information from Argument aie pus_VersionInfo 0 Version information Status 0 Completed 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc e Exit Operation Requests WinGP to end Function INT32 StopRuntime Nam INT32 1_RuntimeHandle ame INT32 1_StopMode 1_RuntimeHandle i The WinGP handle for operation Argument 1_StopMode 1 End mode Unused 0 Normal end 1 End confirmation dialog enabled Return value Status 0 Completed 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc e Changing the display screen number Requests screen number change in WinGP INT32 SetDisplayScreenNumber Return value ee INT32 1_RuntimeHandle amg INT32 1_ScreenNumber Ardument l_RuntimeHandle i The WinGP handle for operation g 1_ScreenNumber i Screen number Status 0 Completed 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Referenc e Manual 37 82 API Function List e Changing the screen state Changes the screen display state in WinGP Function Name INT32 SetScreenState INT32 INT32 INT32 INT32 INT32 INT32 1_RuntimeHandle 1_ScreenState 1_PosX 1_PosY 1_Width 1_ Height Argument 1_RuntimeHandle i The WinGP handle for operation 1_ Scree
70. WinGP SDK Xx WinGP SDK Setup completed successfully GP Pro EX Reference Manual 37 13 Development Process 8 Once the installation is complete the following message appears Select Yes and restart the IPC or PC fe WinGP Installer Information You must restart your system For the configuration changes made to WinGP to take effect Click Yes to restart now or No if you plan to restart later Kmi e After the installation restart the IPC before using WinGP The WinGP will not operate properly without restarting the WinGP Uninstall There are 2 ways to uninstall e Ona PC uninstall with Add Remove Programs on the control panel From the Start button select Settings S and click Control Panel C When Control Panel opens select Add Remove Program In the list of installed applications select GP Pro EX 2 00 WinGP and click Remove to uninstall e Uninstall WinGP using GP Pro EX CD ROM Insert the GP Pro EX CD ROM The following screen appears and click Next N and follow the wizard to uninstall WinGP WinGP InstallShield Wizard Welcome to the InstallShield Wizard for WinGP The InstallShield R Wizard will install WinGP on your computer To continue click Next WARNING This program is protected by copyright law and international treaties e WinGP SDK is uninstalled together with WinGP e Uninstalling Pro Server EX V1 10 from the PC with WinGP and Pro Server E
71. X is not supported 1062207356 XX NODE name 3232759940 OxCOB00095__ Symbol Sheet XX Symbol XX Decrease the number of symbols SAAA149 No of Devices XX is beyond the registered on the Symbol screen 1062207339 range of the no of devices Valid 3232759957 Range XX XX OxCOBO0096 Symbol Sheet XX Group XX SAAA150 has the no of rows beyond the 1062207338 limit Please reduce it XX rows 3232759958 or less 0xC0B0009C In a symbol sheet 2 symbol group Change the name of the symbol SAAA156 names are the same Symbol registered on the GP Pro EX 1062207332 Sheet XX Namel XX Name2 Symbol screen 3232759964 xx OxCOBOO009D The device driver of Node XX Please install device differences SAAA157 is not supported Necessary 1062207331 driver has not been installed 3232759965 XX NODE name OxCOBOO0A9 s s The specified Device A device beyond the valid device SAAA169 Symbol is beyond the valid device range was accessed 1062207319 range Valid Range XX XX 3232759977 OxCOBOOOEO Warning In different symbol In the GP Pro EX Symbol setting SAAA224 sheets 2 symbol group names are screen please change the name to 1062207264 the same To use the same name avoid name overlapping 3232760032 please specify both sheet names Symbol Sheet1 XX Symbol Sheet2 XX The Same Name XX XX Existing Symbol Sheet name XX Symbol
72. X Reference Manual 37 164 Settings Guide 37 9 1 Restrictions On Install If the path has more than 200 single byte characters in the folder where WinGP is installed an error Cannot start because the installation folder will exceed 200 characters appears when simulation starts and it will not operate properly Use a path less than 200 single byte characters and reinstall WinGP If you install WinGP on an OS that does not support it an error message appears and the installation cannot be completed To install log on with an account with Windows Administrator authority You cannot install WinGP more than once even to another folder To uninstall insert the install CD in the IPC on which WinGP is installed WinGP does not allow for recovery install To recover uninstall and then reinstall WinGP You can install WinGP on your PC but it will not run To install WinGP to IPC with Pro Server with Pro Studio for Windows or Pro Server EX installed you might not be able to install WinGP in some cases depending on the install state The below shows the install state WinGP install The following message appears and WinGP cannot be installed Install state Pro Server with Pro Studio for Windows has already been installed ProExSetup x WinGP cannot be installed in PC in which Pro Server EX earlier than Y1 10 is installed Install WinGP after performing either of the following Uninstalling Pro Server EX Updating Pro
73. X V1 10 API communication is disabled Please re install WinGP GP Pro EX Reference Manual 37 14 Development Process E Start and Create GP Pro EX Start GP Pro EX and create a new project file cw 5 2 Starting Creating Saving Finishing page 5 7 m Display Device PLC Selection Select Display Unit and Device PLC NOTE e Please refer to the settings guide for details SF 5 14 2 New Settings Guide page 5 76 1 In Display Unit select IPC Series from Series fE New Project File 6 Prok 1024x768GA F a GP Pro EX Reference Manual 37 15 Development Process 2 Select Maker and Series to connect to the IPC If connecting to the IPC COM port and the device PLC select COM1 to COM9 in Port New Project File GP Pro BX flee Eeesies GP Pro EX Reference Manual 37 16 Development Process E Create and Save Screens in GP Pro EX Create and save screens in GP Pro EX For creating and saving screens see below w 5 2 Starting Creating Saving Finishing page 5 7 e Since the GP and IPC have different hardware the available features will dif fer For features available in WinGP see below 37 1 3 Differences between IPC and GP page 37 4 E Transfer Transfer project files to the IPC Like creating GP Pro EX screens on another PC and transferring the project file to the IPC the transfer process differs when GP Pro
74. ad API for Single Handle Function Name Group Symbol INT WINAPI ReadSymbol LPCSTR sNodeName LPCSTR sSymbolName LPVOID oReadBufferData Function Name Group Symbol Variant Type INT WINAPI ReadSymbol Variant LPCSTR sNodeName LPCSTR sSymbolName LPVARIANT pData e Cache Write API for Single Handle Function Name Group Symbol INT WINAPI WriteSymbolID LPCSTR sNodeName LPCSTR sSymbolName LPVOID pWriteBufferData Function Name Group Symbol Variant Type INT WINAPI WriteSymbol VariantD LPCSTR sNodeName LPCSTR sSymbolName LPVARIANT pData GP Pro EX Reference Manual 37 90 API Function List Parameter for Read Write lt Argument gt sNodeName The station name is fixed as WinGP sDeviceName Directly describes the symbol names and device addresses registered in GP Pro EX For example 1 Use a symbol to specify For example 2 Directly specify the device address M100 SWITCH1 The following table shows the data types that can be specified by each function Symbol data type 16 Bit 32 Bit euch Bit Signed Signed Float Double String Unsigned BCD Unsigned BCD Hex Hex XXXDeviceBit O XXXDevice16 O XXXDevice32 O XXXDeviceBCD16 O XXXDeviceBCD32 O XXXDeviceFloat O
75. ae Switch Switch Special Action Start Application Path Parameter I Prevent multiple instances Window Title r Cre For Example Execute sample exe in C Documents and Settings user Local Settings Temp Specification Example Method f For Example C Documents and Settings user Local Specii ike Ml path Settings Tempsample exe i In the IPC Series Windows Control Panel System Details Environment Variable you can control EXE name only only the following executable files For Example sample exe With an environment variable specify the Path C Documents and Settings user Local Settings Temp You can specify the path with an environment variable only when the folder set in TEMP for the environment variable in Control Specify the path with Panel gt System gt Detail gt Environment Variable has the execution an environment file variable For Example TEMP sample exe With an environment variable specify TEMP C Documents and Settings user Local Settings Temp GP Pro EX Reference Manual 37 73 Executing the application from the WinGP 6 Select the option Argument to run the executable using the Parameter Up to 255 characters can be used to set the Parameter For example Start a Microsoft Excel file Specify the EXCEL EXE path EXE path For Example Execute sample exe in C Program Files Microsoft Office Office EXCEL EXE Specify
76. afxdisp h gt in stdafx h to avoid an error GP Pro EX Reference Manual 37 169 Settings Guide 37 9 5 Transfer Restrictions sss Se e You cannot transfer using modem or COM port e During the initialization process after start up WinGP displays a screen asking for a retransfer request if any error damage or loss is found in the necessary file e If you transfer the project file to a different type of IPC an error dialog box is displayed indicating that the model differs and the transfer cannot be completed To transfer the file to a different model convert the model using the editor before transfer e You need to exit WinGP because ProjectCopy Copy Tool updates the files used in WinGP If you try to use copy operation while WinGP is operating an error message is displayed and the copy operation is not executed AB e When OS is Windows XP Embedded you can set the Write Filter in a driver C drive of the system using IPC tool WinGP is installed in C drive and th e Write Filter is enabled WinGP system files or screen data cannot be updated Disable the Write Filter before starting transfer e WinGP allows for changing the port number with the transfer tool You cannot LAN transfer from the transfer tool if you forget the new port number E Restrictions when using ProjectCopy Copy Tool e Sends only screen data when using the copy tool Receiving screen data or transferring all projects are not available e When using the Cop
77. ames may not displayed correctly depending on the connected environment OS or language settings IMPORTANT When Windows XP Embedded is used for the IPC OS you can set the Write Filter Write Protection on the system drive C drive using the settings in IPC If the Write Filter setting is enabled and the destination settings of CF Card and USB memory is set to C driver files cannot be written Make sure to set the drive which does not have the Write Filter setting in CF Card and USB memory If no folder is specified CFAOO folder USB HD folder at the installed location become the default folders and they may not allow Writing data GP Pro EX Reference Manual 37 159 Settings Guide E Transfer Settings Transfer Settings Port 21 5 E Setting Description Port Specifies the port number to use for transfer from 0 to 65535 If you forgot the port number for the Transfer Tool check WinGP Settings Transfer in the Offline Mode E API Communication API Communication Port peo g Setting Description Use API Specifies whether to use API communication handling API or device communication access API Specifies the port number to use for API transfer from 0 to 65535 e In Peripheral Settings check which port is used by the other device PLC to avoid using the same port GP Pro EX Reference Manual 37 160 Settings Guide 37 8 2 Window Frame Settings
78. andles GetProjectInfo Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Try Parameter range to get Dim ProjectFileName As New System Text StringBuilder PROJECTINFO_SIZE e_FileName Dim ProjectComment As New System Text StringBuilder PROJECTINFO_SIZE e_Comment Dim ProjectFastTime As New System Text StringBuilder PROJECTINFO_SIZE e_FastTime Dim ProjectLastTime As New System Text StringBuilder PROJECTINFO_SIZE e_LastTime Dim ProjectIDownload As New System Text StringBuilder PROJECTINFO_SIZE e_IDownload Dim HMIEditorVersion As New System Text StringBuilder PROJECTINFO_SIZE e_HMIEditorVersion Dim ControlEditorVersion As New System Text StringBuilder PROJECTINFO_SIZE e_ControlEditorVersion Dim MakingPerson As New System Text StringBuilder PROJECTINFO_SIZE e_MakingPerson Gets the project information Dim RetVal As Int32 RetVal GetProjctInformation ghWinGP _ ProjectFileName _ ProjectComment _ ProjectFastTime _ ProjectLastTime _ ProjectIDownload _ HMIEditor Version _ ControlEditorVersion _ MakingPerson Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal Trim GetProjctInformation End If Display the information you got Me Prj_File Text ProjectFileName ToString Me Prj_Comment Text ProjectComment ToString GP Pro EX Reference Manual 37 63 Retrieve WinGP information or Operate WinGP from user application
79. ate Sub Write32_Click Write data Dim nDataAry 1 As Long nDataAry 0 CLng Val Me WBuf_32 Text Write Dim iResult As Long iResult WriteDevice32 WinGP Buf _32 nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If End Sub Private Sub WriteFloat_Click Write data Dim nDataAry 1 As Single GP Pro EX Reference Manual 37 50 Retrieve WinGP information or Operate WinGP from user application nDataAry 0 CSng Val Me WBuf_Float Text Write Dim iResult As Long iResult WriteDeviceFloat WinGP Buf_Float nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If End Sub Private Sub WriteDouble_Click Write data Dim nDataAry 1 As Double nDataAry 0 CDbl Val Me WBuf_Double Text Write Dim iResult As Long iResult WriteDeviceDouble WinGP Buf Double nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If End Sub Private Sub WriteString_Click Write data Dim nDataAry As String nDataAry Me WBuf_Str Text Write Dim iResult As Long iResult WriteDeviceStr WinGP Buf_Str nDataAry 10 If iResult Then Dim sErrMsg As String 512 Dim iM
80. card see Special Items Problem Error wReadFileNo File number of the file to read from the CF card code sWriteFileName File name and path for saving the CF card file odwFileSize Fize size of the file read from the CF card Special Item The supported file types are as follows You can only read items stored in the defined CF card folder File Types Data Class File Type Folder Filing Data ZF or F FILE CSV Data ZR FILE Image Screen Zl or DATA Sound Data ZO or O DATA Acne trend graph data ZT TREND S OA sampling data ZS TREND Alarm1 Z1 or ZA ALARM Alarm2 Z2 or ZH ALARM Alarm3 Z3 or ZG ALARM Alarm4 8 Z4 Z8 ALARM e logging data ZL LOG Capture data CP CAPTURE Sampling1 64 ZS1 ZS64 SAMP01 SAMP64 GP Pro EX Reference Manual 37 108 API Function List Function Name Write to CF card file optionally define file name Function to write the defined file to the CF card You can optionally define the file name to save INT WINAPI EasyFileWriteInCfCard LPCSTR sNodeName LPCSTR pReadFileName LPCSTR sFolderName LPCSTR sFileName Argument sNodeName sFolderName sFileName pReadFileName The station name is fixed as WinGP The file name full path of the source file to save to the CF card Folder name of the file to save to CF card maximum 32 single byte char acters File name 8 3 string format of the file to save to CF card Return value Normal 0 Problem
81. cations are designed based on applications to operate the message pump properly In order to prevent such event as shown in the example WinGP SDK operates the message pump in the function when processing takes too long GP Pro EX Reference Manual 37 118 API Function List Prohibit Double Calling API e API double calling WinGP SDK prohibits calling another device access API during a call to one device access API Double calling However device access API is operating the message pump in the API if an event happens the user program starts In the course of the message processing routine double calling might occur when API is called The below shows a case resulting in double calling 1 Pressing two buttons results in double calling There are two buttons of A and B If you press A it calls the device read API If you press B it calls the device write API In this case if you press B button while calling the device read API while pressing A button the device write API is also called which leads to API double calling and an error results The processing is taking time so API calls the message pump Message A button Message B button pump p processing 3 pump processing a Routine Reading gt Routine Writing API call API call Processing completed ae OTP lt 4 API double calling results in an error return 2 Double calling with a timer A timer
82. code Me Prj_Date Text StrConv ProjectFastTime vbFromUnicode Me Prj_LastDate Text StrConv ProjectLastTime vbFromUnicode Me Prj_HMI Text StrConv HMIEditorVersion vbFromUnicode Me Prj_Person Text StrConv MakingPerson vbFromUnicode Screen MousePointer vbDefault Changes the cursor back to the original End Sub 13 Exit Exits following the confirmation dialog box WinGP does not end if you select Do not exit in the dialog You can go back to the Return value with API_LERROR E_SUCCESS Private Sub StopWinGP_Q_ ClickQ Screen MousePointer vbHourglass Changes the cursor to an hourglass Exit APD Dim RetVal As Long RetVal StopRuntime ghWinGP 1 Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal StopRuntime End If Screen MousePointer vbDefault Changes the cursor back to the original End Sub GP Pro EX Reference Manual 37 70 Executing the application from the WinGP 37 6 Executing the application from the WinGP 37 6 1 Introduction User Defined WinGP screen E d f y WinGP screen San Start Application IPC series IPC series On the WinGP screen you can execute other applications There are four ways to execute applications as below Using a switch for startup 37 6 2 Switch Startup Settings page 37 72 Using D Script for startup 37 6 3 D Script startup settings page 37 7
83. ct Converter Tools Git 3 Select WinGP 67 Prok lt SET UP MENU WinGP OY Pass Through Movie Converter Top Exit 4 The install wizard starts automatically Follow the wizard to install 5 During installation you are asked to enter the key code Enter your separately purchased key code type EX WINGP IPC i WinGP InstallShield Wizard Key Code Input Key Code Key Code fi 111 2222 3333 WinGP doesn t operate when installing it besides IPC that operates Installshield Cancel GP Pro EX Reference Manual 37 12 Development Process e For details on key codes see below S 37 1 1 What is WinGP page 37 2 6 After WinGP is installed install WinGP SDK sequentially Click Continue WinGP InstallShield Wizard InstallShield Wizard Completed WinGP has been installed Click Continue to install the WinGP SDK Back i Continue j Cancel e WinGP SDK is software for communicating with external applications created on the WinGP and VB Net VB or VC using API If Pro Server EX V1 10 or later is already installed WinGP SDK will not install and only WinGP will be installed In this case device access API is available on Pro Server EX V1 10 For restrictions on installation see below 37 9 1 Restrictions On Install page 37 165 7 The following message appears Click OK to complete the installation
84. d Dim iResult As Long iResult ReadDeviceFloat WinGP Buf_Float nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessage iResult sErrMsg MsgBox sErrMsg End If Me Buf_Float Text CStr nDataAry 0 End Sub Private Sub ReadDouble_Click Read data Dim nDataAry 1 As Double Read Dim iResult As Long iResult ReadDeviceDouble WinGP Buf_Double nDataAry 0 1 GP Pro EX Reference Manual 37 53 Retrieve WinGP information or Operate WinGP from user application If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessage iResult sErrMsg MsgBox sErrMsg End If Me Buf_Double Text CStr nDataAry 0 End Sub Private Sub ReadString Click Read data Dim nDataAry As String 255 Read Dim iResult As Long iResult ReadDeviceStr WinGP Buf_Str nDataAry 10 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessage iResult sErrMsg MsgBox sErrMsg End If Me Buf_Str Text nDataAry End Sub GP Pro EX Reference Manual 37 54 Retrieve WinGP information or Operate WinGP from user application 37 5 4 A sample to retrieve the WinGP status and change the settings Handling API E Sample Summary Switching the tabs from Status 1 to Information End allows you to retrieve the WinGP status and change the settings Status 1 tab In Sta
85. dded has a write protection setting To install WinGP on your C drive you need to disable the write protection filter setting Using EWFSettingTool exe select EWE Disable to disable the setting before installation Windows XP Embedded users manual 3 1 Write filter setting process e Pro Server EX Version Before V1 10 or Pro Server with Pro Studio Users You cannot install WinGP on the IPC with Pro Server EX older than V1 10 or Pro Server with Pro Studio installed Uninstall or update Pro Server EX to V1 10 or later The following figure shows what happens if you attempt to install Pro Server EX older than V1 10 or Pro Server with Pro Studio after installing WinGP e Installing Pro Server EX version previous to V1 10 A message indicates a different version of Pro Server EX is installed and the installation cannot be performed Please install Pro Server EX V1 10 or higher e Installing Pro Server with Pro Studio You can install WinGP in this environment although Pro Server with Pro Studio and WinGP will not operate If you install Pro Server with Pro Studio and WinGP please uninstall both applications which cannot reside on the same IPC GP Pro EX Reference Manual 37 11 Development Process Installation Procedures 1 Insert a GP Pro EX Ver 2 00 or later CD ROM in the IPC or PC 2 The installer screen below will start up Select Tool Installation GP ProE lt SET UP MENU GP Pro EX Transfer Tool Proje
86. dex idx Exit For End If Next End If Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub Private Sub SetDispScreen_Click ByVal sender As System Object ByVal e As System EventArgs Handles SetDispScreen Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Try Gets the screen number Dim Screen As Int32 Screen Val Me CB_DispScreen Text Changes the screen number Dim RetVal As Int32 SetDisplayScreenNumber ghWinGP Screen Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str Ret Val Trim SetDisplayScreenNumber End If Gets the screen number again and compare it with the set value to see whether the screen number is changed successfully Dim NowScrNo As Long RetVal GetDisplayScreenNumber ghWinGP NowScrNo If RetVal API_ERROR E_SUCCESS Then If NowScrNo Screen Then MsgBox Screen change number No Str NowScrNo End If GP Pro EX Reference Manual 37 61 Retrieve WinGP information or Operate WinGP from user application End If Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub GP Pro EX Reference Manual 37 62 Retrieve WinGP information or Operate WinGP from user application Private Sub GetProjectInfo_Click ByVal sender As System Object ByVal e As System EventArgs H
87. e 4th line Error code without decimal code GP Pro EX Reference Manual 37 137 API Function List Error Code Error Message Cause and Troubleshooting 0xC0B00245 Queuing access registration has Please check the program SAAF069 not started sequence 1062206907 3232760389 OxCOB00246 Actual queuing access has not SAAF070 been made 1062206906 3232760390 0xC0B00247 The device access to the specified Please check the cable device SAAFO71 no failed requirements 1062206905 3232760391 0xC0B00248 The device access with the Please check the program SAAF072 specified no has not been sequence 1062206904 registered Please check the 3232760392 preregistered access count and no 0xC0B0024C The specified group no is not Please review the API parameters SAAF076 within the range of sampling data 1062206900 group no 3232760396 OxCOB0024D In Queuing Access Read and Please check the sequence of the SAAF077 Write cannot be mixed program 1062206899 3232760397 0xC0B00250 No word exists Please review the API parameters SAAF080 1062206896 3232760400 0xC0B00251 Invalid name word Illegal SAAF081 characters are included 1062206895 3232760401 OxCOB00252 The specified node has not been SAAF082 registered in the network project 1062206894 3232760402 0xC0B00253 The specified device has not been SAAF083 registered 1062206893 3232760
88. e IPC and there are applications that have been developed specifically for the IPC Project files created in GP Pro EX IPC series E Purchasing Licenses To use the WinGP you need to purchase the license separately When you purchase the license a document with the Key code will be issued e To install WinGP the key code is required Please purchase the WinGP license separately Type EX WINGP IPC See below for the installation procedure SF 37 3 0 Setup Procedure page 37 11 The key code cannot be reissued if lost Store it securely Install Enter the key code s IPC Key code s GP Pro EX Reference Manual 37 2 WinGP Overview 37 1 2 Full Configuration The following figure shows the connections and option environment for using WinGP Bar Code Reader Transfer tool CF Card User Defined Application GP Pro EX Reference Manual 37 3 WinGP Overview 37 1 3 Differences between IPC and GP Since the IPC has a larger memory and storage the size of screen data and record data can be expanded as shown below unlike the GP 3500 series Model Function Expansion Range Max user data size 8 MB gt 16 MB Max SRAM size 512 KB 5 MB 1 2 3 Max number of parts per screen 384 parts 1280 parts 4 Max number of devices per 1152 parts 3000 parts screen
89. e Summary e Write nication Sample for B NET BEE E READ Click the button to write the input data into the text box Bit OoOo Float ooo 16Bt J Double 32Bt String mz e Read HF API Communication Sample for B NET z Click the button to read the data into the text box Bit sd Float O O i 16Bt J Double 32Bit String a GP Pro EX Reference Manual 37 37 Retrieve WinGP information or Operate WinGP from user application The sample uses the following symbols as examples Symbol name Address browsed by the symbol Buf_Bit USR200 00th bit Buf_16 USR201 Buf_32 USR203 Buf_Float USR207 Buf_Double USR209 Buf_Str USR213 m How to specify device addresses directly e When one Device PLC driver is specified for WinGP WriteDeviceBit WinGP M100 nDataAry 0 1 e When more than one device PLC drivers are specified for WinGP WriteDeviceBit WinGP PLC1 M100 nDataAry 0 1 A Device PLC name connected to WinGP e When using the memory link driver WriteDeviceBit WinGP MEMLINK 10000 nDataAry 0 1 e When using WinGP Internal Device WriteDeviceBit WinGP USR10000 nDataAry 0 1 WriteDeviceBit WinGP LS10000 nDataAry 0 1 Or WriteDeviceBit WinGP INTERNAL USR10000 nDataAry 0 1 WriteDeviceBit WinGP 4INTERNAL LS10000 nDataAry 0 1 m VB Net 2003 Program Examples Sample Program Location In GP Pro EX CD ROM
90. e access API start WinGP first An error results if you use the device access API without starting WinGP A timeout error results if you start the device API after exiting WinGP Do not set IPC standby while API is communicating using the user application A user application should control that IPC goes to a standby mode only after the operation of device access API is completed To add a protocol to update the Pro Server EX version you need to install the protocol module updated in GP Pro EX to IPC with WinGP SDK installed In ReadSymbolD ReadSymbol VariantD WriteS ymbolD WriteS ymbol VariantD API you cannot use any array variable that exceeds the below array size Array variable type Maximum size accessible with WinGP API communication Bit Variable 255 Integer Variable 510 Float Variable 510 If you install Pro Server EX V1 10 you have to control Pro Server EX separately You cannot use the device API in IPC unless it has TCP IP settings Be sure to check that the network settings have TCP IP protocol installed If you exit WinGP while accessing the device access API all the returns from API result in an error If you compile the header created in Visual C Ver 6 C Program files Pro face WinGP SDK VC Public ProEasy h or Pro Studio Programming Support VC Statement via clip board LPVARIANT might result in undefined error LPVARIANT is defined in afxdisp h Include this by defining include lt
91. eEx iResult sErrMsg MsgBox sErrMsg End If Me Buf_Double Text CDbl nDataAry 0 GP Pro EX Reference Manual 37 42 Retrieve WinGP information or Operate WinGP from user application Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub ReadStr_Click By Val sender As System Object ByVal e As System EventArgs Handles ReadStr Click Try Read data Dim nDataAry As String Read Dim iResult As Integer ProEasy ReadDeviceStr WinGP Buf _Str nDataAry 10 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Me Buf_Str Text nDataAry Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub ReadVariant_Click ByVal sender As System Object ByVal e As System EventArgs Handles ReadVariant Click End Sub Private Sub ReadSymbol_Click ByVal sender As System Object ByVal e As System EventArgs Handles ReadSymbol Click End Sub GP Pro EX Reference Manual 37 43 Retrieve WinGP information or Operate WinGP from user application Private Sub WriteBit_Click By Val sender As System Object ByVal e As System EventArgs Handles WriteBit Click Try Write data Dim nDataAry 1 As Short nDataAry 0 CShort Val Me WBuf_Bit Text Write Dim iResult As Integer ProEasy WriteDeviceBit WinGP Buf_16 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox s
92. ed in initializing the LAN 9508 2524h No data 9509 2525h Invalid device 9510 2526h Invalid address 9511 2527h The address is out of the valid range 9512 2528h Data type error 9513 2529h Transmission message error 9514 252Ah Cannot initialize Pro Server cache function 9515 252Bh Cannot load the network project because the database is used 9516 252Ch f Reserved 9559 2557h 9560 2558h System Error DLL load error 9561 2559h System Error DLL version may be old 9562 255Ah System Error 9563 255Bh The designated property ID is not defined version may be old 9564 255Ch Value conversion error Incorrect characters as numbers are designated 9565 255Dh_ Too many characters 9566 255Eh_ The number is too large 9567 255Fh System Error Cannot start COMM 9568 2560h System Error Cannot start GP Viewer runtime 9569 2561h Cannot open the s file 9570 2562h File read error 9571 2563h File write error 9572 2564h No tags exist No parameter class declarations exist 9573 2565h No end tags exist No parameter class declarations exist 9574 2566h Found the unexpected end tag No parameter class declarations exist 9575 2567h Signatures do not match 9576 2568h Unsupported parameter 9577 2569h Reached the file end 9578 256Ah The incorrect structure 9579 256Bh Cannot continue the process due to a memory lack 9580 256Ch Cannot analyze the device name Continued GP Pro EX
93. environment Option Explicit Private Sub Form_Load Initialize API API Dim nResult As Long nResult InitRuntimeAPI Gets the handle at this stage API ghWinGP GetRuntimeHandle 9800 If ghWinGP 0 Then MsgBox API Failed to get handle End If End Sub Private Sub Bt_GetStartState_Click Screen MousePointer vbHourglass Gets the state API Dim Status As Long Dim RetVal As Long RetVal GetRuntimeStartState ghWinGP Status Any error If RetVal lt gt CLng API_ERROR E_SUCCESS Then MsgBox Err Str RetVal GetRuntimeStartState End If Display the state Select Case Status Case 0 Me StartState Text Starting Case 1 Me StartState Text Online Case 2 GP Pro EX Reference Manual 37 65 Retrieve WinGP information or Operate WinGP from user application Me StartState Text Offline Case 3 Me StartState Text Transfer mode Case 4 Me StartState Text Ending Case 5 Me StartState Text Not execute End Select Screen MousePointer vbDefault End Sub Private Sub BT_GetScreenState_Click Screen MousePointer vbHourglass Gets the state Dim Status As Long Dim RetVal As Long RetVal GetScreenState ghWinGP Status Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal Trim GetScreenState End If Display the state Select Case Status Case 0 1 2 Me ScreenState ListIndex Statu
94. er and the Receiver nodes 9641 25A9h Either that the device write failed at the Receiver node or that no partner nodes exist while providing data 9642 25AAh Reserved 9659 25BBh 9660 25BCh_ Data Read failed 9661 25BDh Invalid access range of the read device Continued GP Pro EX Reference Manual 37 148 API Function List Error Code M Dacinal JE essage decimal 9662 25BEh Reserved 9669 25C5h 9670 25C6h _ It is an access range wrong point by the write of device 9671 25C7h f f Reserved 9699 25E3h 9700 25E4h Received the first trigger establish command for non existing provider information 9701 25E5h Reserved 9709 25EDh 9710 25EEh Received the second trigger establish command for non existing provider information 9711 25EFh Reserved 9729 2601h 9730 2602h The GP is busy sending screen data or saving SRAM backup data to another PC 9731 2603h An error occurred in reading the SRAM backup data The item ID differs from the previous ID 9732 2604h An error occurred in reading the SRAM backup data The data type differs from the previous type 9733 2605h An error occurred in reading the SRAM backup data The block No differs from the previous No 9734 2606h SRAM backup data read error The requested data amount is 0 or differs from the previous amount 9735 2607h Reserved 9739 260Bh 9740 260Ch_ The GP
95. er of members in the defined group symbol or symbol sheet which is the total symbols and groups INT WINAPI GetCountOfSymbolMember LPCSTR sNodeName LPCSTR sSymbolName INT oiCountOfMember Argument Return value sNodeName The station name is fixed as WinGP Normal End 0 sSymbolName In Group symbol name or symbol sheet name to search for Problem Error oiCountOfMember Out Number of members to find Code Special Item When the defined group symbol contain another group symbol even if there are multiple device symbols inside the internal group symbol the device symbols get counted as one member Searches for definition information about symbol group Function Name symbol sheet Searches for the definition information such as the data format and data size of the defined device symbol group symbol or symbol sheet INT WINAPI GetSymbolInformation LPCSTR sNodeName LPCSTR sSymbolName INT iMaxCountOfSymbolMember LPSTR osSymbolSheetName S ymbolInformation oSymbolInformation INT oiGotCountOfS ymbolMember Argument Return value sNodeName The station name is fixed as WinGP Normal End 0 sSymbolName In Symbol group name sheet name Problem Error iMaxCountOfSymbolMember In Define the maximum value 1 or more for the search Code information Defines the quantity in oSymbolInformation osSymbolSheetName Out Returns the symbol sheet name belonging to ssymbolName Please prepare a workspace of 66 by
96. erly Continued GP Pro EX Reference Manual 37 100 API Function List Special Item Formatting codes following the percent sign are replaced as shown in the following table Other characters are not converted and display as is For example if the clock is 2006 1 2 12 34 56 and you define 7Y_ M PS the string becomes 2006_34 56 Formatting Code Folder a Day abbreviated 2 A Day 2 b Month abbreviated 2 B Month 2 C Locale related date and time YoH C Locale related date and time long form d Day as decimal value 01 31 1 H 24 Hour Clock 00 23 1 l 12 Hour Clock 01 12 1 Aj Day of year as decimal value 001 366 1 mM Month as decimal value 01 12 1 M Minutes as decimal value 00 59 1 p AM PM for locale 2 S Seconds as decimal value 00 59 1 Week of year as decimal value The first Sunday of the year is the first week 00 53 1 YW Day as decimal value Sunday is 0 0 6 1 Week of year as decimal value The first Monday of the year is the first U FNN week 00 53 1 X Date of current locale YHX Date of current locale long form oX Time of current locale 2 Wy 2 digit Year as decimal value 00 99 1 y 4 digit Year as decimal value 1 Az Z Time zone or time zone abbreviation When time zone is unknown character is not entered 2 A Pe
97. es to exit the WinGP Parameter1 1 Confirm GP Pro EX Reference Manual 37 31 Settings Menu 37 4 Settings Menu Retrieve WinGP information or Operate WinGP from user application API allows the operations such as Read Write between the WinGP and user applications ee Procedure page 37 34 Introduction page 37 33 Data read write IPC series Executing the application from the WinGP You can execute other applications from the WinGP screen peek amp Switch Startup Settings page fae a WinGP screen Le tart Start Application WinGP screen amp Introduction page 37 71 IPC series IPC series GP Pro EX Reference Manual 37 32 Retrieve WinGP information or Operate WinGP from user application 37 5 Retrieve WinGP information or Operate WinGP from user application 37 5 1 Introduction User Defined Application WinGP screen Data read write IPC series API allows to retrieve WinGP information or operate WinGP from user applications GP Pro EX Reference Manual 37 33 Retrieve WinGP information or Operate WinGP from user application 37 5 2 Procedure e Please refer to the settings guide for details SF 37 84 System Settings Display Unit Settings IPC Settings Settings Guide page 37 154 User Defined Application Data read write
98. ets the information from pl_BuzzerState 0 Buzzer state Argument 0 BUZZERON No Buzzer 1 BUZZEROFF Buzzer 1 UNCERTAINTY Unknown Status Return 0 Completed l 1 Parameter error SEUS 2 Timeout 1 State WinGP does not accept ending etc e Gets the project information Gets the project information in WinGP INT32 GetProjctInformation INT32 1_RuntimeHandle UINT16 pus_ProjectFileName UINT16 pus_ProjectComment Function UINT16 pus_ProjectFastTime Name UINT16 pus_ProjectLastTime UINT16 ps_ProjectIDownload UINT16 pus_HMIEditorVersion UINT16 pus_ControlEditorVersion UINT16 pus_MakingPerson 1_RuntimeHandle i The WinGP handle from which it gets the information ps_ProjectFileName 0 Project file name ps_ProjectComment 0 Project title Comment Argument pus_ProjectFastTime 0 Project creation date pus_ProjectLastTime o0 Project last update date ps_ProjectIDownload o Download date pus_HMIEditorVersion 0 HMI editor version pus_ControlEditorVersion 0 CONTROL editor version pus_MakingPerson 0 Creator name Status R t rh 0 Completed value 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 81 API Function List e Gets the version information Returns the WinGP version INT32 GetRuntimeVersion Return value F ae INT32 1_RuntimeHandle
99. fferent Device PLC driver the error message appears and cancels the transfer You cannot add fonts when the Copy Tool is used If fonts for GP Pro EX are added the additional fonts will not be displayed when the project file is transferred by the Copy Tool GP Pro EX Reference Manual 37 21 Development Process When GP Pro EX and WinGP are installed on the same IPC LMS Ts 1 From the Start menu point to Program Files Pro face WinGP and then click WinGP Or double click on the desktop Bwince File E Help H WinGP SORA Ie M DRDO Ee gt RPE download the Pro Server EX J GP Pro EX e You cannot transfer files when the Screen Offline message is displayed Be sure WinGP is online 2 On the GP Pro EX state tool bar click Transfer Project to launch the transfer tool ie GP Pro EX Project F Edit E View 4 Common Settings R Draw D Py a ol Transfer Project Py D2 hisBia Bile aly 3 In Project Information acknowledge the project file name etc that you are transferring To transfer a different project file click the Select Project button and select the project file GP Pro EX Reference Manual 37 22 Development Process N 4 Click the Transfer Settings button In Port Settings select LAN Deselect the Automatic Search check box and click OK im Transfer Settings
100. fo vb E Formt vb le Solution Explorer Click Browse in the Add Browse dialog box and select the following file In GP Pro EX CD ROM WinGP SDK Pro SDK DotNet BIN WinGPAPIDotNet dll Click Open and select OK At the top of the source code enter Imports ProEasyDotNet lt When using device access API in VB6 gt From VB6 menu bar select Project Add Standard Module and add the following module In GP Pro EX CD ROM WinGP SDK Pro SDK VB API WinGPAPI bas lt When using handling API in VB NET gt From VB NET Menu Bar select Project Add Existing Item and add the following module In GP Pro EX CD ROM WinGP SDK Pro SDK DotNet BIN RtCtrlAPI vb lt When using handling API in VB6 gt From VB6 menu bar select Project Add Standard Module and add the following module In GP Pro EX CD ROM WinGP SDK Pro SDK VB API RtCtrlAPI bas 6 Execute programming NOTE SF 3753 Samples of Read Write Data Device Access API page 37 37 SF 37 5 4 A sample to retrieve the WinGP status and change the settings Handling API page 37 55 7 Set up the user application created on the IPC series 8 Start WinGP and the user application GP Pro EX Reference Manual 37 36 Retrieve WinGP information or Operate WinGP from user application 37 5 3 Samples of Read Write Data Device Access API This section explains the program for API communication using the sample application as shown below E Sampl
101. he data may have been read into RYAA064 an illegal or undefined device 1062272960 address Please specify a proper 3232694336 device address Ist line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 126 API Function List Error Code Error Message Cause and Troubleshooting OxCOAF0041_ Failed to write the device The data may have been written RYAA065 into an illegal or undefined device 1062272959 address Please specify a proper 3232694337 device address OxCOAF0045 The specified request is not A fatal error occurred Restart RYAA069 supported WinGP and WinGP SDK after 1062272955 executing a forced transfer in GP 3232694341 Pro EX OxCOAF0046_ The specified request is not RYAA070 supported 1062272954 3232694342 OxCOAFO050 The project ID of the network RYAA080 project file is different A different 1062272944 network project is being used 3232694352 OxCOAFO0051 The network project file does not RYAA081 have necessary data 1062272943 3232694353 OxCOAFO0052 The network project file is RYAA082 damaged 1062272942 3232694354 OxCOAFO0053_ The network project file does not RYAA083 exist 1062272941 3232694355 OxCOAFO067 Operation was interrupted The operation was interrupted RYAA103 because GP Online was because WinGP
102. he symbol SAAA105 symbol Cannot analyze following the direction of the 1062207383 XX Device Symbol name message 3232759913 OxCOBO006C The network setting is broken Please review the network settings SAAA108 1062207380 3232759916 OxCOB00078 Symbol Sheet XX Symbol XX There is a possibility that the SAAA120 Address XX is invalid as a screen project file is corrupted 1062207368 device address Restart WinGP and WinGP 3232759928 XX Symbol Sheet name XX SDK after executing a forced Symbol name XX Address transfer in GP Pro EX OxCOB0007C Symbol Sheet XX Symbol XX SAAA124 Address XX is beyond the valid 1062207364 device range 3232759932 XX Symbol Sheet name XX Symbol name XX Address 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code 4th line Error code without decimal code GP Pro EX Reference Manual 37 131 API Function List Error Code Error Message Cause and Troubleshooting OxCOB00082 The specified NODE XX has A fatal error occurred Restart SAAA130 not been registered in the network WinGP and WinGP SDK after 1062207358 project executing a forced transfer in GP 3232759938 XX NODE name Pro EX 0xC0B00083 The specified NODE XX is not SAAA131 a GP2000 Series NODE 1062207357 XX NODE name 3232759939 OxCOB00084 The device of the specified SAAA132 NODE X
103. ime The date uses the following format to pack the date into one 16 bit value 9to 15 Bit Expansion Range Oto4 The number of seconds divided by 2 0 29 5 10 Minutes 0 59 11 15 Hours 24 hour clock 0 23 GP Pro EX Reference Manual 37 106 API Function List Function Name Read CF Card file list define file type The file list in the IPC CF card is output to the file sent as a parameter You can optionally define the directory of the file list you want to read by using sDirectory INT WINAPI EasyGetListInCard _LPCSTR sNodeName LPCSTR sDirectory INT oiCount stored in the stEasyDirInfo formatted array is in the quantity returned in the pioCount stored as binary data Saves the filename and extension in uppercase characters struct stEasyDirInfo BYTE bFileName 8 1 File name NULL terminated BYTE bExt 3 1 File extension NULL terminated BYTE bDummy 3 temporary DWORD dwFileSize File size BYTE bFileTimeStamp 8 1 File timestamp NULL terminated BYTE bDummy2 3 temporary2 LPCSTR sSaveFileName Argument Return value sNodeName The station name is fixed as WinGP Normal 0 sDirector Gets the directory name all in uppercase characters Only the following Problem Error directories are supported code LOG logged data TREND trend data ALARM alarm data CAPTURE screen capture data FILE recipe da
104. ion and define the IP address in Internet Protocol TCP IP You cannot define the IP address in the WinGP offline menu GP Pro EX Reference Manual 37 19 Development Process e Transferring from CF Card or USB storage gt y A USB memory 1 Exit WinGP You cannot transfer projects while WinGP is running 2 On the Start menu click Program P gt Pro face gt WinGP gt Project Copy to launch the project copy tool BB rrojectcopy e x Project File C Program Files Pro face GP Pro EX 2 00 Database test prx 5 3 Click the Project File amp icon specify GP Pro Ex project file prx which is stored in the CF Card USB storage or desktop 4 Click Copy The following dialog box appears during transfer BB erojectcopy Of x Project File O Program Files Pro face GP Pro EX2 00 Database test prx a PEE ICE ESS Te as eta Total fel GP Pro EX Reference Manual 37 20 Development Process 5 When copying is complete the following message appears Click OK ProjectCopy xi Copying complete e Only screen data transfer is available using Project Copy Copy Tool Receiving screen data or full transfer of project is not available When using the Copy Tool the system program of WinGP cannot be sent If a project file is set to a different Device PLC driver the project cannot be sent using the Copy Tool When sending the project file with a di
105. is incorrect 9464 24F8h Reserved 9469 24FDh 9470 24FEh Unable to connect to designated Node 9471 24FFh Node is a Windows PC Unable to perform processing 9472 2500h Failed to save captured screen data as JPEG file 9473 2501h Screen Capture is not supported 9474 2502h Capture Approval Flag is not ON 9475 2503h Failed to acquire CF Card free space data 9476 2504h Data Transfer is not supported 9477 2505h ProNet dll has not been installed properly 9478 2506h Unable to perform due to the 2 Way Driver s version not being 4 50 or higher 9479 2507h Reserved 9480 2508h Failed to delete CF Card s file 9481 2509h Failed to change CF Card s internal file 9482 250Ah File exceeds 256 characters reduce number of characters 9483 250Bh Reserved 9499 251Bh 9500 251Ch_ Pro Server schedule management thread initialization error 9501 251Dh Pro Server LAN management thread initialization error 9502 251Eh Pro Server timer management thread initialization error 9503 251Fh_ Pro Server DDE control thread initialization error 9504 2520h Pro Server API control thread initialization error Continued GP Pro EX Reference Manual 37 146 API Function List Error Code Decimal aea Message decimal 9505 2521h Pro Server API parameter error 9506 2522h Response time out 9507 2523h Pro Server fail
106. l 37 9 Development Process 37 3 Development Process 37 3 1 Development Process The following figure shows the process flow from installing WinGP starting GP Pro EX creating screens and connecting to the device PLC to running project files on the IPC Click the link to view the page explaining each process Install WinGP c E Install Uninstall page 37 11 EE Ee a EI Start GP Pro EX and create a new project file c E Start and Create GP Pro EX page 37 15 Select IPC Display Unit and Device PLC Type c tm Display Device PLC Selection page 37 15 Create and save a screen in GP Pro EX c E Create and Save Screens in GP Pro EX page 37 17 Start the WinGP and transfer a project file to the IPC ce E Transfer page 37 17 4 Start and run WinGP c E Start Run WinGP page 37 25 amp For the PLC connection cable see the device connection manual for each maker Exit WinGP ce E Exit WinGP page 37 25 GP Pro EX Reference Manual 37 10 Development Process 37 3 2 Setup Procedure E Install Uninstall Nien WinGP will not operate if installed on a PC that does not support it e Exit all programs including virus check software e Use a user account with administrator authority for installation e Windows XP Embedded Users Windows XP Embe
107. lease check the latest information about supported drivers at the Pro face support site Otasuke Pro http www proface com otasuke The following Device PLC drivers support the WinGP Maker Driver name Digital Electronics Corporation of Japan Memory Link General purpose Ethernet Mitsubishi Electronics Corporation A series CPU direct A series Ethernet A series calculator link FX series CPU direct FX series calculator link Q series CPU direct Q QnA serial communication Q QnA series Ethernet QnA series CPU direct QUTE series CPU direct OMRON Corporation C CV series upper link CS CJ series upper link CS CJ series Ethernet Adjuster Compo Way F Yokogawa Electric Corporation PC link SIO PC link Ethernet Siemens AG SIMATIC S5 CPU Direct SIMATIC S7 3964 R RK512 SIMATIC S7 Ethernet Rockwell Automation DF1 EtherNet IP Schneider Electric Industries MODBUS SIO master MODBUS TCP master Uni Telway GP Pro EX Reference Manual Continued 37 7 Operating Environment Maker Driver name Yaskawa Electric Corporation MEMOBUS SIO MEMOBUS Ethernet MP series SIO Expanded MP series Ethernet Expanded KEYENCE Corporation KV700 1000 series CPU direct Yamatake Corporation Digital controller SIO Hitachi Industrial Equipment
108. lick Try Write data Dim nDataAry 1 As Double nDataAry 0 CDbl Val Me WBuf_Double Text Write Dim iResult As Integer ProEasy WriteDeviceDouble WinGP Buf_Double nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub WriteString_Click By Val sender As System Object ByVal e As System EventArgs Handles WriteString Click GP Pro EX Reference Manual 37 47 Retrieve WinGP information or Operate WinGP from user application Try Write data Dim nDataAry As String nDataAry Me WBuf_Str Text Write Dim iResult As Integer ProEasy WriteDeviceStr WinGP Buf_Str nDataAry 10 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub WriteVariant_Click By Val sender As System Object ByVal e As System EventArgs Handles Write Variant Click In VB NET Variant type is no longer used Instead Object type is used Along the change WriteDevice Variant has been changed to WriteDeviceEasyObject End Sub Private Sub WriteSymbol_Click ByVal sender As System Object ByVal e As System EventArgs Handles WriteS ymbol Click Only WriteSymbol system found is WriteSymbol Variant End Sub End Class GP Pro EX Reference
109. llowing shows nine ways to exit WinGP 1 BEE Click the Close button on the title bar 1 2 Select File Exit from the Menu Bar 3 Right click WinGP screen and click Close File F Help H NOTE Change Panel e If the WinGP is displayed in the Full Screen Offline r O FullScreen Mode Mode you can exit the program using this method X Application Close Continued GP Pro EX Reference Manual 37 25 Development Process 4 Use the switch part to exit yoa E pp Saca amp Use switch parts to exit page 37 27 Special Acton T Display Confirmation Dialog 5 Built In Function Instruction Use D script to exit Sat Asan amp Use D Script to exit page 37 30 Input 6 meszi EE aoe iy Trigger Settings User the trigger action to exit Pa Oo ORS Bit ON Bit OFF Bit Change Trigger Bit Address fIPLC1p lt oo000 m Mode Special Action Exit WinGP bi I Display Confirmation Dialog 7 Press Alt F4 key on the keypad Ho If the WinGP is displayed in the Full Screen Mode you can exit the program using this method Right click the task bar and click Close I s WinGP a 9 Use API to exit F ee f API name StopRuntime Function list Exit Operation 37 82 GP Pro EX Reference Manual 37 26 Development Process Use switch parts to exit Create a switch to exit
110. location size to store the already read text Public Sub Sample 1 Dim strData As String 10 Correct specification method specifying the read size Dim strData As String Wrong specification method not specifying the text size Dim IErr As Long IErr ReadDeviceStr ReadDeviceStrD ReadDeviceVariantD strData 10 If IErr lt gt 0 Then MsgBox Read Error amp IErr Else MsgBox Read String amp strData End If End Sub GP Pro EX Reference Manual 37 120 API Function List 2 Using ReadDevice Variant in VB to read texts If not specifying the location size to store the already read text use Variant type Public Sub Sample 2 Dim IErr As Long Dim vrData As Variant For the location to store the read data specify the Variant type IErr ReadDevice Variant GP1 LS100 vrData 10 EASY_AppKind_Str If Err lt gt 0 Then MsgBox Read Error amp IErr Else MsgBox Read String amp vrData End If End Sub It should be noted that WinGP SDK uses NULL at the end of the text Thus text acquired by the above method has the NULL at the end the text needs to be shortened The below shows sample functions to shorten the text up to the NULL Public Function TrimNull strData As String As String Dim i As Integer i InStr 1 strData Chr 0 vbBinaryCompare If 0 lt i Then TrimNull Left strData i 1 Else TrimNull strData End If End Function GP Pro EX Reference Manual 37 121 API F
111. m the right of 3232760421 access to the file 0xC0B00266 Failed to rename the file Please confirm that the specified SAAF 102 file exists in the CF card folder If 1062206874 it does please check the access 3232760422 right to the file and whether the new file name does not contain any forbidden characters 0xC0B00267 Cannot open the file list retention Please check the access right to the SAAF103 file destination folder If there is no 1062206873 problem with the access right 3232760423 please check whether the drive has enough free space 0xC0B00269 No file name has been inputted Please input a file name SAAF105 1062206871 3232760425 0xC0B0026A Too long file path Please shorten the file path SAAF 106 1062206870 3232760426 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 140 API Function List Error Code Error Message Cause and Troubleshooting OxCOB0026C Connection to GP3000 Series After confirming the GP3000 SAAF 108 NODE was reset Series NODE WinGP Node is 1062206868 still on and the cable is properly 3232760428 connected please execute it again 0xC0B0026D The destination NODE does not SAAF109 respond 1062206867 3232760429 0xC0B0026E Could not complete the operation SAAF110 because connection was broken 1062206866
112. message appears as below ProSrySetup xi A 4 different version of Pro Server EX has already been installed Please uninstall it first and then install this Pro Server EX Pro Server EX Ver1 10 or later After the installer for Pro Server EX Ver1 10 or later starts the following error message appears If you select Yes uninstall WinGP SDK and then install Pro Server EX Ver1 10 ProSrySetup Q WinGP SDK is already installed in this PC It will be uninstalled before Pro Server EX is installed Is that OK Applications for WinGP SDK can be used with Pro Server EX as it is Node setting in Pro Server EX is necessary ves E If you stop installing Pro Server EX Ver1 10 midway reinstall WinGP e If you install WinGP WinGP SDK is also installed in a folder called SDK where GP Pro EX is installed Although the path differs from the path you specified when creating the user application in Pro Server EX you can still use the application created in Pro Server EX without changing the path e If you install Pro Server EX after installing WinGP and uninstall Pro Server EX WinGP SDK becomes unavailable e After the installation restart the IPC before using WinGP The WinGP will not operate properly without restarting the WinGP GP Pro EX Reference Manual 37 166 Settings Guide 37 9 2 Restrictions on Window Frames SSS a SSS SSS SSS SSS SSS SSS SSS SSeS e You can transfer data to an IPC that has
113. nState 1 Screen state 0 FULLSCREEN Full screen 1 WINDOWSCREEN Window screen 2 MINIMUMSCREEN Minimized 1_PosxX i X on the screen coordinate system 1 1_PosY i Y on the screen coordinate system 1 1_Width i Window screen width 1 1_Height i Window screen height 1 1 Coordinate and size are added only on the Window screen The argument is available for settings only when Screen State is set to WINDOWSCREEN for the 2nd argument Return value Status 0 Completed 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 83 API Function List e Changing the language settings Changes the language settings in the system language settings user language settings in WinGP The change is reflected after WinGP restarts INT32 SetLanguage Function INT32 1_RuntimeHandle Name INT32 1_LanguageKind INT32 1_LanguageNumber 1_RuntimeHandle i The WinGP handle for operation _LanguageKind i Language setting type 0 SYSTEMLANGUAGE System language Argument settings 1 USERLANGUAGE User language settings _LanguageNumber _ i Language setting number Status Ret rh 0 Completed 1 Parameter error value 2 Timeout 1 State WinGP does not accept ending etc e Changing the touch buzzer settings Changes the touch buzzer settings in WinGP INT32 SetTouchBuzze
114. nd registers them as multiple symbols Consider using Pro Server EX instead of WinGP SDK 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal code Ath line Error code without decimal code GP Pro EX Reference Manual 37 133 API Function List SAAF Error Info Error Code Error Message Cause and Troubleshooting 0xC0B00201 Cannot initialize TCP IP From Control Panel Network SAAF001 Connection please confirm that 1062206975 connection setting is enabled and 3232760321 that the TCP IP protocol has been installed which can be confirmed in the property of the connection setting WinGP SDK does not work without the TCP IP 0xC0B00203 This PC does not have a valid IP Please confirm that the LAN card SAAF003 address allocated Please check works properly 1062206973 the TCP IP environment of this Please check the LAN cable too 3232760323 pc 0xC0B00204 Cannot load the PLCInfo xml file Please update the protocol driver If SAAF004 it does not solve the problem 1062206972 please install WinGP SDK again 3232760324 0xC0B00205 Cannot load the Editor Driver SAAF005 1062206971 3232760325 OxCOB00206 An error occurred in Active X I F Please confirm that the OS version SAAF006 is appropriate 1062206970 If the phenomenon still reoccurs 3232760326 despite the restart please install WinGP SDK
115. ng not to SAAF056 GP3000 Series WinGP NODE is execute Read Logging Data when 1062206920 not allowed the target is a WinGP Node 3232760376 OxC0B00239 Reading out trend data from a Please change the setting not to SAAF057 GP3000 Series WinGP NODE is execute Read Trend Data when the 1062206919 not allowed target is a WinGP Node 3232760377 0xC0B00240 The specified access handle for Please check the handle value It SAAF064 Pro Server EX is invalid must be other than 0 correctly 1062206912 created and not discarded 3232760384 0xC0B00241 Cannot continue because this Please reboot your PC If it does SAAF065 command is unsupported not solve the problem please 1062206911 install WinGP SDK again 3232760385 OxCOB00242 Cannot process because Pro Please exit all the applications SAAF066 Server EX stopped before you close WinGP 1062206910 3232760386 O0xC0B00243 While waiting for a processing If you do not want to receive SAAF067 result from the server the API WM_QUIT please use a 1062206909 received the application quitting multihandle system API in 3232760387 message EasySetWaitTypeM 2 OxC0B00244 The file name consists of more Please check the file name SAAF068 than 256 characters Supposed to specification 1062206908 be within 256 characters 3232760388 1st line Error code 2nd line Integrated error code 3rd line Error code with decimal cod
116. no different SAAF026 and write access or cache access access method exists between the 1062206950 and direct access cannot be start of queuing and the actual 3232760346 mixed access If there is the necessity of using a different access method please use another queuing access 0xC0B0021D The specified node has not been Please check the node SAAF029 registered in the network project specification 1062206947 3232760349 OxCOB0021F The API was redundantly called Consider using EasySetWaitTypeQ SAAF031 The specified access handle for to avoid calling the API 1062206945 Pro Server EX is already running simultaneously 3232760351 0xC0B00220 In data type conversion the data Please check the contents of the SAAF032 type of the conversion source Variant type 1062206944 destination is unsupported 3232760352 0xC0B00221 The specified backup data type is Please check the data type SAAF033 unsupported specification 1062206943 3232760353 OxCOB00222 Failed to open the SRAM backup Please check the specifications of SAAF034 data file or to create its copy in the the destination file folder in the PC 1062206942 pc disk space and the access right to 3232760354 the file etc OxC0B00223 In Read Write Backup Data In reading or writing SRAM SAAF035 failed to access the file Backup Data an error occurred 1062206941 accessing the specified file Please 3232760355 check the free space of the PC and the
117. o Save l 4 g File Name Setting Description Save Error Message Specifies whether to save system errors and application errors displayed on the WinGP window Ifno more than 10 minutes have past since the last save the error log file is not saved until 10 minutes pass to avoid frequent write access If so all summaries recorded in the 10 minutes are saved in the error log file e Even the error occurred consecutively all errors are saved in the error log e If the clock time of IPC is changed while the error log function is operating the error log will not be saved in the order of elapse time Save in Select Save in from CF Card or USB storage e When you select CF Card or USB storage the LOG folder is created in the Save in folder and the error log file is created in the folder Number of Stored Items Specifies the number of error messages to save per error log file using 1 to 1000 Number of files to save Specifies the number of error files to save the error log files using 0 to 1024 If Number of Files to Save is set to 0 the files are saved until the CF Card or USB Storage capacity is reached e Until the number of error log files reach the number set in the Number of Stored Items records are added to the latest error log file However if you change the date or time an error log file may be created with the wrong date or time In this case with the new date
118. oject 9424 24D0h_ There are too many actions to register 9425 24D1ih The specified action has already been registered 9426 24D2h The action contents which action s uses cannot be started The designated action is not registered 9427 24D3h An error occurred on the Active X IF 9428 24D4h The designated action has been registered in the registry 9429 24D5h 3 Reserved 9449 24E9h 9450 24EAh The node name or symbol name is not specified 9451 24EBh_ The node name is not specified Continued GP Pro EX Reference Manual 37 145 API Function List Error Code Decimal nera Message decimal 9452 24ECh The data type setting is not valid 9453 24EDh The node name and symbol is not delimited with 9454 24EEh The symbol name has not been registered or it is not a valid device address 9455 24EFh Cannot continue the process no valid device is specified 9456 24F0h Cannot make word access to 32 bit devices 9457 24F1h_ The address is out of the valid range 9458 24F2h_ The No of points setting is invalid 9459 24F3h The No of points setting is 0 or exceeds the setting range 9460 24F4h_ Cannot convert the set symbol into a device address 9461 24F5h_ A value input error occurred Enter a correct value 9462 24F6h_ The specified lifetime is invalid 9463 24F7h The designated bit location
119. on value value EASY_AppKind_Bit 1 0x0001 Bit data EASY_AppKind_SignedWord 2 0x0002 16 Bit Signed Data EASY_AppKind_UnsignedWord 3 0x0003 16 Bit Unsigned Data EAS Y_AppKind_Hex Word 4 0x0004 16 bit Hex data EASY_AppKind_BCDWord 5 0x0005 16 bit BCD data EASY_AppKind_SignedDWord 6 0x0006 32 Bit Signed Data Pn 7 0x0007 Unsigned 32 bit data EASY_AppKind_HexDWord 8 0x0008 32 Bit Hex Data EASY_AppKind_BCDDWord 9 0x0009 32 bit BCD data EASY_AppKind_Float 10 0x000A Single float number data EASY_AppKind_Real 11 0x000B Double float number data EASY_AppKind_Str 12 0x000C Text data e Data type available in special cases Definition name Pema ieee oer Description value value 0 0x0000 Default Write the existing contents Shows that API is using EASY_AppKind_NULL the data type defined by the symbol for API that can use symbols as the device address 513 0x0201 BOOL Write the existing contents EASY_AppKind_BOOL Handles the Bit data in 1 bit unit and as VARIANT type BOOL GP Pro EX Reference Manual 37 116 API Function List Specify the Device PLC When specifying a device in GP Pro EX selecting a symbol name also means the connected device PLC is also selected In the device access API you need to also define the connected device PLC name For example ReadDevice 16 WinGP PLC 1 valve Data 10 Device Length Operation when accessing a 16 bit device using 32 bit WinGP allocates 32 bit symbols to 16 bit devices When you use a
120. oup symbol itself has bit offset symbols and no data is secured for the bit offset symbols in the data buffer when accessing the device with the structure variable in the logic instruction The bit offset symbols never exist by themselves and always have parent word symbols A data area is secured for the parent Use part of the respective secured area for the bit offset symbols GP Pro EX Reference Manual 37 153 Settings Guide N 37 8 Settings Guide 37 8 1 System Settings Display Unit Settings IPC Settings Settings Guide Window Screens ha M M M omane M Setting Description Specifies whether to display the menu by right click on the window in WinGP Display right click menu Continued GP Pro EX Reference Manual 37 154 Settings Guide Setting Description WinGP Select the size of Window Screen at the startup from Window Full Screen When the Window is selected the Trigger mode window opens in a specified screen size When the Full Screen is selected no matter what the screen size is the window is displayed in full screen Display Position Specifies whether to specify the window display position when WinGP starts Use X and Y coordinates to set the display position e X 0 maximum resolution of the selected model horizontal 1 ayi 0 maximum resolution of the selected model horizontal 1 Window Frame
121. owser application s designated folder Browser cannot be displayed 9870 268Eh Error downloading Binary file 9871 268Fh_ Binary file Read failed 9872 2690h Binary file Open error 9873 2691h Binary file Analysis failed 9874 2692h Error writing to Excel file 9875 2693h Error writing to CSV file 9876 2694h Error creating Binary file 9877 2695h Designated file does not exist 9878 2696h Conversion from Excel file to Binary file failed 9879 2697h Conversion from CSV file to Binary file failed 9880 2698h Provided data is outside range 9881 2699h Failed in GP log data upload 9882 269Ah There is no data to support 9883 269Bh This data requires more than one sheet 9884 269Ch_ Microsoft Excel is not installed on this machine 9885 269Dh_ Wrong parameter is designated 9886 269Eh Failed to write data 9887 269Fh Failed to read CSV file 9888 26A0h An error occurred in deleting an unnecessary file 9889 26A1h Action Failed 9891 26A3h__ No corresponding data in ACCESS file 9892 26A4h Command error 9893 26A5h_ Failed in automatic upload of ACCESS data 9894 26A6h Cannot open the specified table GP Pro EX Reference Manual 37 152 API Function List 37 7 3 Bit Data Access WinGP SDK provides three ways to handle bit data when accessing the bit device 1 16 bit unit Handles the data as a bit array in a 16 bit unit on the bit device The specified number of bit data are stored used right aligned from
122. ox Err Str RetVal Trim Q GetScreenState End If Display the state Select Case Status Case 0 1 2 Me ScreenState SelectedIndex Status End Select Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub Private Sub SetScreenState_Click ByVal sender As System Object ByVal e As System EventArgs GP Pro EX Reference Manual 37 58 Retrieve WinGP information or Operate WinGP from user application Handles BT_SetScreenState Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Try Gets the value Dim State As Int32 Me ScreenState SelectedIndex Dim PosX As Int32 Val Me PosX Text Dim PosY As Int32 Val Me PosY Text Dim Width As Int32 Val Me TX_Width Text Dim Height As Int32 Val Me TX_Height Text Screen state settings Dim RetVal As Int32 SetScreenState ghWinGP State PosX Pos Y Width Height Any error If RetVal lt gt API_LERROR E_SUCCESS Then MsgBox Err Str Ret Val Trim SetScreenState End If Catch ex As Exception MsgBox ex Message End Try Me Cursor Cursors Default Changes the cursor back to the original End Sub Private Sub GetDispScreen_Click ByVal sender As System Object ByVal e As System EventArgs Handles GetDispScreen Click Me Cursor Cursors WaitCursor Changes the cursor to an hourglass Dim CurScrNo As Int32 Screen number currently displayed
123. pecial Remarks Problem Error wDeleteFileNo File Numbers of Delete Files in CF Card c o e Special Item When this function is called to the files that do not exist the operation ends normally without resulting an error The supported file types are as follows You can only read items stored in the defined CF card folder Supported File Types Data Class File Type Folder Filing Data ZF FILE CSV Data ZR FILE Image Screen Zl DATA Sound Data ZO DATA Trend Data ZT TREND Sampling ZS TREND Alarm4 8 Z4 Z8 ARAM Data Logging ZL LOG Alarm Log ZG ALARM Alarm History ZH ALARM Active Alarm ZA ALARM Backup Screen Data ZC MRM Screen Capture CP CAPTURE GP Pro EX Reference Manual 37 111 API Function List Function Name Get Free Space in CF Card To acquire free space in CF Card connected to an assigned station INT WINAPI EasyGetCfFreeS pace LPCSTR sNodeName INT oiUnallocated Argument Return value sNodeName The station name is fixed as WinGP Normal 0 oiUnallocated Free Space in CF Card Acquired in a byte unit Problem Error code Special Item Function Name FTP Passive Mode Settings communicates via FTP protocol to access CF Card FTP protocol in WinGP SDK supports Normal Mode and Passive Mode This API sets each mode INT WINAPI EasyFileSetPassiveMode INT iPassive Argument Return value iPassive In 0 No
124. process As a result it can prevent from double calling of functions by clicking the icon during function process However in this case please be careful that all windows message processes are controlled not only the message the icon is clicked important messages such as timer and redrawing window screen will not be processed You can specify whether to process or control the process for each handle of WinGP SDK The default is set to process Single INT EasySetWaitType DWORD dwMode Argument Return value dwMode In Process messages if 1 is specified Control message process if 2 is Normal End 0 specified Problem Error Code Function Name Acquiring the method of message process This function retrieves what mode is being processed for the message method when WinGP SDK API is calling Single INT EasyGetWaitType Q Argument Return value 1 Process messages 2 Control message processing GP Pro EX Reference Manual 37 97 API Function List Function Name Text Conversion of Error Code Error codes returned by each API in WinGP SDK are converted to error messages EasyLoadErrorMessage returns multi byte text ASCII as a message EasyLoadErrorMessageW returns a UNICODE text string BOOL WINAPI EasyLoadErrorMessage INT iErrorCode LPSTR osErrorMessage BOOL WINAPI EasyLoadErrorMessageW INT iErrorCode LPWSTR owsErrorMessage Argument Return value iErrorCode In error code re
125. r 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 87 API Function List 37 7 2 Device Access API Summary API is to read write to a device PLC communication with WinGP or a device in WinGP from the user created program application DDL file for API communication The API is provided in a DLL file The DLL file name is ProEasy dll and is installed in the WINDOWS folder Supported languages The following five program languages can be used for the device access API e Visual C e Visual Basic 6 0 e VB NET e Excel VBA e CH e Unavailable API for VB NET or C You cannot use the following API for NET Even if API is used its operation is not guaranteed Direct read API symbol access of single handle system general purpose data ReadDevice eWriteDevice ReadSymbol WriteSymbol SizeOfSymbol Devices WinGP SDK can access The WinGP SDK has access to PLC device and USR LS Area and symbols and logic instructions variables registered in GP Pro Ex e To use structure variables of logic instructions you need to use the parameters below For details on using ReadSymbolD ReadSymbol VariantD WriteSymbolD WriteS ymbol VariantD for structure variables of I F logic instructions see below 37 7 3 Bit Data Access page 37 153 e You cannot use real variables of logic instructions or R_device GP Pro EX Reference Manual 37 88 API Function List
126. r F Sane INT32 1_RuntimeHandle ane INT32 1_BuzzerState 1_RuntimeHandle 1 The WinGP handle for operation Arg ment 1_BuzzerState i Buzzer settings g 0 BUZZERON No Buzzer 1 BUZZEROFF Buzzer Status Return 0 Completed alae 1 Parameter error H 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 84 API Function List e Gets the listed number of screen numbers Gets the number of screen numbers that can be set in WinGP INT32 GetEnumScreenNumberCount F eee INT32 1_RuntimeHandle INT32 _ ScreenNumberCount Ardument l_RuntimeHandle i The WinGP handle for operation g 1_ScreenNumberCount 0 The number of display screens Status Boivin 0 Completed 1 Parameter error vaine 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 85 API Function List e Listing the display screen numbers Gets the screen numbers that can be set in WinGP and returns them to arrays Set the number of screen to be retrieved displayed smaller than the display screens retrieved by the Get function for the listed number of display screen numbers INT32 EnumScreenNumber Function INT32 1_RuntimeHandle Name INT32 1_ScreenNumberCount INT32 pl_ScreenNumbers 1_RuntimeHandle i The WinGP handle for operation Argument 1_ScreenNumberCount i The number of display screens 1_ScreenNumbers 0 Display
127. rcentage symbol 2 1 Suppress leading zeroes by placing a hash mark in front of d H I j m M S U w W y or Y For example if the value is 05 and the formatting code is d displays 5 2 The hash mark is ignored when placed in front of a A b B p X z or Z For example if the day is Monday and the formatting code is A displays Monday GP Pro EX Reference Manual 37 101 API Function List Function Name Read IPC Time as STRING VARIANT Function to acquire the current time as a string Variant format from the defined station This function is valid only with the time stored in LS2048 6 words DWORD WINAPI EasyGetGPTimeString Variant LPCSTR sNodeName LPCSTR sFormat format LPVARIANT ovTime Argument Return value sNodeName The station name is fixed as WinGP Normal End 0 pFormat String formatting for the time string Formatting codes following the per problem Error cent sign are replaced as shown in the following table Other charac Code ters are not converted and display as is For details refer to the Special Items section in Function for Reading String Type on the IPC ovTime Retrieves time string as VARIANT format which internally is the BSTR Function Name Read Reference Station Status Single You can get the status of the connected equipment IPC Or you can vary the response timeout value to confirm the connection INT WINAPI Get
128. rk If the message pump does not perform properly Windows applications perform unintended operations For example if a routine takes a long time to process a message and does not return the application cannot receive an event from Windows during the processing time and cannot process the event GP Pro EX Reference Manual 37 117 API Function List For example When Windows sends messages in the order of Message 1 and Message 2 The message pump retrieves Message 1 and calls a subroutine for Message 1 Once returning it retrieves the next message Message 2 and calls a subroutine for Message 2 Message 1 Message 1 processing Message Pump Message Message 2 processing If it takes a long time to process Message 1 at this point the message pump does not return and the message pump processing 2 cannot be performed Message 1 processing Message 1 x The processing stops here Message Pump Message Message 2 processing In such case force the operation of the message pump Referred to DoEvents in VB and GetMessage and DispatchMessage in VC Message 1 processing When the processing seems to be taking too much time call the message pump Continues the processing and returns when the processing ends Message 1 Message Pump Message 2 processing Message 2 Message Pump Windows appli
129. rmal Mode Normal 0 Other than 0 Passive Mode Problem Error 4 sokari code Normal Mode is set at the time of WinGP SDK initialization Special Item GP Pro EX Reference Manual 37 112 API Function List Queuing Access Control API Function Name Execute Queuing Device Read Request Queuing device read request until ExecuteQueuingAccess is called after this API is called Queuing is performed in a unit of WinGP SDK handle Single INT WINAPI BeginQueuingRead Argument Return value Normal 0 Problem Error code Special Item e Do not call API to execute device write operations after calling BeginQueuingRead until the ExecuteQueuingAccess After these calling cache read and direct read com mands will be queued However cache read and direct read commands cannot be mixed e To cancel a queuing command call CancelQueuingAccess e The maximum number of queuing commands is 1500 the maximum byte number is under 1 MB Function Name Start Queuing Device Write Request Queuing device read request until ExecuteQueuingAccess is called Queuing is performed in a unit of WinGP SDK handle Single INT WINAPI BeginQueuingWriteQ Argument Return value Normal 0 Problem Error code Special Item e Do not call API to execute device write operations after calling BeginQueuingWrite until the ExecuteQueuingAccess After these calling cache write and direct write
130. ror summary displayed during WinGP communication in a file Right click menu You can switch screens and modes between offline and online maximize the window to full screen and minimize and exit the window from this menu GP Pro EX Reference Manual 37 5 Operating Environment 37 2 Operating Environment 37 2 1 Supporting Models The following four display models support the WinGP E IPC Series e PS3651A T41 e PS3650A T41 e PS3700A T41 ASU P41 Rev H or later e PS2000B 41 Pentium III 1GHz Rev M or later e To check the specifications for each supporting model see the IPC series user s manual e The WinGP will not start other than the models listed above Supporting OS The following OS types support the WinGP e Windows2000 later than Service Pack 3 e WindowsXP e WindowsXP Embedded e When WinGP operates in a non Japanese OS environment the WinGP window menu bar right click menu copy tool and popup messages are all displayed in English In the offline mode they are displayed in the system language selected in Menu and Error Settings System Language under Main Unit GP Pro EX Reference Manual 37 6 Operating Environment 37 2 2 E Available Protocols Supported Protocols IMPORTANT e Even though a driver supports the WinGP the WinGP may not operate due to connection methods Please refer to GP Pro EX Device PLC Connection Manual for the connections e P
131. rt Status click the Get button The WinGP startup state is displayed as one of Status 1 Status ae the six shown below e Starting Start Status co E Offline e Online e Transfer mode e Ending e Not executing In Screen click the Get button to display the screen number currently displayed in WinGP Also the screens available for display in WinGP are listed in the ComboBox In the list select the screen you are switching to and click the Set button to switch the screen displayed in WinGP Status 2 tab In Screen State click the Get button The WinGP display state is displayed as one of the 3 shown below e Maximized Full screen e Window screen e Minimized Change the display in the ComboBox and click the Set button to change the display state Settings for X Y Width and Height are available only in the Window mode Status 1 Status 2 Information End Screen Status B Set x Width Get Y Height GP Pro EX Reference Manual 37 55 Retrieve WinGP information or Operate WinGP from user application Information End tab In Start Status on the top left click the Get button This displays the below information displayed in WinGP Status 1 Status 2 In iepoke ctlpformetien ProjectName Project file name Get ae Comment Project title Hee oe Make date Projec
132. rue Succeed false Fail e Exit API Executes post processing when you finish using WinGP Operation State Get API Function f bool CleanupRuntimeAPI void Name Argument None Return value true Succeed false Fail e Gets the startup state Gets the start up state of WinGP INT32 GetRuntimeStartState Si INT32 l_RuntimeHandle INT32 pl_RuntimeCondition 1_RuntimeHandle The WinGP handle from which it gets the state pl_RuntimeCondition 0 WinGP state 0 STARTING Starting 1 START_ONLINE Online Argument 2 START_OFFLINE Offline 3 START_TRANSFER Transfer mode 4 ENDING Ending 5 NOTEXECUTE Not executed Status 0 Completed Return value 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 78 API Function List e Gets the screen number currently displayed Gets the screen number currently displayed in WinGP from WinGP INT32 GetDisplayScreenNumber aes INT32 1_RuntimeHandle INT32 pl_DisplayScreenNumber 1_RuntimeHandle i The WinGP handle from which it gets the number Argument pl_DispScreenNumber 0 Screen number If offline Screen None 0 is returned Return value Status 0 Completed 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 79 API Function List e Gets the screen
133. s End Select Screen MousePointer vbDefault End Sub Private Sub BT_SetScreenState_Click Screen MousePointer vbHourglass Changes the cursor to an hourglass Gets the value Dim State As Long Dim PosX As Long Dim PosY As Long Dim Width As Long GP Pro EX Reference Manual 37 66 Retrieve WinGP information or Operate WinGP from user application Dim Height As Long State Me ScreenState ListIndex PosX Val Me PosX Text PosY Val Me PosY Text Width Val Me TX_Width Text Height Val Me TX_Height Text Screen state settings Dim RetVal As Long RetVal SetScreenState ghWinGP State PosX Pos Y Width Height Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal SetScreenState End If Screen MousePointer vbDefault End Sub Private Sub GetDispScreen_Click Screen MousePointer vbHourglass Changes the cursor to an hourglass Dim CurScrNo As Long Screen number currently displayed Gets the state Dim RetVal As Long RetVal GetDisplayScreenNumber ghWinGP CurScrNo Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str RetVal GetDisplayScreenNumber End If Gets the number of screens Dim ScreenCount As Long RetVal GetEnumScreenNumberCount ghWinGP ScreenCount Any error If RetVal lt gt API_ERROR E_SUCCESS Then MsgBox Err Str Ret Val GetEnumScreenNumberCount End If
134. s WinGP Normal End 0 odwTime Retrieves time in DWORD format which actually uses ANSII time_t Problem Error format Code Special Item Function Name Read IPC Time as VARIANT Function to acquire the current time as a numeric value Variant format from the defined station This function is valid only with the time stored in LS2048 6 words DWORD WINAPI EasyGetGPTime Variant LPCSTR sNodeName LPVARIANT ovTime Argument Return value sNodeName The station name is fixed as WinGP Normal End 0 ovTime Retrieves time as VARIANT format which internally is the Date format Problem Error Code Special Item Function Name Read IPC Time as STRING Function to acquire the current time as a string LPTSTR format from the defined station This function is valid only with the time stored in LS2048 6 words DWORD WINAPI EasyGetGPTimeString LPCSTR sNodeName LPCSTR sFormat LPSTR osTime Argument Return value sNodeName The station name is fixed as WinGP Normal End 0 pFormat Retrieves string as a time formatted string Formatting codes following Problem Error the percent sign are replaced with Special Item Other characters Code are not converted and display as is osTime Retrieves time as a string Make sure you reserve enough memory space to receive string length 1 for the NULL character If you don t reserve enough space you could experience unexpected data loss and operations may not work prop
135. s displayed Be sure WinGP is online GP Pro EX Reference Manual 37 18 Development Process 2 On the GP Pro EX state tool bar click Transfer Project to launch the transfer tool me GP Pro EX Project F Edit View 4 Common Settings R Draw D aj a cel Transfer Project aj De SB uS e als d a 3 In Project Information acknowledge the project file name etc that you are transferring To transfer a different project file click the Select Project button and select the project file 4 In Transfer Settings Information acknowledge that USB or LAN is selected If neither USB nor LAN is selected the Transfer Settings dialog box will appear In the Port settings select USB or LAN and click OK Communication Port Settings Transfer Project 5 Auto I Retain retentive variables DN C All C Modem C COM m Transfer System Auto C Forced N Transfer CF Files ome NOTE Modem transfer is not available 5 Click Send Project The following process is the same as the GP See below 33 2 Transferring Project Files via USB Cable Transfer page 33 5 SF 33 3 Transferring Project Files via Ethernet LAN page 33 12 e When transferring over Ethernet LAN make sure you set up the IPC s IP address On the desktop right click My Network and select Properties In the Network Connections dialog box right click Local Area Connect
136. screen Returns the number in arrays Status 0 Completed Return value 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc e Gets the listed number of languages Gets the number of languages that can be set in WinGP INT32 GetEnumLanguageCount Function INT32 1_RuntimeHandle Name INT32 1_LanguageKind INT32 pl_LanguageCount 1_RuntimeHandle i The WinGP handle for operation _LanguageKind i Language setting type 0 SYSTEMLANGUAGE System language Argument settings 1 USERLANGUAGE User language settings pl_LanguageCount o The number of languages that can be specified Status 0 Completed Return value 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 86 API Function List e List the language numbers Gets the language numbers that can be set in WinGP Function Name INT32 EnumLanguage INT32 1_RuntimeHandle INT32 _LanguageKind INT32 _LanguageCount INT32 pl_Languages 1_RuntimeHandle LanguageKind Argument settings _LanguageCount pl_LanguageCount i The WinGP handle for operation i Language setting type 0 SYSTEMLANGUAGE System language 1 USERLANGUAGE User language settings i The number of languages that can be specified 0 Languages that can be set Status 2 Timeout 0 Completed Return value 1 Parameter erro
137. sgResult As Long iMsgResult EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg GP Pro EX Reference Manual 37 51 Retrieve WinGP information or Operate WinGP from user application End If End Sub Private Sub ReadBit_Click Read data Dim nDataAry 1 As Integer Read Dim iResult As Long iResult ReadDeviceBit WinGP Buf_Bit nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessage iResult sErrMsg MsgBox sErrMsg End If Me Buf_Bit Text CStr nDataAry 0 End Sub Private Sub Read16_Click Read data Dim nDataAry 1 As Integer Read Dim iResult As Long iResult ReadDevice16 WinGP Buf_16 nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessage iResult sErrMsg MsgBox sErrMsg End If Me Buf_16 Text CStr nDataAry 0 End Sub GP Pro EX Reference Manual 37 52 Retrieve WinGP information or Operate WinGP from user application Private Sub Read32_Click Read data Dim nDataAry 1 As Long Read Dim iResult As Long iResult ReadDevice32 WinGP Buf_32 nDataAry 0 1 If iResult Then Dim sErrMsg As String 512 Dim iMsgResult As Long iMsgResult EasyLoadErrorMessage iResult sErrMsg MsgBox sErrMsg End If Me Buf_32 Text CStr nDataAry 0 End Sub Private Sub ReadFloat_Click Read data Dim nDataAry 1 As Single Rea
138. specify device Read data addresses directly page 37 38 Dim nDataAry 1 As Short Read Dim iResult As Integer ProEasy ReadDevice16 WinGP Buf_16 nDataAry Try 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If GP Pro EX Reference Manual 37 39 Retrieve WinGP information or Operate WinGP from user application Me Buf_16 Text CStr nDataAry 0 Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub Read32_Click ByVal sender As System Object ByVal e As System EventArgs Handles Read32 Click Try Read data Dim nDataAry 1 As Integer Read Dim iResult As Integer ProEasy ReadDevice32 WinGP Buf _32 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Me Buf_32 Text CInt nDataAry 0 Catch ex As Exception MsgBox ex Message End Try End Sub Private Sub ReadBCD16_Click ByVal sender As System Object ByVal e As System EventArgs Handles ReadBCD16 Click Try Read data Dim nDataAry 1 As Short GP Pro EX Reference Manual 37 40 Retrieve WinGP information or Operate WinGP from user application Read Dim iResult As Integer ProEasy ReadDeviceBCD16 WinGP Buf_BCD16 nDataAry 1 If iResult Then Dim sErrMsg As String ProEasy EasyLoadErrorMessageEx iResult sErrMsg MsgBox sErrMsg End If Me Buf_BCD16
139. state Gets the WinGP display state INT32 GetScreenState ital INT32 1_RuntimeHandle INT32 pl_ScreenState 1_RuntimeHandle i The WinGP handle from which it gets the state pl_ScreenState 0 Screen state 0 FULLSCREEN Full screen Argument 1 WINDOWSCREEN Window screen 2 MINIMUMSCREEN Minimized 1 UNCERTAINTY Unknown Return value Status 0 Completed 1 Parameter error 2 Timeout 1 State WinGP does not accept ending etc e Gets the language settings Returns the language setting number INT32 GetLanguage Function INT32 1_RuntimeHandle Name INT32 1_LanguageKind INT32 pl_LanguageNumber 1_RuntimeHandle i The WinGP handle it gets the information from LanguageKind i Language setting type 0 SYSTEMLANGUAGE System language settings 1 USERLANGUAGE User language settings Argument pl_LanguageNumber o Language setting number 0 SYSTEMLANGUAGE System language settings 0 Japanese 1 English 1 USERLANGUAGE User language settings Status Roturii 0 Completed l Parameter error value 2 Timeout 1 State WinGP does not accept ending etc GP Pro EX Reference Manual 37 80 API Function List e Gets the touch buzzer settings Returns the information on the buzzer sound selected in WinGP INT32 GetTouchBuzzer F eee INT32 1_RuntimeHandle ans INT32 pl_BuzzerState 1_RuntimeHandle i The WinGP handle it g
140. t continue Pro Server has been terminated 9347 2483h Cannot continue Pro Server has been terminated 9348 2484h Could not start Pro Server 9349 2485h Could not start Pro Studio 9350 2486h Unsupported command Cannot continue 9351 2487h Failed in loading the network project file 9352 2488h The entered node name has already been registered 9353 2489h The entered node name has not been registered 9354 248Ah Backup data type specified is not supported 9355 248Bh Failed to writing to the file 9356 248Ch_ Could not create a file to store the SRAM backup data 9357 248Dh The node name entered has not been registered 9358 248Eh Pro Server is already operating Cannot start two copies 9359 248Fh Reserved 9360 2490h s has not been entered 9361 2491h 0 cannot be entered in s 9362 2492h s should be xxx xxx xxx xxx format where xxx is a value between 0 and 255 Continued GP Pro EX Reference Manual 37 143 API Function List Error Code Decimal neva Message decimal 9363 2493h An invalid value has been entered in s 9364 2494h A character unavailable for s is involved 9365 2495h s has not been entered yet 9366 2496h Cannot start a new process until the process result is returned from the server 9367 2497h Cannot terminate the application while waiting for the process result 9368 249
141. t creation date kote Last Update Project last update date HMI Edtor Fo HMI Editor GP Pro EX version Person Person Creator Une ee Click the WinGP Ends With Query button and a confirmation message asking Do you want to exit is displayed Click Yes to exit WinGP m VB NET 2003 Program Example Sample Program Location In GP Pro EX CD ROM WinGP SDK Pro SDK DotNet RtCtrlS mpl Imports System Runtime InteropServices eon System Runtime InteropServices D Public Class Form1 Inherits System Windows Forms Form Dim ghWinGP As Int32 0 API handle Region code generated with Windows form designer Public Sub New MyBase New This call is necessary for Windows form designer InitializeComponent InitializeComponent Adds meatier eee after the call Initialize API API Dim nResult As Integer InitRuntimeAPI Gets the handle at this stage API ghWinGP GetRuntimeHandle 9800 If ghWinGP 0 Then MsgBox API Failed to get handle End If End Sub GP Pro EX Reference Manual 37 56 Retrieve WinGP information or Operate WinGP from user application Form overwrites the dispose to execute post processing on the component list Protected Overloads Overrides Sub Dispose By Val disposing As Boolean If disposing Then If Not components Is Nothing Then components Dispose End If End If CleanupRuntimeAPI MyBase Dispose disposing End Sub Snip
142. ta oiCount Number of files read sSaveFileName Filename where directory information is stored In the defined file data Function Name Read CF card file optional file name Function to read the file contents of the file that will be saved to the CF card You can optionally define the file to read INT WINAPI EasyFileReadInCfCard LPCSTR sNodeName LPCSTR sFolderName LPCSTR sFileName LPCSTR pWriteFileName DWORD odwFileSize Argument sNodeName sFolderName sFileName pWriteFileName odwFileSize The station name is fixed as WinGP Folder name of file on the CF card file to read Maximum 32 single byte characters File name in the 8 3 string format to read from the CF card File name and path for saving the CF card file Fize size of the file read from the CF card Return value Normal 0 Problem Error code GP Pro EX Reference Manual 37 107 API Function List Function Name Read CF Card file define file type Function to read the file contents of the file to save to CF card File you can read are limited to the file type defined in pReadFileType INT WINAPI EasyFileReadCard LPCSTR sNodeName LPCSTR pReadFileType WORD wReadFileNo LPCSTR sWriteFileName DWORD odwFileSize Argument Return value sNodeName The station name is fixed as WinGP Normal 0 pReadFileType File type of the file to read from the CF
143. talled and becomes the save location Retentive Conditions Selects a condition to execute backup from Loop Update Time Bit ON or Bit Change Loop update time Backs up the data as specified in Loop Update Time Bit ON Backs up the data only when the bit specified in Control Bit Address turns ON The data is saved only after 1 minute has elapsed since the last save Bit Change Backs up the data only when the bit specified in Control Bit Address turns ON The data is saved only after 1 minute has elapsed since the last save Loop update time Specifies the loop update time to repeat backup when Loop Update Time is selected in Backup Trigger using 1 to 60 minutes Control Bit Address Specifies the address to control backup when Bit ON or Bit Change is selected in Backup Trigger Indicate Write Status Specifies whether to use the bit address to show the backup data write status Status Address The backup data write status is shown by ON and OFF of the bit address specified here ON Writing data e OFF Writing no data Bit state Name Bit ON condition Bit OFF condition 0 Writing When file write starts File write ends 1 Write error When write fails When write starts GP Pro EX Reference Manual 37 156 Settings Guide E Error Settings Error Settings l Save Error Message Save in r Number of Stored Items g Number of Files t
144. tes or more oSymbolInformation Out Returns detailed information as an array Please prepare the quantity defined in iMaxCountOfSymbolMember for the work space oiGotCountOfSymbolMember Out Returns the information number actually returned to oSymbolInformation GP Pro EX Reference Manual 37 103 API Function List Special Item e SymbolInformation Structure struct SymbolInformation WORD m_wAppKind Data type When symbol 1 12 when group 0x8000 WORD m_wDataCount Data size DWORD m_dwSizeOf Buffer byte size char m_sSymbolName 64 1 Symbol or group name char m_bDummy1 3 Reserved char m_sDeviceAddress 256 1 Device address empty for group char m_bDummy2 3 Reserved 5 Information found in oSymbolInformation is returned as a SymbolInformation array and in the first setting group or sheet information or symbol is set In the second setting and onward when sSymbolName is a group sets the group members When sSymbolName is sheet the entire sheet information is set When sSymbolName is symbol there are no settings after the first When the object symbol is bit offset symbol be careful about the following points 1 When bit offset symbol is used to directly specify the original symbol information when sSymbolName is directly specified as bit offset symbol in oSymbolInformation s first SymbolInformation field m_dwSizeOf a byte count of 2 is set for accessing the bit symbol
145. the DO bit The data buffer requires sufficient space for 16 bit even if the specified number is 1 Also the number needs to be specified in 16 bit units For example Data buffer storing order when a 20 bit device is specified D15 D14 D13 D12 D11 D10 D9 D8 amp D7 D6 D5 D4 D3 D2 D1 DO 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 20 19 18 17 lt Applicable API gt ReadDeviceBit WriteDeviceBit When specifying 1 EASY_AppKind_Bit for the data type in ReadDevice WriteDevice ReadDevice Variant WriteDevice Variant When specifying a bit symbol and a group that includes any bit symbol in ReadSymbol WriteSymbol 2 Variant BOOL unit Handles 1 bit as the Variant BOOL data The data buffer is a BOOL type where 1 bit is 1 Variant It handles the specified number of data as a BOOL type array lt Applicable API gt When specifying 0x201 EASY_AppKind_BOOL for the data type in ReadDevice Variant WriteDevice Variant When specifying the bit symbol and the group that includes any bit symbols in ReadSymbol Variant WriteS ymbol Variant 3 Bit offset symbols when accessing the device with a structure variable in the logic instruction When you directly specify the bit offset symbol to access the device the data buffer handles the data either in 16 bit unit or Variant BOOL unit as described above Note that the gr
146. to 99999999 00000000 to OSFSEOFF When using the text data function For variables to receive text data secure sufficient data space to receive the data GP Pro EX Reference Manual 37 93 API Function List Data Access API in SRAM Function Name Read SRAM backup data Read the following data in SRAM and save it as a file in PC The file format of recipe data is saved in a binary format other formats are saved in a CSV format INT WINAPI EasyBackupDataRead LPCSTR sSaveFileName _LPCSTR sNodeName INT iBackupDataType INT iSaveMode Argument sSaveFileName In The file path of a destination file of read data Text pointer sNodeName In The participated station name of the source data to be read Text pointer A station name is fixed to WinGP iSaveMode In How to save 0 New If a file with the same file name exists the file is deleted and overwritten 1 Add Add data to the end of a file If there is no file a new file is cre ated Other than those above Reserved iBackupDataType In Types of read data Value Types of data 0x0001 Filing Data 0x0002 Sampling data of sampling group no 1 0x0003 0x0004 0x0005 Alarm Block1 0x0006 Alarm Block2 0x0007 Alarm Block3 0x0008 Alarm Block4 0x0009 Alarm Block5 0x000A Alarm Block6 0x000B Alarm Block7 0x000C Alarm Block8 Other than those above All sampling group data except for sampling group no 1
147. turned by WinGP SDK function Normal Any osErrorMessage Out pointer to the area where the converted string ASCII is stored value other than prepare for 512 bytes or more owsErrorMessage Out pointer to the area where the converted string ASCII is stored prepare for 1024 bytes or more Zero Failed to convert string for example unused error code 0 Special Item e This API is provided to enable compatibility with Pro Server with Studio e EasyLoadErrorMessageEx converts errors into an error message with more details Function Name Error code string conversion status information attached Converts error codes returned by various APIs in the WinGP SDK into error messages Returns an error message with status information attached if possible EasyLoadErrorMessage always returns the same error message as the defined error code EasyLoadErrorMessageEx returns more detailed information such as the name of the communication partner where the error occurred and status when the error occurred Even the same error code could return different error messages depending on the location of the error EasyLoadErrorMessageEx EasyLoadErrorMessageExM return a multi byte string message ASCID EasyLoadErrorMessageEx EasyLoadErrorMessageExM return a string message UNICODE Single BOOL WINAPI EasyLoadErrorMessageEx INT iErrorCode LPSTR osErrorMessage BOOL WINAPI EasyLoadErrorMessageEx W INT iErrorCode LPWS
148. ui Word Screen Special Selector Bk Switch Switch Chanae Switch Switch Special Action Select Shape I No Shape I Display Confirmation Dialog Help H Cancel GP Pro EX Reference Manual 37 28 Development Process e If you select the Confirm check box the following message appears when you touch the switch on the WinGP WinGP Q Exit application test prx Yes No GP Pro EX Reference Manual 37 29 Development Process Use D Script to exit e Please refer to the settings guide for details SF 20 8 1 D Script Common Global D Script Settings Guide page 20 53 e On the Common Settings R menu you can also select Global D Script L or Extended Script E to exit WinGP 1 On the Parts P menu select D Script R and click Create in the D Script list dialog box D Script List 2 Click the Function tab Simply click the instruction available to the script to easily place the Built In Function Instruction Function Uthers Debug Start Application Exit WinGP lamiie GP Pro EX Reference Manual 37 30 Development Process 4 Double click Exit WinGP and configure the parameter settings in the dialog box below Exit WinGP Param ter 0 0 Do not The confirmation dialog box does not appear and the confirm WinGP exit immediately The following dialog box appears in the WinGP Click Y
149. umber Displays the screen number Title Displays the screen title Open Opens the screen selected in Screen or the screen number list Close Displays the Display Screen Selection dialog box To offline To online Switches to offline mode If displaying in offline mode switches to the online screen Full Screen Mode Displays the full screen e If the screen is displayed in Full Screen the Window Screens is displayed and changes the window to the original size e Also you can touch the upper right and lower left of the IPC screen and display System Menu Reset to reset the screen size of Full Screen Mode Minimized Hides the window and displays the icon on the task bar Close Exits WinGP GP Pro EX Reference Manual 37 162 Settings Guide 37 8 3 ProjectCopy Copy Tool Settings Guide From Start menu select Programs Pro face WinGP ProjectCopy The following dialog box appears You can copy only the screen data of a project file can be copied BB ProjectCopy Ale Ea Project File Setting Description Project File Enters or displays the project file path to be copied Specifies the project file location to be copied Open E xi History Desktop Reference om eS My Documents orm My Computer 3 rf amp Files of type Project ata prs 7 Cancel My Network P J Open as read only Copy Starts copying a project file
150. unction List m Error Code List e The terms Pro Server and Pro Studio in the Error Messages are required to be replaced as WinGP SDK REAA Error Info Error Code Error Message Cause and Troubleshooting OxC0A10010 Could not use the XX port No Could not use the XX port No REAA016 XX XX There is a possibility that the 1063190512 XX Port name No system port number is already 3231776784 being used 0xC0A10011 Attempted to access a write Cannot write to Write Inhibit Area REAA017 protect area XX LS0000 LS0019 LS2032 1063190511 XX Device name LS2095 LS9000 LS9999 via D 3231776785 Script or Network 0xC0A10012 Attempted to access a device Attempted to access an out of REAA018 outside the address range XX range device 1063190510 XX Device name 3231776786 OxC0A10015 An invalid ID Node Device An invalid ID was specified REAA021 Address has been specified Attempted to access a nonexistent 1063190507 device 3231776789 An invalid ID was specified 0xC0A10016 An invalid ID Node Device Attempted to access a nonexistent REAA022 Address has been specified device 1063190506 3231776790 OxCOA1001A Illegal Undefined Device Address An invalid device was specified REAA026 Attempted to access a nonexistent 1063190502 device 3231776794 0xC0A1001B Illegal Undefined Device Address REAA027 1063190501 3231776
151. w If a file with the same file name exists the file is deleted and overwritten 1 Add Add data to the end of a file If there is no file a new file is cre ated Other than those above Reserved iBackupDataType In Types of read data Value Types of Data 0x0001 Filing Data 0x0002 Sampling data of sampling group no 1 enone All sampling group data except for sampling group no 1 0x0004 pling group p pling group no Alarm Block1 Ox0008 Specify the type of alarm using iNumber Alarm Block2 0x0006 Specify the type of alarm using iNumber Alarm Block3 0x000 Specify the type of alarm using iNumber Alarm Block4 0x0008 Specify the type of alarm using iNumber Alarm Block5 0x0009 Specify the type of alarm using iNumber Alarm Block6 0x000 Specify the type of alarm using iNumber Alarm Block7 O00 Specify the type of alarm using iNumber Alarm Block8 0x000C Specify the type of alarm using iNumber 0x8002 Sampling group of a specific group number Specify a group number using iNumber Continued API Function List Enter a value based on the value in iNumber iBackupDataType A value in iBackupDataType Expansion Range There are three types of alarm data Active History and Log Specify the type AVASIN Expansion Range iNumber p 9 Check if the alarm block contains available data based on the following priorities and if data exists 0 the data becomes a target 1 Alarm History 0x0005 to 0x000C 2 Alarm Log
152. y Tool the system program of WinGP cannot be sent e When you are using the copy tool a project file with a different Device PLC settings cannot be sent If you try to send the project file with a different Device PLC an error message appears and the transfer is cancelled e When you are using the copy tool font cannot be added If fonts for GP Pro EX are added these fonts in a project sent by the copy tool will not be displayed 37 9 6 Restrictions on error logs e Ifan error log is opened when the error log feature starts writing writing to the file cannot be completed e When the number of error messages exceeds Number of Files to Save in Error Settings the oldest file is deleted to add a new file e Ifno more than 10 minutes have past since the last save the error log is not saved until 10 minutes pass to avoid frequent write access If so all summaries recorded in the 10 minutes are saved in the error log file GP Pro EX Reference Manual 37 170

IPC Settings - Pro-face America HMI Store

Contents

Download Pdf Manuals

Related Search

Related Contents