Home

I-7188E Software Manual

1. DataBit 8 x Send 02M Parity None v 2430 32 44 StopBit f x Receive Clear 1027021 MiniOs Version 21 30 32 37 30 32 31 fvi 0 14 20018 1 Close Please refer to SendTCP s help document for more information H OrCAD Release 9 3 ANAFI Network LF Teq HyperSnap DX At Configure Wizard Y Send TCP help a Y v v v EENT a Uninstall PC Diag 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 84 4 6 3 Using 7188E3 exe to link 7188E3 Step 1 Run 7188e Tcp Xserver Client Module 7188e3 Vb5 7188E3 exe in host PC iw 7188E3 oli Server Connection r Server COM1 Hast IP BEL Configuration Baud Rate epp Data 3 E Party T Server Information COM Part Setting stop Firmware Ver l server Name Send UME 7 ce eee oe ame Response p Gateway M set Mask Ooo e Set Server COM Configuration m Echa Service Baud Rate app Data 3 E Seno Eea _ ee Response COM Port Setting stop ia m send Receive Data Send sens SME F cP Response Response z DIO I Server COM3 DOS DO2 DOI DOO Configuration DOn E ee i Baud Rate 600mm Data J EE Party COM Port Setting stop DIS DI2 Dn bio DI 0 00 Sma SOM F CF Response i A Responses Response Step2 Press Connect button and th
2. Note gt We will enhance the Xserver continually Please refer to 7188E Document Readme htm and gt 7188e TCP Vxcomm Doc Big5lEnglGb2312 Vxcomm htm to get new version information 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 74 4 5 2 Setting of compiler BC 3 1 To develop programs for 7188 7188X 7188E 8000 series you can use the compilers below 1 BC 3 1 5 02 2 MSC 3 MSVC before version 1 52 4 TC 2 01 5 TC 1 01 From Borland s web site you can download the free TC 2 01 and TC 1 01 compilers Web site http community borland com museum How to use BC 3 1 s IDE to compile projects Please follow the steps below Step 1 Create a new project Add item Delete item Local options Include files gt 13 amp Test PRJ K iles ays 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 75 Project TEST eee Step 2 Add all necessary files into the project MERSGSEEE Options pen project lose project Local options Include files Project TEST Step 3 Set Code generation options UUs Lea eas eee oe en area roach ntry Exit Code C options Advanced C options ptimizations Ae ource lessages ames Options T S 2 lt gt Large u Assume SS Equals DS IIl o a ef ines ee 7188E Series Software User s Manual 2004 v2 1 7MS 003 21
3. Real COM 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 40 Step 3 Virtualize 7188E 8000E s COM1 to become PC s COM4 by using the VxComm Utility xComm Utility 2 03 x 7188E 8000E Intemet Ethemet I Check Duplical IV Check Serve IP Address 192 168 255 1 Add Server Pot com Po i Ch CH Port 1 COM4 Status Available Available VxComm Devices 7188E1 192 168 255 1 Server Options x Remove Server Status 7188E1 v3 0 01 11 19 2001 connected Step 4 Run the 7188xw exe from the Start Run menu Run tx Type the name of a program folder document or Internet resource and Windows will open it for you Open 7188xw Cancel Browse Step 5 Press the lt Alt gt lt 4 gt keys to use PC s COM4 It will show Change to use COM4 message after changed 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 41 T188x for WIN32 version 1 06 07 11 2001 By ICPDAS Tsai Kun Ting Current set Use COM 115200 N 8 1 AutoRun vcom3001 exe Current work directory F 7188xXw xxx Change to use COM4 xxx COM4 115200 N 8 1 F 188Xw pg Step 6 Type some characters in the window The characters will be sent from PC s COM4 to 7188E 8000E s COM1 through Path1l and immediately returned from the 7188E 8000E s COMI to the PC s COM4 through Path2 then shown on the PC s minito
4. sssssesesesesesesesecesecesecesesecseeseseseceseseceseseceseseseseseceseseseseseseseseseeeeees 8 1 3 SOFTWARE INSTALLATION a a E aes E R ER 10 1 4 SOFFWARE UTILITIES 3620 AE E E E E A EE E E E E EE E AEE TE 13 1 5 PC DIAGNOSTIC TOOLS sis a od estas a a eed de eae ete da ee en te ies ees 17 2 MINIOS7 OF THE 7188E SERIES sec cccissescsscssaccsscevssossessencecusnssssesssescauuavoesecsd sococdosuuscossenscsteseesseedseacoctenesesseaseccgstaseoodees 20 2 1 MINIOS7 FOR THE 7188E SERIES cccccccssecesesesesevesssecesevecereveseseseseseceseseseseseseseceseseseceseceseseeeseseseseceseseseseseseseeeeeeees 20 2 2 DEMO PROGRAMS FOR THE 7188E SERIES sscsseeesesesesesevevecesecesseececeseseseseceseseseseseseceseseeeseceseseseseceseseseseseseseeeeeeees 23 3 VXCOMM APPLICATIONS wisssssccissossesecoasocsescciscssccosevssteossetecsssessecssdusioossbecsesenvecsesustecsesesceldeesesnssuvensoeds soessedesoosusvecessecs 24 3 1 OVERVIEW sree ee eee ee ESE LEE SRB Ii 24 3 2 INSTALLING THE VXCOMM DRIVER ccscssseseseseseseceveveveveveveveveseceveveveceveseveverereceveveseveseseceeesecesesececeseceseseseseseeeeeeeeens 27 3 3 ADDING A 7188E 8000E SERVER AND CONFIGURING THE VXCOMM DRIVER s0scssseeseeeseseseseseseseseseseseseseseseeeeens 29 3 4 REMOVING A 7188E 8000E SERVER 0scesesesesesesesesesesecesecevesesececesececesevececeeesecesesesecesecesesesesesesececeseseseseseseseeeseeees 37 3 5 UNINSTALLING THE VXCOMM DRIVER
5. 00sssesesesesesesesececeseveseseseseseceeesesesesecesesesereseseseseeeseceseseseceseceseseseceseseseeeeens 39 3 6 DIAGNOSTICS AND TROUBLE SHOOTING cccccccseseseseseveveseveveveveseveveseveverevevevevevevevevesevesereseveseseseseseseseseseseresesenesens 40 3 7 FAO Fevers aces de oeetu see a ees Seg eb bas a dl cobec Hoan a aa e tdiecs ew a shud atau tes A E E tuvtan Meckoes ta Menten 52 4 ETHERNET VO APPEICATIONS cisscssccccsccssenssssscssscosesecsoososscecesosnosostesccocesccecsectssssececoseesscesdecseccesessaseosssadesedensosdescddeeess 53 4 1 OPERATION PRINCIPLE OF THE XSERVER sscsesesesesesesesececevevevesecevececevevevevevevesesevesevesecesesesecesesesesesesesesereseseseeesesens 53 4 2 COMMAND PROTOCOL OF XSERVER ssssssssesesssesevecesesecesevececeseseceseceseseceseseseseseseceseseseseseseseseseceseceseceseseseseseseseeeeeeens 54 4 3 DEMO PROGRAM LIST OF XSERVER s ssssssssseseseseveseseveseceseceveveveseseseseseeesesereseseeeseeesesecesesesecesecesesecesesececeseceseseseseeeeees 66 4 4 CLIENT PROGRAM LIST FOR XSERVER csssseseeesesssesssesecesecececeveveseseseseseeesesesececeseseceseseceseceseseseseseceseceseceseseseseseseeeeens 69 4 5 PROGRAMMING OF XSERVER csssssesesssesesesecesesevecevevsvevevesevevevevesesevevesecesesevecesesevesevereseceseseseseceseseceseseceseceseseseseseseeens 72 4 6 USING CLIENT PROGRAMS cvecssssevstigevceseaveveuiuaiusn a a a au deeve a tease vouieiiuve vsuovevesusjagves N E 79 4 7
6. 76 Step 4 Set Advanced code generation options roject indow elp See ion options Advanced C options ptimizations l ource s essages ames Far Data hreshold Step 5 Set Debugger options a indow Help pplication ompiler ransfer ake inker nvironment BEJ 52 Ce None m d Display Swappin i rogram Heap Size KZA K bytes 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 77 Step 6 Make the project Note Please refer to 7188e Document TCPLib pdf to get more information about settings of other compilers 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 718 4 6 Using client programs To test functions of Xserver you must run a client program We support many Quick Start documents for specific modules like 7188E3_Quick_Start pdf 7188E4 Quick_Start pdf Please refer to documents in 7188E Document 4 6 1 Using Client4 exe to link 7188E3 Step 1 Run 7188e Tcp Xserver Client Common VB5 Clhient4 Client4 exe in host PC Press Connect button to connect to 7188E3 Send command 01 10 ia Client side host name DNS IP 192 168 30 23 ECHO Client Server IP 192 168 255 1 Receive v3 0 00 10 22 2001 I 7188E31 10 Module name Status Connection to 192 168 25 Step 2 Send 161 162 and 163 to readout COM port setting
7. Inquires the lt 29 Port 1 gt CTS status COM port Only support 291 CTS1 0 COM1 3 4 5 Sends the string and receives the data which is the same as the string of Sending lt 30 String gt String Any string The max length of string is 1460 bytes Set the trigger level of lt 31 Port 1 LL gt COM port of 16550 Port 3 8 31314 COMS triggerlevel 14 31 Support COM3 8 only LL 1 4 8 14 38 It didn t support Choice one only from four items 313 COMB triggerlevel 8 Set the trigger level of 32 Port 1 nnnn gt 304 11460 32 COM port buffer Port COM port 1 8 322 21460 Bytes Nnnn 0 1460 Reads the library 7188el lib Ver 2 1 Aug 02 version and date of 2004 Vcomnnn exe Include tcpipL lib Ver 1 3 Apr 08 7188el lib amp tcpipl lib 2004 Note 1 The number inside of instruction format is parameter size byte Note 2 Don t insert any space between parameters except user defined command Note 3 All command except user defined command responses will add a terminal char CR 0x0d Note 4 Refer to vxcomm htm to get more information about Xserver command protocol and parameter setting in 7188e Tcp Vxcomm Doc 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 57 4 2 3 Options of command line VcomNNNN exe Option NNNN denotes the Vxcomm Lib version Options Explanations Notes 1 Recognizes 7188E1 2 Recogni
8. SCANF Demo for using LineInput and Scanf RUNPROG Uses Ungetch to send commands to MiniOS7 to run another program DEMO90 98 Demos for using TIMER functions Location 7188e MiniOS7 Demo Some typical TCP IP demo programs are given as follows Typical TCP IP demo 7188E PC Ping demo Client ping exe None Telnet server demo Server telserv exe Client telnet exe Telnet server demo2 Server telserv2 exe Client telnet exe Demol TCP IP demo Server demol exe Client Clientl exe Demo2 TCP IP demo Server demo2 exe Client Clientl exe Demo3 TCP IP demo Server demo3 exe Client Clientl exe Location 7188e TCP Other Refer to Sec 4 7 for more TCP IP demo program designed for Xserver Refer to 7188e document TCPIPLib pdf 7188e minios7 doc index htm and 7188e document WebLib pdf for more information Refer to sec 5 2 for how to compile and link 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 23 3 VxComm Applications 3 1 The VxComm Virtual Comm Driver and VxComm Utility are very easy to install and use The first thing to do is to find the installation file in the Overview Installing the VxComm Driver Adding a 7188E 8000E server and configuring the VxComm Driver Removing a 7188E 8000E server Uninstalling the VxComm Driver Diagnostics and Trouble Shooting FAQ Overview included CD The directory is gt 7188e TCP VxComm NT VxCommNT e
9. 5 Any RTC function GetTime SetTime GetDate SetDate refer to demo9 for example code void UserInit void user s initial function timer initialized for UserCount VO or variables initialized for UserLoopFun I O or variables initialized for User s functions in this file refer to demo9 amp demol1 for example code void UserLoopFun void VxComm exe will call this function every scan time refer to demol1 for scan time evaluation 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 73 int UserCmd unsigned char Cmd unsigned char Response user s command interpreter refer to all demo if Cmd 0 Not Null command strcpy Response Cmd echo user s command back return 1 return OK return 0 return ERROR int VcomUserBinaryCmd TCPREADDATA p VXCOMM EXE 2 6 12 09 04 2001 or later will support this function TCP PORT 10000 command 23 will call this function user can get the following message p gt ReadUartChar the buffer store the command data include 23 p gt Length the command data length include the two byte 23 p gt Socket the socket number that receives the command that is when the user function wants to return a message to the client just use the socket to send data use VcomSendSocket p gt Socket pdata datalength return 1 any value will be accept
10. COM COM Porte _ COMA COM5 COM6 COM8 Port 1 0 O board 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 26 3 2 Installing the VxComm Driver Step 1 Run VxComm2K exe for Windows2000 Windows XP or VxCommNT exe WindowsNT4 0 or VxComm98 exe from the Napdos 7188e Tcp VxComm driver pc 2k or NT or 9x directory Step2 Choose a destination folder xComm Driver Setup Choose Destination Location etup will install files Step 3 Choose a program folder Select Program Folder x etup will add program icons to the Program Folder listed below You nay type a new folder name or select one from the existing Folders list Click Next to continue f EE TE E Late Accessories Administrative Tools DAGPro FactorySoft OPC GlobalSCAPE InstallShield 5 5 Professional Edition t Step 4 Select the Yes option and click the Finish button to reboot your computer Setup Complete Setup has finished copying files to your computer Before you can use the program you must restart Windows or your computer C No Iwill restart my computer later Remove any disks from their drives and then click Finish to complete setup 7 SE Step 5 After rebooting the computer the VxComm Utility will ask you to configure the virtual COM port s Please refer to the next section for more information Note The Vxcomm driver is l
11. ia Client side host name DNS IP 192 168 30 23 ECHO Client Server IP 192 168 255 1 Server Port fi 0000 Disconnect conn Send 163 r With CR 3 0 00 10 22 2001 I 7188E31 9600 8 N 11 161 Setting of COM1 162 Setting of COM2 163 Setting of COM3 Receive 9600 8 N 11 9600 8 N 11 Clear Status Connection to 192 168 25 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 719 Step 3 Send 170000 and 18000005 to access D I O of 7188E3 170000 _ Read value of address 0 al 18000005 a ee Output 05 to address 0 Stat Connection to 19216825F Step 4 Disconnect and then reconnect at port 10002 Step 5 Select With CR and then send 02M to read 7000 module s ID which is connected to 7188E3 s COM2 ia Client side host name DNS IP 192 168 30 23 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 80 Step 6 Disconnect and then reconnect at port 10003 Step 7 Select With CR and then send 03M to read 7000 module s ID which is connected to 7188E3 s COM3 4 6 2 Using SendTCP to link 7188E3 Step 1 Run SendTCP in host PC Send TCP 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 81 Send TCP 7188E 8000E Diagnostics App v2 0 Config TCPAP Send Commend To 7188E Send Clear Result Select
12. s applications without any limitations So every software engineer can design his special protocol without any pre defined standard This will cause some of the troubles given as follows Is this protocol reliable Does this protocol fit all requirements How to maintain protocol created by another software engineer Time to market Engineering cost to design amp debug this protocol The Xserver is designed to solve all problems mentioned above as follows gt We design amp maintain the reliable original Xserver for all users gt The protocol is designed to fit all requirements of the 7188E series gt The protocol is OPEN amp expandable to reduce user s design cost gt An easy use interface is designed for user s special applications gt Standard design and maintaince for all engineers using this protocol The features of the Xserver are given as follows The Xserver VComNNNN EXE is an embedded firmware designed for the 7188E series in the default shipping Supports Virtual COM applications Supports Ethernet I O applications Supports I O expansion bus Supports 7188E1 2 3 4 5 8 7188EX amp 7188EA and etc TCP IP protocol amp command protocol is open amp expandable Provides easy use interface for user s special programs Vv VVVVV V With the help of Xserver a software engineer can design a robust Xserver in one day We will provide about 50 100 typical real world applications for us
13. v2 00 does not work with VxComm Server 7188E 8000E v2 6 00 Yes please upgrade the VxComm Server to version 2 6 14 or later version The VxComm Server 7188E 8000E v2 6 00 uses the 06 and 07 command to change the baudrate and the data format and then saves these configurations into the EEPROM The newer version adds the 02 and 03 command to change the baudrate and data format without saving These two commands improve the performance when changing baudrate and data format The VxComm Driver PC also changes the operation when using the 02 and 03 commands Thus users have to upgrade their VxComm Server 7188E 8000E to the later version Does the VxComm Driver PC support auto reconnection after fixing a network break Yes the VxComm Driver PC supports the auto reconnection mechanism after version 2 00 The VxComm Utility allows users to set the server options that include Keep Alive Time ms and Connection Broken time ms Please refer to the section Adding a 7188E 8000E server and configuring the VxComm driver 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 52 4 Ethernet I O Applications 4 1 Operation Principle of the Xserver The typical TCP IP mechanism is a standard tool but very complicated for a software engineer It takes long time for a software engineer to develop a programs using TCP IP protocol The command protocol designed for a TCP IP system can be based on user
14. 5 1 Original Xserver All user c files are devided into two parts One is the explanation head the other one is the program body Explanation head DEMO4 Echoes command string Compiler BC 3 1 TC 3 0 TC 1 01 TC 2 0 Compile mode large Content of the Project user c _ gt project file v7000 c vModbus c after Vcom_3002 Lib 7188EL Lib Lib TCPIPL Lib Lib VcomNNNN Lib with NNNN being the lib file s version Client programs use this command protocol to communicate with the Xserver 19 gt Any non null command will be accepted This demo is the original user c User can modify their own Xserver from this file Hardware 7188E Some addition hardware Explanation of this demo devices will listed here program Refer 7188e TCP Doc Big5lIEnglGb23 12 Vxcomm htm 7188e TCP Xserver Xserver htm 7188e TCP Xserver Function htm to get more information Last modified date 17 Nov 2001 by TCK 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 72 Program body include lt string h gt include lib 7188e h include lib vxcomm h void UserCount void user s timer trigger function Tn this function user cannot use any function that will use the hardware signal clock Such as 1 ClockHigh ClockLow ClockHighLow 2 Any EEPROM functions 3 Any 5DigitLed functions 4 Any NVRAM function
15. DEMO PROGRAMS OF XSERVER sssssssseseseseseseeeseveveveceveveveveveseveseseseveseeeseseseseseeesesesesesesesesesesesesesesesececeseseseceseseeeeeeees 88 5 GLOSSARY ceisssccvessvissensesssvensecsenssssssecsosscteseosevticssdentesssiastcccenstesensoctesesdecseonssesieneasosdebeasessescodsvdalesdeveasesdeseossvsseosesdeesosesee 102 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 2 1 Introduction One 7188E series controller comes equipped with one RJ 45 connector one I O expansion bus and several serial COM ports The 7188E is an embedded controller which with aid of c language can help you develop your own programs Included with the 7188E are many demos and libraries The 7188E can be used to access devices via Ethernet Internet or RS 232 485 422 In addition each 7188E controller has one I O expansion bus Our expansion boards can be mounted quickly and easily to implement various I O functions such as D I D O A D D A Timer Counter Flash memory and battery backuped SRAM aie 2 188E Ethernet 10M 9 Ethernet 10M a N ss ORS C5 Firmware Vxcomm Xserver Web server VO Expansion be Board RS 232 485 422 Devices 7000 01 7000 F F RS 232 485 422 Devices AT cen Router Router VO Expansion Board Hub Ethernet 10M 7000 01 7000 F F 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 3 1 1 3 typical applications 7188E series co
16. Echoes command i Original Client1 string X Server Echoes special Xserver will echo 7188_ Series or Demo5 Client1 string to clients 8000_Series to clients Demo6 Reads writes the I O This demo shows how to use command Client 7E only port of the 7188E 19 to replace command 17 18 You can use Print or printCom1 to send a Debug string to PC monitor by Uses printCom1 t 7188E 8000E s COM1 Demo7 pri ii s Clienti debug programs If you want to use Print you must use DisableCom and RestoreCom to disable printCom1 You can use Print or printCom1 to send a Debug string to PC monitor by Uses Print to debug 7188E 8000E s COM1 Demo8 Client1 programs If you want to use Print you must use DisableCom and RestoreCom to disable printCom1 UserCount will be executed every second Count value will be icreased in Demog Timer trigger demo UserCount PC can read count value to Client know how many seconds after count value be cleared Semeie Refreshes If user s function cost more than 1 6 Clienti i Watchdog demo seconds User must insert RefreshWDT 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 Demo11 7E only Demo12 Demo13 7E only Demo14 Demo15 7E only Demo17 7E only Demo18 Demo19 function to refresh WDT avoid the OS restarting itself in 1 6 second Real time I O This demo shows complex real time contro
17. I O control Part of the explanation head 19i 19I gt read D I form address 0 190 190 gt D O to address 0 This demo show complex real time DI DO operation in UserLoopFun Hardware 7188EA or 7188E D I O expansion board Note Base address of 7188EA s DI is 1 Part of the program body unsigned char DI DO char cVal 80 void UserLoopFun void VxComm exe will call this function in every scan time real time I O control function DOO DI0 DO1 DI1 DI2 DO2 DIB DO3 DOS control by host pC DI inportb 0 read DI if DI amp 1 DO DO amp Oxfe DOO DI0O else DO DO 1 if DI amp 2 II DI amp 4 DO DO 2 DO1 DI1 DI2 else DO DO amp Oxfd if DI amp 8 amp DO DO 4 DO2 DI3 else DO DO amp Oxfb outportb 0 DO write to DOO DO1 DO2 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 int UserCmd unsigned char Cmd unsigned char Response int iAddr 0 char DoVal switch Cmd 0 case 1 case T DI inportb iAddr sprintf cVal x DD break case o case O sscanf Cmd 1 x amp DoVal sprintf cVal x DoVal DoVal DoVal amp 0x78 DO DO DoVal outportb 0 DoVal break default return 0 return Error s strcpy Response c Val return 1 return OK Note The key points of this demo are given as follows Host PC controls DO3 DO6 of the hardware The Xserver controls DOO DO2 of the hardware indepe
18. Reads Writes Clears NVRAM Controls hardware in UserCount Data Acquisition amp Compression amp Averaging Echoes all data including 23 to specific clients Uses countdown timer Data Acquisition Compression amp Averaging Uses Modbus TCP protocol to D I O NVRAM s characteristic is short response time limitless erasure and the battery backup for 10 years Actions concerning hardware control in UserCount is prohibited If user want to control hardware in UserCount they must use flag variable to pass the command to UserLoopFun Function of hardware can be executed correctly in UserInit UserLoopFun UserCmd This demo will increase numbers every second and show the value to LEDs in UserCount function ODM for Contec company Uses VcomSendSocket to echo all data including 23 to specific clients There are 8 countdown timer channel 0 to channel 7 This demo uses channel 0 The countdown timer initial value is 1000 ms When the countdown timer value become 0 the value of the LED will increase Client4 Client4 CheckValue Client4 None CheckValue We will provide 50 100 demo programs for the Xserver in the future Please refer to 7188E TCP Xserver Xserver htm and Function htm for more information of demo programs 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 68 4 4 Client program list for Xserver 7188E2 es Config Host Host Configura
19. Series Software User s Manual 2004 v2 1 7MS 003 21 8 Sub directory tree of 7188E 7188E Document Readme htm MiniOS7 Demo Doc Big5 Eng Gb2312 1 Configure Wizard TCP PCDiag Setup m 2 Send232 3 Send TCP Source 4 7188E VxComm Doc c Big5 Eng Gb2312 vxcomm htm Driver PC NT 2K XP Server 7188e Web Server Xserver 7188EA 7188E2 7188E8 Client VB VC Demo BC MSC TC Demo H Lib v7000 Xserver htm Function htm Other UDP Other 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 1 3 Software Installation 1 3 1 Installation Steps The installation steps are given as follows Step 1 Change the directory to the destination folder as follows For example CD ROM Drive is D C gt d D gt cd NAPDOS 7188E D NAPDOS 7188E gt _ Step 2 Make a new directory for the 7188E Xcopy all files C gt md 7188E C gt cd 7188E C 7188E gt xcopy d c s v 1 3 2 Installing 7188X exe 7188XW exe The 7188X exe 7188XW exe is used to download and debug programs Users should copy it to the PATH directory first Then user can execute 7188X exe 7188XW exe
20. is any program that waits for incoming requests from a client program The server receives a client s request performs the necessary computation and returns the result to the client Firmware Alterable programs in the semi permanent storage e g ROM EEPROM or Flash memory 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 105
21. memory F10 Downloads the file specified by F2 into SRAM and execute it Alt_F10 Downloads the file specified by F2 into SRAM memory Ctrl_B Sends a BREAK signal to the PC s COM port that is used by 7188xw exe sep more more 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 1 5 PC Diagnostic tools The PC Diagnostic tools include gt Configure Wizard guides users step by step in configuring the 7188E 8000E s network setting Express gt Configure Wizard 10 2 COMI COM status _ Host PC Operation com gt 115200 IP 192 168 30 23 Step 4 Connect COM1 COM2 of PC Line contol N81 Mask 255 255 0 0 to COM1 of the 7188E 8000E Step 5 TAa Close Gateway 192 168 0 1 Press the Open button 188E Setting Origin 188E Setting Recomend Information of the IP iP IP 1321683024 7188E 8000E Information of PC Mask Mask Mask 255 255 0 0 Configure Gateway Gateway Gateway 192 168 0 1 Exi xI Please refer to sec 3 3 of 7188E Series Hardware user s manual for more operating details 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 17 gt Send232 uses serial port RS 232 interface to communicate with devices Can be used to test the Virtual COM technology Send232 2 0 0 COM2 COM status gt _ Send string with com2
22. of charge Yes No 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 20 Note We reserve the right to change the specifications of MiniOS7 without notice Command Set of MiniOS7 Command Description LEDS pos value Shows a HEX value in the specified position of 5 digit LED USE NVRAM Into the service routine for read write NVARM USE EEPROM Into the service routine of read write EEPROM USE Flash Into the service routine of read write Flash ROM USE COM2 option Into the service routine of send receive to from COM2 RS 485 DATE Sets the date of RTC mm dd yyyy TIME hh mm ss Sets the time of RTC MCB Tests current memory block UPLOAD The first step to update the MiniOs7 BIOS1 The last step to update the MiniOs7 LOAD DOWNLOADs the user program into the Flash Memory DIR crc Shows the information of all files download in the Flash Memory RUN fileno Runs the file with file number fileno no filene gt the last file Name Runs the file with file name name DELETE or DEL Deletes all files stored in the Flash Memory It will delete all files RESET Resets the CPU DIAG option Hardware Diagnostic BAUD baudrate Sets the new value of communication baudrate to baudrate TYPE filename b Lists content of the file REP command Repeats executing the same command times RESERVE n Reserves n Flash Memory
23. sectors for USER s programs LOADR Downloads a file into SRAM RUNR param 1 Runs a program saved into SRAM downloaded by command param2 LOADR I AINP IW INPW port Reads data from the hardware PORT O OUTP OW OUTP Outputs to hardware PORT W port value More More Refer to 7188E MiniOS7 DOC Index htm for user s manual amp demo programs for the MiniOS7 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 21 There are some of the libraries included with the 7188E 7188EL LIB CPU amp I O related library Large model TCPIPL LIB TCP IP related library Large model VComNNNN LIB Xserver related library Large model with NNNN being the version of library Some of the libraries supported by 7188E LIB are given as follows Function Example description COM port InstallCom1 InstallCom2 InstallCom5 InstallCom36 InstallCom47 InstallCom58 IsComl IsCom 2 IsCom7 IsCom8s ToComl ToCom ToCom7 ToComs ReadComl1 ReadCom2 ReadCom7 ReadCom8 EEPROM WriteEEP ReadEEP EnableEEP ProtectEEP NVRAM amp ReadNVRAM WriteNVRAM GetTime SetTime GetDate RTC SetDate LED amp LedOn LedOff LedToggle InitsDgitLed Show5DigitLed 5DigitLed Show5DigitLedWithDot Flash Memory FlashReadId FlashErase FlashRead FlashWrite Timer amp TimerOpen TimerClose TimerReset Value TimerRead Valu
24. the explanation head 19c 19C gt clear count value 19r 19R gt read count value UserCount will be executed every second Count value will be increased in UserCount PC can read count value to know number of seconds after count value is cleared Hardware 7188E Part of the program body unsigned int cnt char c_cnt 20 void UserCount void user s timer trigger function refer to demo9 for example code printCom1 n rUserCount d cnt cnt 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 90 void UserInit void user s initial function timer initialized for UserCount VO or variables initialized for UserLoopFun I O or variables initialized for User s functions in this file refer to demo9 amp demo11 for example code cnt 0 AddUserTimerFunction UserCount 1000 call UserCnt every 1000 ms int UserCmd unsigned char Cmd unsigned char Response user s command interpreter refer to all demo int i if Cmd 0 Not Null command switch Cmd 0 case c 19c 19C gt clear count case C cnt 0 break case r 19r 19R gt read count case R break default return 0 Command Error sprintf c_cnt d cnt strcpy Response c_cnt return count value return 1 return OK return 0 return ERROR 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 Demol11 Real time
25. z a600 x None C LF_CR C CR C CR_LF Line control N81 C LF Open Close Auto send sting Interval 500 Set Send Send Stop i Send Receive Exit Program Please refer to sec 3 6 for more operating details gt SendTCP uses TCP protocol to communicate with the 7188E 8000E and devices which are connected to the 7188E 8000E s COM ports Config TCPAP _ _ Send Command To 7188E __ Network Status Gateway NC Set Send Clear Result _Send_ _ Ciar Result Mek INC set mac MC C None CR C LFC LF CRO CR LFC CS_CR Modify IP Select Port l Send Data with Send Data 7188E COM Status Send Ce Nc Set Fw Ver Receive nc Clear MiniOs Version Please refer to sec 4 6 for more operating details 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 18 gt 7188e Command prompt mode program used to send data to specific machines using TCP protocol Usage 7188e S IP P Port gt Connect to a device by using TCP protocol Q gt Quit program and disconnect C Program Files 7i88E PCDiagS71i88e s 2192 168 38 24 p 1 8888 Connect to 192 168 38 24 10608 Commands i ud 6 61011719 2081 1A 7188 E2 y C 5 Program Files 7188E PCDiag gt 7188E Series Software User s Manual 2004 v
26. 021 Ox0c char cModuleID 5 Store module ID 7021 0x00 void UserCount void int i SendCmdTo7000 2 01M 0 ReceiveResponseFrom7000 2 cStr 1000 0 cut 01 and cr strepy cModuleID cStr 3 cModuleID 4 0 Show moduleID to PC monitor printCom 1 Address 01 ModuleID s n r cModuleID void UserInit void AddUserTimerFunction UserCount 1000 InstallCom 2 9600 8 0 SetBaudrate 1 115200L 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 99 Demo19 Reads system serial number Part of the explanation head 19 gt Any command will be accepted Unique hardware serial number is used to protect user s software Using 7188xw exe to enter 7188E and then execute command ver MiniOS7 will show the serial number User can check the number at first then decide to execute Xserver forward Hardware 7188EA or 7188EX Note Base address of 7188EA s DI is 1 Part of the program body int bSerialNumOk char cID 8 0x9 0x31 0xa4 0x39 0x3 0 0 0x5 void UserInit void char cSerialNumber 8 GetSerialNumber cSerialNumber if stremp cSerialNumber cID bSerialNumOk 1 Matching else bSerialNumOk 0 Unmatched int UserCmd unsigned char Cmd unsigned char Response if bSerialNumOk strcpy Response ID ok else strcpy Response ID error return 1 return OK 7188E Series Software User s Manual 2004 v2
27. 04 19 or module later MO0 Multi echo mode Condition 1 One client sends a request to Xserver to access devices The Xserver echoes data from devices to every client which is connected to the 7188E 8000E 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 60 Condition 2 No clients send a request to Xserver to access devices The Xserver echoes data from devices to every client which are connected to the 7188E 8000E M1 Single echo mode Condition 1 One client sends a request to Xserver to access devices The Xserver echoes data from devices to the client which requested the service Condition 2 No clients send any request to Xserver to access devices The Xserver doesn t echo data from devices to any client Txxx Request Response 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 62 4 2 4 Flow chart of Xserver Reset 7188E 8000E y Xserver Initialize v Userlnit void UserLoopFun void Scan COM ports amp Send packet from TCP ports Y Update 5 DigitLED Switch
28. 1 7MS 003 21 100 Demo23 Echoes all data include 23 to specific clients Part of the explanation head 23 gt Any command will be accepted This demo illustrates how to use command 23 to send messages to specific client Xserver will echo all data inclued 23 to client Hardware 7188E Part of the program body int VcomUserBinaryCmd TCPREADDATA p VXCOMM EXE 2 6 12 09 04 2001 or later will support this function TCP PORT 10000 command 23 will call this function user can get the following message p gt ReadUartChar the buffer store the command data include 23 p gt Length the command data length include the two byte 23 p gt Socket the socket number that receive the command that is when the user function want return message to the client just use the socket to send data use VcomSendSocket p gt Socket pdata datalength echoes all data include 23 to specific client VcomSendSocket p gt Socket p gt ReadUartChar p gt Length return 1 any value will be accept 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 101 5 Glossary 1 Ethernet The term Ethernet generally refers to a standard published in 1982 by Digital Equipment Corp Intel Corp and Xerox Corp Ethernet is the most popular physical layer local area network technology today Ethernet is a best effort delivery system that uses CSMA CD technology It recognizes h
29. 188E3 s COM2 DOQ L L v Turn on DOO DIO is low Q D I status by hex number only lower 4 bits are valid which is connected to Server COM2 Configuration Baud Rate S00 Data E Party R Eom Por semg J D Stop send SM 7 cr Response oo Step 6 Send 03M to read 7000 module s ID 7188E3 s COM3 which is connected to Server COM3 Configuration Baud Rate 600m Data RT Parity Conon sre Don E a uk Response m1 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 87 4 7 Demo Programs of Xserver Demo5 Echoes special string to clients Part of the program body int UserCmd unsigned char Cmd unsigned char Response user s command interpreter refer to all demo strcpy Response 7188_Series return 7188_Series string to clients return 1 return OK Demo6 Reads writes the I O port of 7188E Part of the explanation head 19i n 19I n gt read D I value hex from address n hex 190 add val 190 add val gt output D O value hex to address n hex 19 o add val 19 O add val This demo shows how to use command 19 to replace command 17 18 Hardware 7188EA or 7188EX D I O expansion board Note Base address of 7188EA s DI is 1 Part of the program body char cAddr 80 cVal 80 int UserCmd unsigned char Cmd unsigned char Response
30. 2 1 7MS 003 21 19 2 MiniOS7 of the 7188E Series 2 1 MiniOS7 for the 7188E Series The MiniOS7 is an embedded O S designed for the following families 7188XA 7188XB 7188XC series 7521 7522 7523 series 7188EA 7188EX 7188EX 256 series 7188E1 7188E2 7188E3 7 188E4 7188E5 7188E8 series 8000 series Iview 100 series More new embedded controller families It is used to replace the ROMDOS used in the 7188 series Several brands of DOS have been created by various companies In all cases DOS whether PC DOS MS DOS or ROM DOS is a set of commands or code which tells the computer how to process information DOS runs programs manages files controls information processing directs input and output and performs many other related functions The MiniOS7 provides equivalent functions of ROMDOS and provides more specfic functions for the 7188X 7521 8000 family Comparison between MiniOS7 and ROM DOS Function MiniOs7 RomDos Power up time O l sec 4 5sec Supports I O expansion bus Yes No Supports AsicKey Yes No Supports hardware unique serial number Yes No Supports MMI Iview 100 series Yes No Supports Ethernet 10M interface 7188E amp 8X3X series Yes No Directly downloads executable programs into Flash ROM Yes No O S updateable downloadable Yes No Built in hardware diagnostic functions Yes No Directly controls 7000 series modules Yes No Customers ODM functions Yes No Free
31. 3 VcomUserCmd will receive TCPREADDATA type information The TCPREADDATA is declared as below Type define t_TcpReadData Int Comport int Socket int Length char ReadUartChar TCPREADDATA p gt ReadUartChar the buffer where command data is stored include 23 p gt Length the command data length include 23 p Socket the Xserver assigns a socket number to index when client sends command 23 to the 7188E So the socket number can used to return messages to a specific client Send message to specific client and call VcomSendSocket int skt char data int cnt The first parameter should be the socket number See Demo23 VcomCmdModbus TCPREADDATA p Xserver executes this function when client program sends commands to port 502 of the Xserver This function is used to implement Modbus TCP protocol to access devices See Demo27 VcomCmd7000 TCPREADDATA p Xserver executes this function when client program sends commands to port 999 of the Xserver This function is used to implement 7000 series compatiable commands to access expansion boards See 7188e T CP Xserver v7000 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 65 4 3 Demo program list of Xserver After developing the Xserver program users must download the program into the 7188E 8000E and execute one client program to test if all functions run properly Demo4 KE
32. 38400 OK setting to EEPROM Sets data format doesn t store the lt 03 Port 1 LineControll 3 gt 0328N1 OK setting to EEPROM 141 First asking from client Gets system reset 14 after system reset A status semclemley oIa 140 Not first asking from client 14 after system reset 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 54 lt 05 Port 1 Set 1 o its o R On 0 ve ot o OK COM Port RTS on Port RTS OK COM Port RTS on a baudrate Stores the setting to lt 06 Port 1 Baud gt 06138400 N Sets data format Stores the setting to lt 07 Port 1 LineControll 3 EEPROM 08 Sets IP lt 08 IP 12 gt 08192168255001 OK Reconnect an ttttt gt Received Timeout f Modified from it ms o a Vcom3008 If set as a A or 1 the ttttt is Decided by system J jee Same sl 10 gt BEAD tt iag __ lt 1t String lt 80 gt _ t1Hello__ Hello 12 Sets Gateway e12 GatewayIP i2 s 12 182168000007 OK Reconnect Oe a o B 14 SetsMask_ lt 14 Mask 12 gt 14255255000000 _ OK Reconnect _ _ a 16 Gets COM Status__ lt 16 Port gt ST 96008N1 18 Digital Output__ _ lt 18 Addr_Hex 4 Data_Hex 2 gt pe ernea lt 19 Command gt H9 User defined H9 User defined defined User defined lt 20 Enable 1 aa erable Sgt oe 0 Disable 5DigitLed GetsMac Mac lt 21 gt a E 80 30 39 9f e2 a E Hexadecimal value 2 a MiniOS Version i 0 1 2003 8 22 23 Calls VcomUserCmd
33. 7000 Utility Ele COMPort Search Run Terminal Help the I 7000 8000 Modules Found P m S a m T Di 7060D 1 1 115200 3 6 2 Trouble Shooting Problem Client program fail to open the COM port that was created by the VxComm Driver Check 7188E 8000E s Power supply Network cable IP address subnet mask and gateway Please refer to the 7188E 8000E user s manual for more information 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 Problem Client program still fails to open the COM port Check Step 1 Right click the My computer icon and select the Manage option My Computer Recycle Bin Step 2 Select the Device Manager icon from the Computer Management program E Computer Step 3 Click the menu item View Show hidden devices 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 49 Step 4 Select the item Non Plug and Play Drivers Ynsernet m computer Management Action view e m 2 Tree H E Network adapters i i Non Plug and Play Drivers Computer Management Local 5 3 paa O AFD Networking Support Environment a ib System Tools 1 ja Event Viewer oe System Information ci i Performance Logs and Ale be Q Debug Message Diskperf lt gt dmboot 5 a Sage s Dii J Disk Management ye Disk Defragmenter Logical Drives 3 Removable Storage Services and A
34. 7188E Series 7188E Series Software User s Manual 7188E Series New Features 1 Virtual COM Technology Your Powerful Tools 2 Ethernet I O Technology 3 Web server Technology Create New Ideas 4 MiniOS7 amp Xserver Inside 5 I O Expansion Bus Inside Create New Applications 6 Time to market amp Cost Effective Solution Warranty All products manufactured by ICP DAS are warranted against defective materials for a period of one year from the date of delivery to the original purchaser Warning ICP DAS assume no liability for damages consequent to the use of this product ICP DAS reserves the right to change this manual at any time without notice The information furnished by ICP DAS is believed to be accurate and reliable However no responsibility is assumed by ICP DAS for its use nor for any infringements of patents or other rights of third parties resulting from its use Copyright Copyright 2002 by ICP DAS All rights are reserved Trademark The names used for identification only may be registered trademarks of their respective companies 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 ji Table of Contents 1 INTRODUCTION icicissssescisssciiesesasdastesk cdaeceuesesstscssudesssastasoscactassnsecesses SEEE Os SS OVE TEELE SOSSE USSO CSAS TASASE EEES CS ESVE asso 3 1 1 3 TYPICAL APPLICATIONS EEEE EEEE E E EEEE AE 4 1 2 DIRECTORY TREE OF SOFTWARE AND LITERATURE
35. 8E 8000E s COM1 to become PC s COM10 Thus we can use the 7000 Utility to search the 7000 series module through COM10 Note Users must install the 7000 Utility first by runing CD ROM Drive Napdos 7000 7000Util setup exe Step 1 Run the 7000 Utility gt gt Documents 7000 Utility 7000 Utility Help Settings Uninstall 7000 Utility Search b Help Run Shut Down SCS S TSOFOMBAA 4348 Start 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 45 Step 2 Build connection as follows Real COM 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 46 Step 3 Click the menu item COM Port to choose the COM port number baudrate and checksum For example COM10 115200 19200 9600 and No Checksum These settings depend on the 7000 series module s settings COM Port Jearch Run Terminal Help The I 7000 8000 Modules Found elms cl Module Addr Baudrate Alarm Checksum Description Searching Status COM Pott COM 1 Address Q7fdecl Mihe Baud Rate 775200 9 39PM 5 Select the COM Port and Baud Rate xi 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 Step 4 Click the J search icon 7000 Utility File COMPort Search Run Terminal Help Step 5 If the VxComm Driver works well the 7000 Utility can search the module s connected to the 7188E 8000E s COM1
36. Port Send Data with v C None CRC LFC LECRO CRLF CS_CR send Data si f ee Receive cea r st Network Status Gateway NC Set ask nc Set Mac NC Modify IP 7188E COM Status Inc Set Fw Ver Inc MiniOs Version Step 2 Press Connect button to connect to 7188E3 S Send TCP 7188E S000E Diagnostics App Config TCP IP Send Command To 7188E 192 168 2551 8 p Disconnect Send Clear Result T188E3 is connected Send Data with Port E C None f CR LF LF CR CRLF CS CR ae Data Send gt T Receive ca eo 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 Network Status Gateway 192 168 0 1 Set 255 255 0 0 Set MAC 00 80 31 00 01 14 Modify IP 7188E COM Status 9600 8 N 1 Set Mask Fw Ver 3001 11 19 2001 MiniOs Version fl 0 14 0018 1 Close Step 3 Send command 10 to 7188E3 send TCP 7188E S000E Diagnostics App v2 01 Config TCP IP Network Status 192 168 255 1 Gateway 192 168 0 1 set Connect Disconnect fa5525500 255 255 0 0 Set 7188E3 is connected MAC 00 80 31 00 01 14 Select Port Send Data with Port 1 s None CR C LFC LF CRO CRLFC CS_CR Modify IP Send Data 7188E COM Status sajf oo 600 8 N 1 Set Fw Ver m
37. Receive fv3 0 01 111972001 Char _ MiniOs Version fe 0 14 2001871 Close Step 4 Select Port 2 and CR Then send 02M to read 7000 module s ID which is connected to 7188E3 s COM2 If you enable 7000 module s checksum function select CS_CR The CS_CR option will add two checksum bytes then adds CR Send TCP 7188E S000E Diagy Config TCP IP Send Command To 7188E p Network Status 192 168 255 1 fio Gateway 19216801 set Somme Disconnect Send Clear Result Mak 25525500 set 7I88E3 is connected MAC 00 80 31 00 01 14 g B8E3 LF C LF CRO CR_LAC CS_CR J Modify IP esenee _7188E COM Status 26500 8 N 1 Set Fw er m Receive 3001 11 19 2001 MiniOs Version 21 30 32 3730 3231 v1 0 1420018 1 Close 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 83 If you want to change the 7188E s COM ports settings click Set to change them The 7188E s COM port that you want to configure is specified by Select Port combo list Port 2 means you want to configure the 7188E s COM2 iol x Config TCPAP Send Command To 7188E Network Status 192 168 255 1 x Gateway 192 168 0 1 Set Disconnect Send Clear Result Beaga Set Errik 115200
38. al 2004 v2 1 7MS 003 21 33 amp V VxComm Utility v2 07 00 Sep 10 2003 7188E 8000E Internet Ethernet Controller M Check Duplicate IP 10 10 3411 Timeout ms 5000 Add Server na Import Export Command Port f 0000 a xComm Devices 7188E5 10 10 34 11 8430 10 10 34 12 Por 1 Port 2 Paort3 Paort4 Port5 Server Options xX Remove Serer Status 7188E5 10000 v3 0 10 01 21 2003 connected Port 000 UnMap COM4 COMS COME COM COMES M Check Server Fixed Dynamic Dynamic Dynamic Dynamic Dynamic Another example shown as follow The port1 of 8430 map to COM20 g VxComm Utility v2 07 00 Sep 10 2003 7188E 8000E Internet Ethernet Controller M Check Duplicate IP 10 10 3412 Timeout ms s000 Add Server Command Port rooco VxComm Devices 166E5 10 10 34 11 Port 000 UnMap a 0430 10 10 34 12 Port COM20 Port3 COM21 Server Options xX Remove Server na Import Export M Check Server Fixed Dynamic Dynamic Status 7188E5 10000 v3 0 10 01 21 2003 connected 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 Step 8 Key in the value and then click the OK button to exit xi Server 7188E5 10 10 34 11 Keep Alive Time ms 7000 Recommend 7188E s System Timeout 1 3 Cancel Connection Broken ms f 80000 Connect Timeout ms 5000 Command TCP Part f 0000 Po
39. below errors a Winsock error CheckString b fica data from Xserver 2 Check received data a Full compare b Part compare All demos 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 710 3 Automaticly reconnect ability GetString with main functions 1 Catch below errors a Winsock error b Receive data from Xserver timeout 2 Automaticly reconnect ability 3 Large text box can show 1600 bytes at one page GetString All demos ee More client programs Common client programs are located at 7188e TCP Xserver Client Note gt You can run all 7188E special clients 7188E2 7188E3 7188E4 7188EA etc from 7188e Tcp Xserver Client Module gt You can install all common clients Clientl1 Client2 Client4 Client5 CheckValue CheckString GetString etc by executing 7188e Tcp Xserver Client Common Setup Setup exe gt Please refer to 7188E TCP Xserver Xserver htm and Function htm for more information of demo programs 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 71 4 5 Programming of Xserver To develop the Xserver you must have the 9 files listed below Item Files Location Head file 7188E h TCPIP h Vxcomm h 7188E TCP Xserver Demo BC Lib Library 7188EL Lib TCPIPL Lib VcomNNNN Lib User s file User c VModbus c V7000 c 7188E TCP Xserver Demo BC Demo4 Note The NNNN of VcomNNNN Lib is the lib file s version 4
40. case TCP port AA Refresh hardware v v T v Watchdog 10000 N 10000 9999 502 Yes _FisS ive packe J Timer Trigger Timeout Bypass packet to Switch case y T COM port N command UserCount void k v y v Other 23 19 v meer Execute Cmd Without 19 command v la h Response UserCmd Cmd Response y p VcomUserBinaryCmd TCPREADDATA p User c la y VcomCmdModbus K A TCPREADDATA p Yes vModbus c Send packet from i TCP port 10000 VcomCmd7000 TCPREADDATA p VxComm lib v7000 c 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 63 It is very difficult to develop an embedded controller program with Ethernet Internet communication But by using the Xserver users can do that quickly and easily Users need only modify 7 functions in User c vVModbus and v7000 c Users build their own code in the 7 functions to make the Xserver work as they desire The features of the 7 functions are listed below gt UserlInit void Xserver executes this function once as soon as the 7188E 8000E is turned on Therefore all variables of initial values or initial status must be set in this function gt UserLoopFun void Xserver executes this function every scan loop One Xserver scan loop completes in a short time so real time work should be executed by this function See Demol12 gt UserCount void This function will be triggered when the time interval set in AddUserTimerFunction is up For best resul
41. dynamically Less conflicts more stability Port Configuration Note Assign following COM number sequentially option This option will assign the following ports with the available COM port number sequentially and automatically For example If Port COM4 then Port2 COMS Port3 COM6 Use 7188E 8000E current setting Fixed Config option You can click the Port Configuration button to configure this port s Baud rate and Data format settings After the configuration you can then check this option Fixed Configuration Use 7188E 8000E s current setting By using this feature the VxComm Driver would not change the 7188E 8000E s settings dynamically This is proper when you have multi clients to access the same 7188E 8000E server Dynamic Configuration This s the default method The VxComm Driver always change the 7188E 8000E s settings dynamically It is proper for working with several different baud rate and data format For example you may need to use 7000 Utility to make a search with several baud rates on the RS 485 network Please also refer to Configuring COM port of the 7188E 8000E server lt I i o te Ej mi Ek WQ Oo o 3 EF g wo oO 2 oO Z a i Step 7 Select one of the 7188E 8000E devices and then click the Server Options button to configure the options Note VxComm Utility 98 does not support the Server Options function yet 7188E Series Software User s Manu
42. e Come ni Back Formed Masi lone Samh Gate Port Bs z 7000 01 7000 02 Router Router 7000 01 7000 02 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 7 1 2 Directory tree of software and literature To help users reduce developing time we support many software resources including documents drivers libraries diagnostic programs client programs and many Xserver demos You can quickly find which resources you need by using the directory tree The content of shipped CD AUTORUN INF gt for CD auto run README TXT gt please read this file first NAPDOS Web gt Company web site Ar4 gt for Acrobat reader Bin gt for autorun README TXT gt please read this file first 7000Util gt Windows utility for 7000 8000 NAP7000S gt DOS driver for 7000 8000 NAP7000D gt DDE server for 7000 8000 NAP7000X gt OCX library for 7000 8000 NAP7000P gt DLL library for 7000 8000 NAP70000PCSvr gt OPC server for 7000 8000 NAP7000V gt LabView driver for 7000 8000 7188E Document gt User s manuals and application notes MiniOS7 gt CPU and I O libraries and demo programs Tcp gt TCP libraries and demo programs Udp gt UDP libraries and demo programs Note The software amp manual are updated frequently so the content of the companion CD is also updated frequently The best way is to read every README TXT located in every directory All updated information is given in these files 7188E
43. e Watchdog StopWatchReset StopWatchRead StopWatchStop Timer InstallUserTimer EnableWDT DisableWDT RefreshWDT File GeFileNo GetFileName GetFilePositionByNo GetFilePositionByName Connects to 7000 SendCmdTo7000 ReceiveResponseFrom7000 Programmable I O SetDio4Dir SetDio4High SetDio4Low GetDio4 Others Kbhit Getch Putch LineInput Scanf Refer to 7188e document TCPIPLib pdf amp 7188e minios7 doc index htm lt amp 7188e document WebLib pdf for more information Refer to 7188e document T CPIPLib pdf for how to compile amp link 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 2 2 Demo Programs for the 7188E Series We provide hundreds of demo programs for users The source codes are all in the shipped CD It is recommended to edit amp modify these demo programs when starting user s special applications The demo programs can be classed as follows Some of the demo programs designed for MiniOS7 are given as follows Demo Description Hello Can run on PC or 8000 just use Print to print x Hello 8000 Hellol Demo for using functions Is8000 GetLibVersion Print Hello2 Demo for using C compiler FILE Demo information in obtaining file information and file position in Flash memory All file data is stored in Flash Memory In MiniOS7 cannot use C s functions fopen fclose fread fwrite BATCH An example of BATCH files BAT
44. en the program will readout relative information concerning the 7188E3 and start scanning the DI of the 7188E3 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 85 is 7188E3 iol x Server Connection _ _ r Server COM1 Host P MAMES SetIP Configuration ee Baud Rate Data Party RB gt Server Information ______ COM Port Settin Firmware Ver Fa Doonor COM Port setting stop II Severname TD A 7 ce jy Setver Configuration Response Gateway Set Mask GME Set Sonor CoM m I Configuration cord A oe rE Ten Response COM Port Setting Stop i r Send Receive Data send i send SOME cP Eni E Cie Response i Response DIO Server COM3 DOS DO2 DOI DOO Configuration DOn E e Baud Rate S200 Data RT E Parity iE COM Port Setting stop Response DI2 DH DIO BIS DI 0000 Sma M 7 c Response JOPA E Response Step 4 Connect 7188E3 s DIO and DOO and then select check box to turn on D O channel 7188E3 exe will auto scan D I status every 500 ms determined in program code 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 86 DIO DO3 DOZ DOI D O r oko Response D3 D2 DM DO DI Respons Step 5 Send 02M to read 7000 module s ID 7
45. er s reference From these demos a software engineer can start easily with a cost friendly time to market Refer to Sec 4 3 for more information 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 53 4 2 Command Protocol of Xserver 4 2 1 IP and port configuration Before developing Ethernet I O applications for your PC you must first know the IP address and the Ethernet port number The 7188E 8000E and all COM ports of the 7188E 8000E use the same IP address but different Ethernet port number They are listed below Function IP address Port number Modbus TCP 192 168 255 1 502 Virtual 7000 192 168 255 1 9999 I O boards 7188E 8000E configuration 192 168 255 1 10000 COM1 of the 7188E 8000E 192 168 255 1 10001 COM2 of the 7188E 192 168 255 1 10002 COM3 of the 7188E 8000E 192 168 255 1 10003 COM4 of the 7188E 8000E 192 168 255 1 10004 COMS of the 7188E 192 168 255 1 10005 COM6 of the 7188E 192 168 255 1 10006 COM7 of the 7188E 192 168 255 1 10007 COMS of the 7188E 192 168 255 1 10008 192 168 255 1 is the default IP address of the 7188E 8000E You can change the IP address to suit your requirements Contrary to the IP address the Ethernet port is fixed You must use the port number as defined above 4 2 2 Command set of the Xserver i Example Example Ot Version gt dV 2 6 14 10 04 2001 Sets baudrate 02 Doesn t store the lt 02 Port 1 Baud gt 021
46. grams fr Accessories gt Fn Development Kits gt A Documents gt Microsoft Visual Studio 6 0 9 InstallShield PackageForThe Web 2 Eh Settings r 3 AlAPI Network a Search gt DAQPro EE J C PcDiag 2 Help S fa xComm gt 14 Uninstall xComm Run 2 xComm Help g xComm Utility Cy Shut Down S SendTcp EA SendTcp Help laesgoUuH ag Step 2 Click the Yes button confirm File Deletion x Q Are you sure you want to completely remove xComm for Windows 2000 and all of its components Step 3 Click the OK button unlnstallShield will remove the software YxComm for Windows 2000 from your computer Please wait while each of the following components is removed Shared program files Standard program files Folder items Program folders Program directories So bN ea oe SS A Program registry entries 3 6 Diagnostics and Trouble Shooting 3 6 1 Diagnostics After configuring the VxComm Driver by using the VxComm Utility the VxComm Driver should work without error However users can use a simple test to make sure it s working properly Note The test method depends on the user s devices and client programs E Example 1 Loop Back Testing Step 1 Make sure the VxComm Server is working in m0 mode Please refer to sec 4 2 3 Options of command line i autoexec bat Notepad i lolx File Edit Format Help yoom300 ST300 m0 1l
47. h2 to PC s COM4 Send222 201 C0 sox ix COM status Send string with COM status Send string with com z 3600 None C LF_CR c OM4 z a600 z None C LF_CR C CR C CR_LF CCR C CR_LF Line control N81 el Line control 1 8 1 CF Open Close Open Close rAuto send rAuto send sting Interval 500 Set Interval 500 Set Send Send Stop Receive Send Exit Program Exit Program Step 7 Type Virtual COM in right hand window and press Send Data will be sent from PC s COM4 through Path2 to 7188E 8000E s COM1 and immediately returned through Path to PC s COM1 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 44 zix Pier COM status Send string with COM status Send string with cow 7 s600 z None C LF_CR cow z 3600 None LF_CR COM1 9600 2 COM4 9600 C CR CR_LF CCR C CR_LF Line control N 81 lle Line control N 81 ius Open Close Open Close ruto send __ COMI Auto send Interval 500 Set seneseeseassssnnsesenees eereeeeereeesssessseseseseseeeneseeeeeeneseeeseees Interval 500 Send H ae am aell eas Receive COM1 Clear Clear Exit Program Exit Program Example 3 External Devices Testing Connect 7000 series modules to 7188E 8000E s COM1 Use VxComm Driver to virtualize the 718
48. iginal mode Press TAB to switch the cursor between these two windows F5 Runs the program specified by F2 and arguments set by F6 F6 Sets the arguments of the execution file set by F2 10 arguments maximum If set less than 10 arguments add to end F8 F8 F9 F5 F9 Downloads the file specified by F2 into FLASH memory Alt_F9 Downloads all files specified by ALT_F2 into FLASH memory F10 Downloads the file specified by F2 into SRAM and execute it F12 For 7521 7522 7523 to test RS 232 more More 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 1 4 2 7188XW EXE Utility for Host PC 7188xw exe is the Win32 version of 7188x exe The difference beteween 7188x exe and 7188xw exe is 7188x exe Uses standard COM ports COM1 COM2 7188xw exe Supports RS 232 COM ports using USB and PCMCIA interfaces Command line options of 7188xw exe Option Description c Uses PC s COM b Sets baudrate of PC s COM port default is 115200 s Sets screen s display rows default is 25 max is 50 Hot key of 7188xw exe Command Description Fl Shows help messages of 7188xw exe Alt_Fl Shows the Chinese Big5 help messages of 7188xw exe Ctrl_Fl Shows the Chinese GB2312 help messages of 7188xw exe Alt_1 Uses PC s COM1 Alt_2 Uses PC s COM2 Alt_3 Uses PC s COM3 Alt_4 Uses PC s COM4 Alt_5 Uses PC s COM5 Alt_6 U
49. in any directory on the host PC The installation steps are given as follow Step 1 Change the directory to the destination folder as follows For example CD ROM Drive is D C gt d D gt cd NAPDOS 7188E MiniOS7 D NAPDOS 7188E MiniOS7 gt _ Step 2 Copy 7188X EXE from CD to the PATH directory defined in PATH C gt cd windows C windows gt copy d 7188x exe Note 7188XW exe is designed for win32 system So it can be used for USB RS232 or PCMCIA RS232 port 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 10 1 3 3 Installing PC diagnostic tools Step1 Run Setup exe from the 7188e TCP PCDiag Setup directory Setp2 Choose destination folder ation Location Setup will install PCDiag in the following folder To install to this folder click Next To install to a different folder click Browse and select another folder You can choose not to install PCDiag by clicking Cancel to exit Setup Destination Folder C Program Files 7198E PCDiag Browse Cancel Step3 Select program folder ram Folder Setup will add program icons to the Program Folder listed below You may type a new folder name or select one from the existing Folders list Click Next to continue Program Folders 7188e PCDiag Existing Folders Dr eye 2001 FAA E asyBuilder 200 FinePrint 2000 GlobalSCAPE Step4 Start copying files Setup has enough information to start copying
50. k only with IP addresses Ultimately however communication must be carried out by physical networks using whatever MAC address scheme the hardware supplies Suppose machine A wants to send a packet to machine B across a physical network to which they both are attached but A has only B s Internet address IPg The question arises how does A map that address to B s MAC address MAC ARP provides a dynamic mapping from 32 bit IP address to the corresponding 48 bit MAC address We use the term dynamic since it happens automatically and is normally not a concern of either the 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 103 11 12 13 14 15 application user or the system administrator RARP Reverse Address Resolution Protocol RARP provides a dynamic mapping from 48 bit MAC address to the corresponding 32 bit IP address 32 bit IP address ARP RARP 48 bit MAC address ICMP Internet Control Messages Protocol No system works correctly all the time The ICMP provides communication between the Internet Protocol software on one machine and the Internet Protocol software on another It allows gateways to send error or control messages to other gateways or hosts to know what wrong with the network communication Ping Ping sends an ICMP echo request message to a host expecting an ICMP echo reply to be returned Normally if you cannot Ping a host you won t be able to Telnet or FTP to the h
51. l address Every interface on an Internet must have a unique IP address also called an Internet address These addresses are 32 bit numbers They are normally written as four decimal numbers one for each byte of the address such as 192 168 41 1 This is called dotted decimal notation 8 MAC Media Access Control address To allow a computer to determine which packets are meant for it each computer attached to an Ethernet is assigned a 48 bit integer known as its MAC address also called an Ethernet address hardware address or physical address They are normally written as eight hexadecimal numbers such as 00 71 88 af 12 3e 0f 01 Ethernet hardware manufacturers purchase blocks of MAC addresses and assign them in sequence as they manufacture Ethernet interface hardware Thus no two hardware interfaces have the same MAC address 9 Subnet Mask 10 Subnet mask is often simply called mask Given its own IP address and its subnet mask a host can determine if a TCP IP packet is destined for a host that is 1 on its own subnet 2 on a different network If 1 the packet will be delivered directly else will be delivered by gateways or routers ARP Address Resolution Protocol Consider two machines A and B that share a physical network Each has an assigned IP address IP and IPg and a MAC address MAC and MACs The goal is to devise low level software that hides MAC addresses and allows higher level programs to wor
52. lling DI DO operation in UserLoopFun UserLoopFun will increase count value every scan loop PC can read how many Scan time scan loops there are after clear count evaluation value So user can use this demo to test Xserver performance LoopFun reads the D I signal If signal is Pulse width se tie ea changed records time ticks and measurement f calculates signal width Show5DigitLed Show5DigitLedWithDot can show 5 digits to 7 SEG LEDs Controls 7 SEG The two functions can show 0 9 LED a f A AS F Reads channel This demo shows how to send command values from to read channel value from 7017 or 7108 7017 7018 which is connected to 7188E s COM2 f This demo is similar to demo13 and Pulse width detects signal change and measures measurement signal width This demo shows how to communication with the 7000 series which are connected to COM2 of 7188E or COM3 of 8000E Reads l 7000 series module s ID Unique serial number is used to protect user s software Using 7188xw exe to enter 7188E MiniOS7 will show a number User can check the number at first then decide to execute Xserver from the point on Reads 64 bits unique hardware serial number 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 67 Client Client2 Client Client4 Client4 Client5 Client4 Client4 Demo20 Demo21 Demo22 7E only Demo23 Demo24 Demo25 7E only Demo27 7E only
53. lt 23 String gt SUS definded User defined Sets feedback 240 OK lt 25 m gt m S Inquire the timeout value of system ST m W Inquire the timeout value of socket W mz N Inquire the Max number of socket m M Inquire the Work option MO or M1 m B Enable Disable the Broadcast mode B1 Enable Broadcast Inquiles the parameter mode BO Disable 25M Mo or system Broadcast mode Default B0 m E Inquire the command echo mode E1 Enable echo mode E0 Disable echo mode Default E0 m L Inquire the 7 SEG LED status L1 Enable LED to show LO Disable LED to show Default L1 m l Inquire the NAME IP MASK GATEWAY MAC 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 55 Po BBE s G O lt 26 mn gt m M set the work option M n 0 n 1 m B Set the Broadcast mode 26B0 26B1 m S Set the system TIMEOUT 26 ST 26S300 m W Set the socket TIMEOUT W 26W86400000 m I Set IP MASK GATEWAY or MAC IP GATEWAY MASK MAC must Port 1 8 Set 1 Break enable 0 Break Disable lt 28 Port 1 m n gt Port Only support COM1 3 4 5 RTS must control by users Sets Inquires the Program 28 CTS RTS mode of 2 Enable auto control by the flow control Hardware 3 Enable auto control by Software library For CTS mode 1 and mode 3 are same If the command doesn t add the mn arguments the turn value is the 30 previous value of the First once
54. m Host PC Monitor of host PC R 3 14159 Host PC Run 7188X EXE 7188X 7188E 8000 RS 232 Main 115200 N81 Scanf n f amp r COM1 2 Print nR f n 3 14159 Keyboard of host PC 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 13 Hot key of 7188x exe Command Description Fl Shows help messages of 7188x exe Alt_1 Uses PC s COM1 Alt_2 Uses PC s COM2 Alt_C Switches to command mode to change PC COM port s baudrate and data format Press ENTER to confirm the setting Press LEFT RIGHT arrow key to select different field Press Any key to switch different values Press ENTER in the last field will stop this operation Alt_D Sets the date of RTC to the PC s date Alt_T Sets the time of RTC to the PC s time Alt_E For downloading files into memory Only after the message Press ALT_E to download file is shown on screen can users press Alt_E Alt_L Switches normal line mode In line mode all characters pressed will not send to COM until the ENTER is pressed It is designed for testing the 7000 series Alt_X Quits 7188X EXE F2 Sets the file name for download without download operation Alt_F2 Sets multiple filenames for download 10 files maximum If set less then 10 files add to end Ctrl_F2 Shows COM1 amp COM2 messages for easily COM port testing Press ALT_X to return to the or
55. ndently The UserLoop describes above acts as a typical emergency event control application 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 93 Demol12 Scan time evaluation Part of the explanation head 19c 19C gt clear count value 19r 19R gt read count value UserLoopFun will increase count value every scan loop PC can read how many scan loops after clear count value So user can use this demo to test the Xserver s performance Hardware 7188E Part of the program body unsigned long cnt void UserInit void cnt 0 void UserLoopFun void cnt int UserCmd unsigned char Cmd unsigned char Response int i j if Cmd 0 Not Null command 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 94 switch Cmd 0 case c 19c 19C gt clear case C cnt 0 break case r 19r 19R gt read count case R break default return 0 Command Error sprintf Response d cnt return count value return 1 return OK return 0 return ERROR Demol14 Controls 7 SEG LEDs Part of the explanation head 1912345 19abcde gt Show 5 digits to 7 SEG LED Show5DigitLed Show5DigitLedWithDot can show 5 digits to 7 SEG LEDs The two functions can show 0 9 a pa f Hardware 7188E 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 95 Part of the p
56. ntrollers have 3 typical applications Virtual COM Ethernet I O and web server implementation These applications use different firmware and program styles Users can choose any of the 3 applications they prefer Using the Virtual COM application one PC can control 256 COM ports including real COM ports The VxComm firmware will turn your 7188E into a RS 232 to Ethernet Internet converter Using the Ethernet I O and Web Server applications users can program the firmware of the 7188E Xserver Web server Application m M a a a i 5 Ar E VxComm Esede Virtual COM l l l TCP IP TCP UDP l Program l l Browser JE Netscape DEA Web server Device Firmware a ee en en Vxcomm I O expansion Board Xserver Web server 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 4 1 1 1 Virtual COM application Ethernet 10M Expansion board of the POPPI PIII i 7 188E IP 1 are mapped g pm to COM3 of PC 1 LUM OOO a COM1 COM2 of the 7188E 7188E IP 1 are mapped IP 1 r ee g to COM4 COMS of 7000 01 7000 FF COM2 V xComm Driver To use the Virtual COM application first install the VxComm Driver After installation the VxComm Utility can map any 7188E s remote COM port These vi
57. o check whether the IP address is already listed in the server window left hand window Default is automatically checked The following window pops up if IP address is duplicated xl AN This IP has been used Check Server option Enable this option to connect to the 7188E 8000E and get the device s name before adding to the server window left hand window Default is automatically checked The following window pops up if host server fails to connect 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 30 x AN Check Server Failure Timeout ms field This timeout value is used for Connecting disconnecting and sending receiving data in the VxComm Utility and is used for Connecting and Disconnecting in the VxComm Driver Command Port field By default the Command Configuration TCP port is 10 000 If you change the setting of 7188E 8000E then you must assign the correct one in this field to let the VxComm Utility and Driver to get access to the device Step 4 The following window pops up if you uncheck the Check Server option before pressing the Add Server button Please choose a suitable Model Number of 7188E 8000E and then click the OK button xl Please select the correct product model number Cancel Model Number Step 5 Select one of the 7188E 8000E devices and configure the virtual COM port s by double clicking Port1 or Port2 Port7000 is reserved 7188E Series S
58. oards a 7 Seg LED or other relevant products The advantages of the Xserver 1 We design maintain update the Xserver for all users 2 Xserver can be easily modified through the use of general development tools such as TC BC MSC All relative libraries are coded in C language 3 High running speed The original Xserver Demo4 exe can run about 750 scan loops per second version 2 6 14 4 Most program code of the Xserver is finished Ethernet Internet communication and program loop control are all finished in VxComm lib 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 6 This vastly reduces user s developing time To modify Xserver users need only to modify the 6 functions The command protocol is designed to fit most of the 7188E s requirements Users can develop and extend their private command protocol very easily It supports multi clients The Xserver can handle a maximum of 30 N connections simultaneously with N being the number of the 7188E s COM ports 9 Auto wake up option The Xserver will check on packet timeouts If the software crashes the Xserver will wake itself up automatically 10 The Xserver demos TC BC MSC and Client demos VB VC are included ee 1 1 3 Web server application With the help of Web server users are able to use standard browsers such as IE or Netscape to access the I Os of the expansion boards or devices connected to any of the 7188E s COM port 00k w
59. ocated on 7188e Tcp VxCommi driver pc 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 28 3 3 Adding a 7188E 8000E server and configuring the VxComm Driver 7188E 8000E s default IP address is 192 168 255 1 Stepl Obtain the IP address of the 7188E 8000E Either 7188x exe 7188xw exe or Configure wizard can help you in obtaining the IP address of the 7188E 8000E Refer to Sec 3 of 7188E hardware user s manual for information regarding the use of these three tools Step 2 Select the VxComm Utility gt fF Accessories d B Development Kits Documents 5 Microsoft Visual Studio 6 0 InstallShield PackageForTheweb 2 Settings gt 3 AlAPI Network gt an LA Search gt DAQPro gt 4 3 PCDiag Eea iy Uninstall xComm EX xComm Help xComm Utility G SendTcp EY SendTcp Help l 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 29 Step 3 Enter the IP address of the 7188E 8000E server and press the Add Server Button lt a xComm Utility v2 07 00 Sep 10 2003 x 7188E7 8000E Internet Ethernet Controller M Check Duplicate M Check Server IP 10 10 34 11 Timeout ms 5000 g Add Server Command Part iooo0 E Import Export Port COM Config YxComm Devices Exit x Pemove Server server Options Status Note Check Duplicate option Enable this option t
60. of signal stay at high unsigned low_width width of signal stay at low char now old void UserInit void up_t 0 down_t 0 if inportb 0 amp 1 old 1 initial DIO is High else old 0 initial DIO is Low 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 97 void UserLoopFun void VxComm exe will call this function every scan time now inportb 0 amp 1 read DIO if now old DIO signal changed if now 1 Low become High up_t TimeTicks low_width up_t down_t High become Low down_t TimeTicks high_width down_t up_t old now char cVal 80 int UserCmd unsigned char Cmd unsigned char Response user s command interpreter refer to all demo if Cmd 0 Not Null command sprintf c Val High ld Low ld Now d high_width low_width now strcpy Response c Val return High and Low time return 1 return OK return 0 return ERROR 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 98 Demol18 Reads I 7000 series module s ID Part of the explanation head 19 gt Any command will be accepted This demo shows how to communication with the 7000 series which are connected to COM2 of the 7188E Hardware 7188E any 7000 series module whose address is 01 baudrate is 9600 checksum is disable Part of the program body char cStr 9 Receive data from 7000 017
61. oftware User s Manual 2004 v2 1 7MS 003 21 31 amp VxComm Utility v2 07 00 Sep 10 2003 7168E 8000E Internet Ethernet Controller M Check Duplicate M Check Server IP 10 10 34 11 Timeout ms B000 amp Add Server Command Port rocco i Import Export xComm Devices 7188E5 10 10 34 11 Port 000 UnMap Fixed Part 1 UnMap Dynamic Part2 UnMap Dynamic Part3 UnMap Dynamic Port 4 UnMap Dynamic Part5 UnMap Dynamic Server Options xX Remove Server Status 7 88E5 1 0000 v3 0 10 01 72172003 connected Another example when adding the 8430 at IP address 10 10 34 12 VxComm Utility v2 07 00 Sep 10 2003 7188E 8000E Internet Ethernet Controller M Check Duplicate M Check Server Ip 10 10 3412 Timeout ms 5000 G Add Server Command Part rocco E Import Export V xComm Devices Port COM Config 7188E5 10 10 34 11 Port 7000 UnMap Fixed 8430 10 10 34 12 Port UnMap Dynamic Port3 UnMap Dynamic Server Options Xx Remove Server Status 7188E5 10000 v3 0 10 01 21 2003 connected Step 6 Select an appropriate COM port number and then click the OK 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 32 button Port Mapping x Select COM coma K zossign rollowing VM humber sequentally Cancel M Use 7188E 8000E current setting Fixed Config Baud rate data format cannot be changed
62. ost Conversely if you cannot Telnet or FTP to a host Ping is often the starting point to determine what the problem is Packet The unit of data sent across a physical network It is consisted of a series of bits containing data and control information including source and destination node host address formatted for transmission from one node to another Socket Each TCP segment contains the source and destination port number to identify the sending and receiving application These two values along with the source and destination IP address in the IP header uniquely identify each connection The combination of an IP address and a port number is called a socket 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 104 16 17 Clients and Servers The client server paradigm uses the direction of initiation to categorize whether a program is a client or server In general an application program that initiates peer to peer communication is called a client End users usually invoke client programs when they use network services Most client program consists of conventional application program develop tools Each time a client program executes it contacts a server sends a request and awaits a response When the response arrives the client program continues processing Client programs are often easier to develop than servers and usually require no special system privileges to operate By comparison a server
63. osts using 48 bit MAC address Internet Physically a collection of packet switching networks interconnected by gateways along with TCP IP protocol that allows them to perform logically as a single large and virtual network Internet recognizes hosts using 32 bit IP address TCP IP Transmission Control Protocol TCP and Internet Protocol IP are the standard network protocols They are almost always implemented and used together and called TCP IP TCP IP can be used to communicate across any set of interconnected network TCP Transmission Control Protocol TCP provides a reliable flow of data between two hosts It is connected with things such as dividing the data passed to it from applications into appropriately sized chunks for the network layer below acknowledging received packets setting timeouts to make certain that the other end acknowledges packets that are sent and so on UDP User Datagram Protocol UDP provides a much simpler service to the application layer It just sends packets of data from one host to the other But there is no guarantee that the packets reach the destination host Gateway Computers that interconnect two networks and pass packets form one to the other are called Internet Gateways or Internet Routers Gateways route packets are based on destination network not on destination host 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 102 7 IP Internet Protoco
64. pplications S TCP IP Protocol Driver lt gt Unknown device Step 5 Right click the mouse button on the Ynsernet item and select the ARA menu item Disable Other device Uninstal F Ports COM 8 He Sound video Scan for hardware changes H E Storage Properties H System device Universal Serial Bus controllers 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 50 Step 6 Check if it shows the message This device is working properly If the driver does not work properly please remove it and then re install and configure it again Ynsernet Properties 2 x General Driver S Ynsernet Device type Non Plug and Play Drivers Manufacturer Unknown Location Unknown Device status This device is working properly Ifyou are having problems with this device click Troubleshooter to start the troubleshooter Troubleshooter Device usage Use this device enable v OK Cancel Problem Client programs open the COM port with success but fail to access the device Check Check the device s power supply and wiring RS 232 RXD TXD RS 485 D D GND 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 51 3 FAQ Q A Q Which modules are supported by VxComm Driver PC 7188EA 7188EX 7188E1 7188E8 8430 8431 8830 and 8831 after version 2 0 0 Beta 6 VxComm Driver PC
65. r E ICPDAS 7188x Win32 version 1 06 7188x for WIN32 version 1 06 07 11 2001 By ICPDAS Tsai Kun Ting Current set Use COM 115200 N 8 1 AutoRun vcom3001 exe Current work directory F 7188Xw xxx Change to use COMH xxx abckkkkeeekk jaskkkkkkkkkkkkkkkkkk jkj jkjkjkjlkeieieieieleleleliiiuuuuu E Example 2 Close Loop Testing Step 1 Make sure the is working in mode Please refer to sec 4 2 3 Options of command line File Edit Format Help yvceom3001 ST300 m0 1 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 42 Step 2 Build connection as follows Real COM Path 1 Step 3 Run Send232 and then open PC s COM 1 O CAD Release 9 53 ANAP Network 3 Ieg E Send TCP help 3 HyperSnap DX seniTcr Fs PCDiag gt T Uninstall PC Diag r v BAY Y v v Send232 2 0 1 COM1 COM status Send string with com z 9600 F None C LF_CR n MGA i CLF A String Interval 500 Set Send Send Receive Exit Program 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 43 Step 4 Virtualize 7188E 8000E s COM1 to become PC s COM4 by using the VxComm Utility Step 5 Run another Send232 and open PC s virtual COM4 Step 6 Type COM1 in left hand window and press Send Data will be sent from PC s COM1 through Path to 7188E 8000E s COM1 and immediately returned through Pat
66. rogram body extern int bLedControl key variable 0 disable LED control Xserver will not show default information on LED 1 enable LED control Xserver will show default information on LED void UserInit void Init5DigitLedQ bLedControl 0 char cLED 6 int UserCmd unsigned char Cmd unsigned char Response user s command interpreter int i set default LED char is blank for i 0 1 lt 5 41 cLED iJ 16 strcpy cLED Cmd forG 0 1 lt 5 1 if CLED i gt 0 amp amp cLED i lt 9 cLED i cLED i 0 if CLED i gt a amp amp cLED i lt f cLED i cLED i a 10 if CLED i gt A amp amp cLED i lt F cLED i cLED i A 10 if CLED iJ cLED i 16 if CLED 1 cLED i 17 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 96 if CLED iJ cLED i 18 Show5DigitLed i 1 cLED i strcpy Response Cmd return 1 Demol17 Pulse width measurement Part of the explanation head 19 gt Any non null command will be accepted This demo is similar to demo13 to detect signal change and measure signal width Hareware 7188EA or 7188EX D I expansion board Note Base address of 7188EA s DI is 1 Part of the program body unsigned long up_t timetick of signal from low becomes high unsigned long down_t timetick of signal form high becomes low unsigned high_width width
67. rt 000 TCP Port a999 Reserved Notes Keep Alive Time ms field After connecting to the 7188E 8000E the VxComm Driver will automatically and periodically send commands to keep the 7188E 8000E alive The timer will be reset after each send receive command data success The Keep Alive mechanism won t work until the next timeout The default setting of Keep Alive time is about 7000 ms It s recommended setting is 7188E 8000E s System Timeout 1 3 or smaller value Connection Broken ms field The VxComm Driver will try to re connect if the connection is broken When the client is sending a message to the 7188E 8000E the internet TCP IP layer may respond with a Disconnect event to the VxComm Driver if it fails to send the message after 20 seconds or more Users can set a smaller Connection Broken time for example 10000 ms 10 seconds to force the VxComm Driver to re connect again and get a quicker response If the connection has no sending receiving signal before the Connection Broken time has timed out the connection will be marked as broken The VxComm Driver will also re connect it again Thus the Keep Alive Time should be smaller than the Connection Broken time to make the connection come on line Note VxComm Driver 98 does not support the auto reconnection mechanism yet The default System Timeout STxxx value of the 7188E 8000E is about 300 seconds After client programs have connected to the 7188E 8000E clien
68. rtualized COM ports can be used by the PC to control devices directly just as you would use COM real COM port to control devices When using the Virtual COM application one PC can use a maximum of 256 COM ports Users need not worry about network connections The VxComm Driver will handle all Ethernet Internet connections IP n g cer 7000 01 7000 FF The advantages of VxComm 1 Users can upgrade their systems to the Ethernet Internet with increased ease as program code needs no modification 2 The internal firmware of 7188E supports multiple clients One 7188E can handle a maximum of 30 N socket connections simultaneously with N being the number of the 7188E s COM ports For example If one PC uses two virtual COM ports connected to COM ports of one 7188E2 the 7188E2 allows a maximun of 14 PC connections 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 5 1 1 2 Ethernet I O application TCP UDP Application Program Ethernet 10M Port 502 Port i2 Port 9999 Port i 1 Port 10000 Port i 1 Port 10001 Port i 1 Port 10002 Port i 2 7000 01 7000 FF Port 502 Port j 2 XServer Port 9999 Port j 1 Port j 1 7188E a Port 10002 Port j 2 nae nm 7000 01 7000 FF The Xserver is a powerful program designed for Ethernet I O applications It supplies the 7188E with a range of flexible options Users can modify the Xserver to control all of the 7188E s hardware COM ports I O expansion b
69. s Default 100 ms xxx 0 disable option T Sets the CTS control mode nnnnn depends on the setting value and FCnnnnn represents COM1 5 respectively vV3 0 07 and above n 0 3 please refer to parameters of command 28 for more details Sets the RTS control mode nnnnn depends on the setting value and FRnnnnn represents COM1 5 respectively vV3 0 07 and above n 0 3 please refer to parameters of command 28 for more details Sets the terminal character When the last character of the receiving data matches the terminal character the receiving data will be returned immediately Ehh hh is a hexadecimal value The default v00 Snd above value is 0 EX 0x0A is set as EOA OxFF is set as EFF 0 denotes no terminal character Changes the command port default is PS 10000 If Command Port 10000 is changed v3 0 09 07 23 2003 to 200 the TCP IP mapped COM port will be or later 201 208 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 59 The Command port and each TCP IP mapped COM port only allows one TCP IP v3 0 09 10 29 2003 al connection Other connection will not be or later accepted Adds the LO command to the command line allowing LED5 to be disabled enabled LO v3 0 09 or later It economizes the running time for no 5DigitLed modules IZ This command is used to set ACK delay 3 2 0 03 24 2004 or DAR time 2004 04 19 Defalut 1000 ms later IY The command is used for 8KE4 8KE8 3 2 0 2004
70. s gt 3 AlAPI Network gt e Search gt DAQFro b a 7188e J G PCDiag 2 Help M fa xComm gt T UnInstall xComm Bie 2 vxComm Help xComm Utility Cy Shut Down S SendTcp EY SendTcp Help a su Hbake Step 2 Click the server name you want to remove and press the Remove Server button x 7188E 8000E Intemet Ethemet I Check Duplical IV Check Serve IF ddress 192 168 255 1 Add Server z Pot COM__ Status 7188E4 192 168 255 1 Port 1 0 COM10 Available Port 1 COM11 Available Port 2 COM12 Available Port 3 COM13 Available Port 4 COM14 Available a Server Options Status 4 XM Remove Server 7188E4 v3 0 01 11 19 2001 connected 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 37 Step 3 The following window will pop up please make sure of your choice and press the Yes button to remove it Server 7188E4 192 168 255 1 Are you sure to remove this server lt a Step 4 Press the OK button to finish this utility x 7188E 8000E Internet Ethernet IV Check Duplical V Check Serve IP Address 192 168 255 1 Add Server YxComm Devices Server Options x Remove Server Status 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 38 3 5 Uninstalling the VxComm Driver Step 1 Select the UnInstall VxComm wr Pro
71. ses PC s COM6 Alt_7 Uses PC s COM7 Alt_8 Uses PC s COM8 Alt_9 Uses PC s COM9 Alt_A Switches between normal mode and ANSI Escape code support mode Alt_C Switchs to command mode Supports commands b sets new baudrate of PC s COM ports c Uses PC s COM n e o sets parity to none even odd 5 6 7 8 sets data bits to 5 6 7 8 p sets PC s working directory q quits command mode 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 15 Alt_D Sets the date of RTC to the PC s date Alt_T Sets the time of RTC to the PC s time Alt_E For downloading files into memory Only after the message Press ALT_E to download file is shown on screen can users press Alt_E Alt_H Switches Hex ASCII display mode Alt_L Switches normal line mode In line mode all characters pressed will not send to COM until the ENTER is pressed It is designed for testing the 7000 series Alt_X Quits the 7188X EXE F2 Sets the file name for download without download operation F5 Runs the program specified by F2 and arguments set by F6 Alt_F5 Runs the program stored in SRAM F6 Sets the arguments of the execution file set by F2 10 arguments maximum If set less than 10 arguments add to end Ctrl_F6 Clears screen F8 F8 F9 F5 F9 Downloads the file specified by F2 into FLASH memory Alt_F9 Downloads all files specified by ALT_F2 into FLASH
72. t call AddUserTimerFunction in UserInit to let the Xserver call the UserCount period Longest time interval is 65 535 seconds 2 16 1 ms See Demo9 gt UserCmd Cmd Response Xserver executes this function when client program sends the command 19 to port 10000 of the Xserver This command is defined in UserCmd function by users When the Xserver receives packets from port 10000 the Xserver checks the data If the data begins with 19 the Xserver trims 19 and passes the other data not including 19 to be the first parameter Cmd of function UserCmd User can define his own command protocol in UserCmd For example define lt 19 Read Write 1 address 4 value 2 gt to replace command 17 and 18 then one can send 19RO3f8 to read values form address 03f8 sends 19W03f85a to write 5a to address 03f8 Users can decide whether or not any other characters are needed between parameters Any command protocol format will be accepted because it is user defined At the end of UserCmd copy the results to the second parameter Response 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 64 Then the XServer will send the string to the Client program by port 10000 See Demo4 VcomUserBinaryCmd TCPREADDATA p Xserver executes this function when client program sends command 23 to port 1000 of the Xserver This function is similar to UserCmd When the client program sends command 2
73. the program files If you want to review or change any settings click Back If you are satisfied with the settings click Next to begin copying files Current Settings Installing PC diagnostic tools listed below 1 Configure Wizard version 1 0 0 2 Send232 version 2 0 0 3 SendT cp version 1 13 4 7188e Package version 1 0 1 21 Nov 2001 fe Accessories gt Fn Development Kits A A Documents ff Microsoft Visual Studio 6 0 gt amp Settings g InstallShield PackageForThewWeb 2 AlAPI Network a Search gt pagrra g Fs 7188e ALEE z Configure wizard gt l Send232 EX SendTCP help sendep T Uninstall PC Diag 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 12 1 4 Software Utilities 1 4 1 7188X EXE Utility for Host PC The utility program 7188X EXE can be used as follows Downloads user s programs from host PC into 7188 7188X 7188E and 8000 families Shows debug string to monitor of host PC Three standard output libraries Putch Print amp Puts will allow main control unit to send output string to monitor of Host PC Monitor of host PC 7188X 7188E 8000 RS 232 Test 123 AN 115200 N81 Print nTest 123 Host PC COM1 2 Run 7188X EXE Keys in test data from keyboard of host PC Three standard input libraries Getch Scanf amp LineInput will allow main control unit to read keyboard fro
74. tion All simple demos Full features demo All simple demos SendCmd Sends command data to 7188E2 All simple demos Sends command data to 7188E2 s COM SendCom port Client programs are located at 7188e TCP Xserver 7188E2 7188E3 7188E3 Full features demo All simple demos Aad More client programs Client programs are located at 7188e TCP Xserver 7188E3 7188E4 71 7188E4 Full features demo features demo All All simple demos demos More client programs Client programs are located at 7188e TCP Xserver 7188E4 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 69 7188EA 71 7188EA D I O DilOoperation All All simple demos demos More client programs Client programs are located at 7188e Tcp Xserver Client Module 7188EA Common clients Client Used to test all Used to test all simple Xserver demos _ Xserver demos All Alldemos Client2 Sends 19 0 men gelay n ms and Demo12 send command 19 1 Similar to Client1 just adds sending string with CR function Sends period step function signals to olens I O port of the 7188E DarmoN CheckValue main functions 1 Catches below errors a Winsock error CheckValue b Receive data from Xserver timeout 2 Checks received data out of range 3 Automatic reconnect ability Client4 All demos Demo22 Demo25 or demos which return value total 7 characters CheckString with main functions 1 Catch
75. ts have to send command to keep the 7188E 8000E alive before it times out otherwise the 7188E 8000E will reset itself and clients will have 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 35 to reconnect to the 7188E 8000E again Users can set the Keep Alive Time and Connection Broken time to 0 to disable this mechanism The System Timeout will have to be set to 0 to disable the reset mechanism Connect Timeout ms field The timeout value will be passed into MS TCP IP driver for reference when connecting and disconnecting Command TCP Port field By default setting the 7188E 8000E use TCP port 10000 as the Command Configuration port If you change the 7188E 8000E s setting you must assign the correct one in the field So the VxComm Driver can connect to the right TCP port This TCP port is used to configure the Baud rate data format CTS RTS control mode and Break etc Port7000 Port field By default setting the 7188E 8000E use TCP port 9999 as the Port7000 port This TCP port is reserved Step9 Press the Exit button to save the settings and exit the VxComm Utility 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 36 3 4 Removing a 7188E 8000E server Step 1 Select the VxComm Utility fr Accessories gt Programs i 5 Development Kits b 4 Documents gt Microsoft Visual Studio 6 0 Fa InstallShield PackageForTheweb 2 Eh Setting
76. user s command interpreter refer to all demo int j i Val iAddr 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 88 if Cmd 0 Not Null command switch Cmd 0 case i inp command i 0 or IQ case T sscanf Cmd 1 x amp iVal inp j sprintf c Val x iVal break case o outp command O0 5A or o 0 AB case O sscanf Cmd 1 x x amp iAddr amp iVal sprintf c Val x iVal outp iAddr iVal break default return 0 return error I strcpy Response cVal return I O value return 1 return OK return 0 return ERROR Demo 7 Uses printCom1 to debug programs Part of the explanation head 19 gt Any non null command will be accepted You can use Print or printCom1 to send Debug string to PC monitor by 7188E s COM1 printCom1 is the defualt function of Xserver If you want use Print you must use DisableCom and RestoreCom to disable printCOM1 Hardware 7188E 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 89 Part of the program body int UserCmd unsigned char Cmd unsigned char Response user s command interpreter refer to all demo if Cmd 0 Not Null command printCom1 s n r Cmd Send debug string to PC monitor by 7188E s COM1 strcpy Response Cmd return 1 return OK return 0 return ERROR Demo9 Timer trigger demo Part of
77. xe for Windows NT 4 0 or gt 7188e TCP VxComm 2K VxComm K exe This document shows how to install and configure the driver correctly There are three parts to the quick start manual The first part instructs users how to install the software The second part shows how to add a 7188E 8000E server and configure a COM port Finally the third part teaches you how to for Windows 2000 Windows XP remove a 7188E 8000E server 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 24 3 1 1 Architecture The VxComm Driver creates COM port s and maps them to the COM port s of the 7188E 8000E The user s RS 232 client programs need only to change to the different COM port to access the serial devices that are allocated to the Internet or Ethernet network via the 7188E 8000E Serial 71886 Ethernet Ethernet Internet Internet Driver Internet rcp 1p Layer 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 25 3 1 2 Ports mapping Vxcomm Driver Utility supports Port 1 to Port 8 in accessing COM to COM8 of the 7188E 8000E Another Port I O is designed to access the I O boards mounted on 7188E or 8000E With the help of the VxComm Driver Utility uses can map remote COM port and I O boards to become a virtual COM port of PC One PC can control a maximun of 256 COM ports including COM1 and COM2 PC r 71 on COM COM o Poti o 1 COM a a a COM Pot3
78. zes 7188E2 3 Recognizes 7188E3 v3 0 0 and above 1 4 Recognizes 7188E4 v3 0 0 and above 15 Recognizes 7188E5 v3 0 0 and above 8 Recognizes 7188E8 v3 0 0 and above X Recognizes 7188EX v3 0 0 and above A Recognizes 7188EA v3 0 0 and above Multi echo mode Echoes data from the 7188E 8000E COM MO ports to each client connected to the 7188E 8000E It s the default mode in 7188E firmware Single echo mode Echoes data from the 7188E 8000E COM ports to the specific client requested the service It s default mode in the Xserver program M1 v2 6 12 and above Sets the timeout value for building a socket connection If the timeout expires Vxcomm exe Xserver releases the connection Xxx timeout Time unit sec Default 0 xxx 0 disables option W Wxxx Sets the system timeout value between two packets sent from the network to 7188E 8000E If the timeout expires Vxcomm exe Xserver will automatically STxxx 7188E Series Software User s Manual 2004 v2 1 7MS 003 21 58 reboot system itself XXX timeout Time unit sec Default 0 xxx 0 disable option ST Sets a timeout value for the interval between the completion of a command being sent from the 7188E 8000E to the COM ports and the start of the data being received from the COM port If the timeout Acts in M1 Single PDO expires Vxcomm exe Xserver gives up this echo mode data Time unit m

I-7188E Software Manual

Contents

Download Pdf Manuals

Related Search

Related Contents