西門子S7-200系列PLC PPI協(xié)議及PPI動態(tài)鏈接庫DLL(需VB、Delphi DEMO程序請回貼并留下Emial地址)
一、西門子S7-200系列PLC PPI協(xié)議動態(tài)鏈接庫DLL(以下簡稱DLL)，是為滿足工業(yè)通信需要，針對工業(yè)領域要求上位機對西門子S7-200系列
PLC實時采集與控制的組態(tài)編程而設計。本DLL是采用Delphi語言開發(fā)的標準串口通訊庫，具有以下特點：
1)、實時性、可靠性好，可根據(jù)通信數(shù)據(jù)量自行調(diào)整通信時間;
2)、適用于多PLC聯(lián)網(wǎng)和上位機通信，滿足多方面的需要;
3)、函數(shù)接口功能全，操作簡單;
4)、附加實用轉(zhuǎn)換與讀取函數(shù)，易于快速開發(fā)(VC等非RAD開發(fā)環(huán)境的開發(fā))；
5)、支持USB、PC擴展卡等擴展串口號;
6)、支持多種操作系統(tǒng)win9x/win2000/winXP(標注Win32 DLL);
7)、可在多種編程環(huán)境下使用，例如VB、VC、Delphi等開發(fā)環(huán)境。
二、PPI協(xié)議簡介及S7-200CPU內(nèi)存地址范圍介紹
2.1 西門子PPI通訊協(xié)議
通過硬件和軟件偵聽的方法，分析PLC內(nèi)部固有的PPI通訊協(xié)議，然后采用上位機編程，遵循PPI通訊協(xié)議，讀寫PLC數(shù)據(jù)，實現(xiàn)人機操作
任務。這種通訊方法，與一般的自由通訊協(xié)議相比，省略了PLC的通訊程序編寫，只需編寫上位機的通訊程序資源S7-226的編程口物理層為
RS-485結(jié)構(gòu)，SIEMENS提供MicroWin軟件，采用的是PPI(Point to Point)協(xié)議，可以用來傳輸、調(diào)試PLC程序。在現(xiàn)場應用中，當需要PLC
與上位機通訊時，較多的使用自定義協(xié)議與上位機通訊。在這種通訊方式中，需要編程者首先定義自己的自由通訊格式，在PLC中編寫代碼，
利用中斷方式控制通訊端口的數(shù)據(jù)收發(fā)。采用這種方式，PLC編程調(diào)試較為煩瑣，占用PLC的軟件中斷和代碼資源，而且當PLC的通訊口定義
為自由通訊口時，PLC的編程軟件無法對PLC進行監(jiān)控，給PLC程序調(diào)試帶來不便。
SIEMENS S7-200PLC的編程通訊接口，內(nèi)部固化的通訊協(xié)議為PPI協(xié)議，如果上位機遵循PPI協(xié)議來讀寫PLC，就可以省略編寫PLC的通訊
代碼。如何獲得PPI協(xié)議？可以在PLC的編程軟件讀寫PLC數(shù)據(jù)時，利用第三個串口偵聽PLC的通訊數(shù)據(jù)，或者利用軟件方法，截取已經(jīng)打開
且正在通訊的端口的數(shù)據(jù)，然后歸納總結(jié)，解析出PPI協(xié)議的數(shù)據(jù)讀寫報文。這樣，上位機遵循PPI協(xié)議，就可以便利的讀寫PLC內(nèi)部的數(shù)據(jù)，
實現(xiàn)上位機的人機操作功能。
西門子的PPI（Point to Point）通訊協(xié)議采用主從式的通訊方式，一次讀寫操作的步驟包括：首先上位機發(fā)出讀寫命令，PLC作出接收正確
的響應，上位機接到此響應則發(fā)出確認申請命令，PLC則完成正確的讀寫響應，回應給上位機數(shù)據(jù)。這樣收發(fā)兩次數(shù)據(jù)，完成一次數(shù)據(jù)的讀寫
(從這里可以看出PPI協(xié)議的通訊效率并不好，一次讀寫需收發(fā)兩次數(shù)據(jù)^_^)。
其通訊數(shù)據(jù)報文格式大致有以下幾類：
1)、讀寫申請的數(shù)據(jù)格式如下：
SD LE LER SD DA SA FC DASP SSAP DU FCS ED
SD:(Start Delimiter)開始定界符(68H)
LE:(Length)報文數(shù)據(jù)長度
LER:(Repeated Length)重復數(shù)據(jù)長度
SD: (Start Delimiter)開始定界符(68H)
SA:(Source Address)源地址，指該地址;
DA:(Destination Address)目標地址，指該地址;
FC:(Function Code)功能碼
DSAP:(Destination Service Access Point)目的服務存取點
SSAP:(Source Service Access Point)源服務存取點
DU:(Data Unit)數(shù)據(jù)單元
FCS:(Frame Check Sequence)校驗碼
ED:(End Delimiter)結(jié)束分界符(16H)
報文數(shù)據(jù)長度和重復數(shù)據(jù)長度為自DA至DU的數(shù)據(jù)長度，校驗碼為DA至DU數(shù)據(jù)的和校驗，只取其中的末字節(jié)值。
讀寫一般數(shù)據(jù)的功能碼為 6CH，讀CT數(shù)據(jù)、置位、復位、強制等的功能碼為 7CH，確認命令功能碼5CH。
2)、PLC接收到讀寫命令，校驗后正確，返回的數(shù)據(jù)格式為 E5H
3)、確認讀寫命令的數(shù)據(jù)格式為：
SD SA DA FC FCS ED
其中SD為起始符，為10H
SA為數(shù)據(jù)源地址
DA為目的地址
FC為功能碼，取5CH
FCS為SA+DA+FC的和的末字節(jié)
ED為結(jié)束符，取16H
4)、數(shù)據(jù)類型碼
04：S
05：SM
06：AI
07：AQ
1E: C
81：I
82：Q
83：M
84：V
1F: T
5)、讀寫功能數(shù)據(jù)命令實例
1、給寫VW3值1200
68 21 21 68 02 00 6C 32 01 00 00 00 00 00 0E 00 06 05 01 12 0A 10 02 00 02 00 01 84 00 00 18 00 04 00 10 04 B0 50 16
2、讀取IB0的數(shù)據(jù)值
68 1B 1B 68 02 00 6C 32 01 00 00 00 00 00 0E 00 00 04 01 12 0A 10 02 00 01 00 00 81 00 00 00 64 16
感興趣的朋友給你根據(jù)上述例子用串口精靈測試一下，當發(fā)送命令成功PLC返回E5，你再發(fā)送10 02 00 5C 5E 16，就可以完成一次讀寫命令。
(記得接收和發(fā)送采用16進制方式 o(∩_∩)o...哈哈)
2.2 S7-200PLC CPU內(nèi)存地址范圍(DLL所能尋址的范圍)
被存取： 類型 CPU 221 CPU 222 CPU 224 CPU 226
位(字節(jié).位) V 0.0-2047.7 0. 0-2047.7 0.0-5119.7 V 1.22 0.0-5119.7 V 1.23
0.0-8191.7 V 2.00 0.0-10239.7 V 2.00
0.0-10239.7 XP
I 0.0-15.7 0.0-15.7 0.0 -15.7 0.0-15.7
Q 0.0-15.7 0.0-15.7 0.0 -15.7 0.0-15.7
M 0.0-31.7 0.0-31.7 0.0 -31.7 0.0-31.7
S 0.0-31.7 0.0-31.7 0.0 -31.7 0.0-31.7
SM 0.0-179.7 0.0-299.7 0.0 -549.7 0.0-549.7
字節(jié) VB 0 - 2047 0 - 2047 0 - 5119 V 1.22 0 - 5119 V 1.23
0 - 8191 V 2.00 0 - 10239 V 2.00
0 - 10239 XP
IB 0 - 15 0 - 15 0 - 15 0 - 15
QB 0 - 15 0 - 15 0 - 15 0 - 15
MB 0 - 31 0 - 31 0 - 31 0 - 31
SB 0 - 31 0 - 31 0 - 31 0 - 31
SMB 0 - 179 0 - 299 0 - 549 0 - 549
字 VW 0 - 2046 0 - 2046 0 - 5118 V 1.22 0 - 5118 V 1.23
0 - 8190 V 2.00 0 - 10230 V 2.00
0 - 10230 XP
T 0 - 255 0 - 255 0 - 255 0 - 255
C 0 - 255 0 - 255 0 - 255 0 - 255
AIW 0 - 30 0 - 30 0 - 62 0 - 62
AQW 0 - 30 0 - 30 0 - 62 0 - 62
雙字 VD 0 - 2044 0 - 2044 0 - 5116 V 1.22 0 - 5116 V 1.23
0 - 8188 V 2.00 0 - 10236 V 2.00
0 - 10236 XP
說明：S7-200PLC的字、雙字地址和字節(jié)地址實際上是重疊的，下面做個說明如：
VB0 VB1 VB2 VB3 VB4 VB5 VB6 VB7 VB8 VB9 VB10 VB11 VB12 VB13 VB14 VB15
———— ———— ———— ———— ———— ———— ———— ————
VW0 VW2 VW4 VW6 VW8 VW10 VW12 VW14
————————— ————————— ————————— ———————————
VD0 VD4 VD8 VD12
從上例可以看出PLC中字節(jié)、字與雙字尋址的關系，當然如果你想使用VW1(VB1 VB2)、VD3(VB3 VB4 VB5 VB6)等尋址方式也是可以的，
但為了減少不必要的尋址錯誤造成程序的非法執(zhí)行建議：
字尋址時使用(V、I、Q、M等等)0、2、4、6、8、10 ……，(這從PLC的模擬量輸入/輸出(AIW/AQW)的尋址就可以看出奇數(shù)地址是不允許的)
雙字尋址時使用(V、I、Q、M等等)0、4、8、12、16、20、24 …………………………，同時還要注意字節(jié)地址尋址最好也能不重疊；
C、T區(qū)當前值讀取時的地址按實際地址0~255來。
三、DLL函數(shù)說明
1、打開串口
Function ComOpen(nport,BaudRate,DataBits,Parity,StopBits:longint;User:Pchar):longint;stdcall;
參數(shù)：nport: 打開串口號，取值為1～8，代表COM1～COM8;
BaudRate：波特率，取值為：1200、2400、4800、9600、19200、38400；
DataBits：數(shù)據(jù)位，取值為5、6、7、8；
Parity： 校驗位，取值1(代表Even)、取值2(代表Odd)、取值3(代表Mark)、取值4(代表Space)、取值5(代表None)；
StopBits：停止位，取值1(代表1位停止位)、取值2(代表2位停止位)、取值3(代表1.5位停止位)；
User:DLL授權(quán)用戶名;
返回值：長整型，操作成功返回“1”或“2”；1表示注冊授權(quán)用戶，2表示用戶未注冊；
操作不成功返回為“0”時的原因：1)、串口不存在或被占用; 2)、DLL注冊授權(quán)不正確。
注：本DLL用戶不注冊除了下面說明的功能限制外沒有其他限制，未注冊用戶請使用特定用戶名：wangjun。
注冊用戶功能上無任何限制，且將得到永久的軟件使用和更新升級服務；
使用舉例：
Delphi：ComOpen(1,9600,8,1,1,Pchar('wangjun')) , 打開COM1口。
VB：ComOpen(1,9600,8,1,1,"wangjun") , 打開COM1口。
2、關閉串口
Function ComClose(nport:longint):longint;stdcall;
參數(shù)：nport: 串口號，取值為1～8，代表COM1～COM8;
返回值：長整型，操作成功返回“1”，否則返回“0”;
使用舉例：
ComClose(1) ，關閉打開的COM1口。
3、PLC內(nèi)部元件讀取功能函數(shù)
注：PLC內(nèi)部元件與數(shù)字的對應關系(DLL中的所有函數(shù)都遵循此規(guī)定):
0 : I
1 : Q
2 : M
3 : V
4 : S
5 : SM
6 : AI
7 : AQ
8 : C
9 : T
注：下面的讀寫等PLC操作函數(shù)使用舉例都是按VB調(diào)用函數(shù)形式給出。
1)、字節(jié)元件數(shù)據(jù)讀取
Function FcnBread(nport,purpose,source,name,address,Count:longint):Pchar;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值0(代表I)、取值1(代表Q)、取值2(代表M)、取值3(代表V)、取值4(代表S)、取值5(代表SM)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Count: 讀取的字節(jié)個數(shù)，最多讀取128個但不能超出尋址范圍；
返回值：字符串數(shù)據(jù),字符串數(shù)據(jù)的終止符為"@";
使用舉例：
FcnBread(1,0,2,0,2,4),由COM1讀取PPI 2號站 數(shù)據(jù)到0號站(計算機)IB2～IB5四個字節(jié)的值，如返回值為“01FF6403@”,
則表示IB2=01, IB3=FF,IB4=64,IB5=03;
－－－－－－－－－－ －－
字符串返回序列: | 01 | FF | 64 | 03| @ |
－－－－－－－－－－ －－
返回值為16進制字符串,將返回值如上2位一組，可轉(zhuǎn)換成“0～255”間的整數(shù)值。
在讀取錯誤或不能讀取的情況下返回“Error@”
注：沒有注冊用戶不能讀取S、SM區(qū)字節(jié)值，可尋址范圍IB0~IB1、QB0~QB1、MB0~MB1、VB0~VB1；
2)、字元件數(shù)據(jù)讀取
Function FcnWread(nport,purpose,source,name,address,Count:longint):Pchar;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值3(代表V)、取值6(代表AI)、取值8(代表C)、取值9(代表T)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Count: 讀取的字個數(shù)，最多讀取64個但不能超出尋址范圍，T區(qū)讀取時不超過44個；
返回值：字符串數(shù)據(jù),字符串數(shù)據(jù)的終止符為"@";
使用舉例：
FcnWread(1,0,2,3,0,4),由COM1讀取PPI 2號站 數(shù)據(jù)到0號站(計算機)VW0～VW6四個字的值，如返回值為“006403E804B00010@”,
則表示VW0=0064, VW2=03E8,VW4=04B0,VW6=0010;
－－－－－－－－－－－－－－－－－
字符串返回序列: | 0064 | 03E8 | 04B0 | 0010 | @ |
－－－－－－－－－－－－－－－－－
返回值為16進制字符串,將返回值如上4位一組，可轉(zhuǎn)換成無符號“0～65535”或有符號“-32768 ～ +32767”間的整數(shù)值。
如果你從PLC中讀取的是有符號的數(shù)時，這個值小于等于32767，就得到你讀的實際值，例如讀到一個值“5EEE”轉(zhuǎn)換成整數(shù)24302，
則實際值=+(24302-0)=+24302;如果大于32767，例如我讀到一個值“8FC0”先轉(zhuǎn)換成整數(shù)36800，那實際值=-(36800-32768)=-4032。
在讀取錯誤或不能讀取的情況下返回“Error@”
注：沒有注冊用戶不能讀取C、T區(qū)字當前值，可尋址范圍VW0~VW8、AIW0~AIW2；
3)、雙字元件數(shù)據(jù)讀取
Function FcnDWread(nport,purpose,source,name,address,Count:longint):Pchar;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值3(代表V)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Count: 讀取的雙字個數(shù)，最多讀取32個但不能超出尋址范圍；
返回值：字符串數(shù)據(jù),字符串數(shù)據(jù)的終止符為"@";
使用舉例：
FcnDWread(1,0,2,3,0,2),由COM1讀取PPI 2號站 數(shù)據(jù)到0號站(計算機)VW0～VW6四個字的值，如返回值為“006403E804B00010@”,
則表示VD0=006403E8,VD4=04B00010;
－－－－－－－－－－－－－－
字符串返回序列: | 006403E8 | 04B00010 | @ |
－－－－－－－－－－－－－－
返回值為16進制字符串,將返回值如上8位一組，可轉(zhuǎn)換成無符號“0～4294967295”或有符號“-2147483648 ～ +2147483647”間的整數(shù)值。
如果你從PLC中讀取的是有符號的數(shù)時，這個值小于等于2147483647，就得到你讀的實際值，例如讀到一個值“5EEE8000”轉(zhuǎn)換成整數(shù)
為1592688640，則實際值=+(1592688640-0)=+1592688640;如果大于2147483647，例如我讀到一個值“8FEFC000”先轉(zhuǎn)換成整數(shù)2414854144，
那實際值=-(2414854144-2147483648)=-267370496。
在讀取錯誤或不能讀取的情況下返回“Error@”
注：沒有注冊用戶可尋址范圍VD0~VD4；
4)、位元件的狀態(tài)讀取
Function FcnBitread(nport,purpose,source,name,address,Bit:longint):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值0(代表I)、取值1(代表Q)、取值2(代表M)、取值3(代表V)、取值4(代表S)、取值5(代表SM)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Bit: 讀取的字節(jié)元件的位地址如I1.0指I1字節(jié)元件的第0位；
返回值： 長整數(shù)，返回為0表示狀態(tài)為OFF，返回為1表示狀態(tài)為ON，返回為-1表示讀取錯誤或不能讀取；
使用舉例：
FcnBitread(1,0,2,0,1,7),由COM1讀取PPI 2號站 數(shù)據(jù)到0號站(計算機)I1.7，如返回值為1，則表示I1.7=1；
注：沒有注冊用戶不可以讀取S、SM區(qū)狀態(tài)，可尋址范圍I0.0~I1.7、Q0.0~Q1.7、M0.0~M1.7、V0.0~V1.7；
4、PLC內(nèi)部元件寫數(shù)據(jù)功能函數(shù)
1)、字節(jié)元件數(shù)據(jù)寫入
Function FcnBwrite(nport,purpose,source,name,address,Count:longint;Sendstr:Pchar):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值0(代表I)、取值1(代表Q)、取值2(代表M)、取值3(代表V)、取值4(代表S)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Count： 寫入字節(jié)個數(shù)，這里1字節(jié)應寫入2位16進制字符串；
Sendstr: 給字節(jié)寫入的值，該值為2個一組的16進制字符串組其取值為00～FF(整數(shù)值為0～255)；
返回值： 長整數(shù)，操作成功返回1，不能寫入或操作錯誤返回0；
當要寫入多個字節(jié)值時依次排列即可。如給MB0與MB1寫值100和80，先將100轉(zhuǎn)成16進制字符串64、80
轉(zhuǎn)成16進制字符串50，則sendstr=6450；一次最多寫128個字節(jié)即字符串長應小于等于256;
－－－－－－－－－－ － ~ － －－－－－－
寫字符串序列如： | 00 | FF | 10 | 64 | ~ | 08 | 04 |
－－－－－－－－－－ － ~ － －－－－－－
實際字符串與位地址的數(shù)值應如下表：(將上例的字節(jié)MB0'、MB1'轉(zhuǎn)換為位地址M0.0～M1.7由下表對應，此對應也可以應用于字節(jié)讀取)
M: 0.7 0.6 0.5 0.4 0.3 0.2 0.1 0.0 1.7 1.6 1.5 1.4 1.3 1.2 1.1 1.0
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
位地址： | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
各位賦值: | 0 | 1 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 |
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
16進制串： | 6 | 4 | 5 | 0 |
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
使用舉例：
FcnBwrite(1,0,2,2,0,2,"6450")由COM1 0號站(計算機) 寫入PPI 2號站 數(shù)據(jù)MB0=64(10進制100)、MB1=50(10進制80)，操作成功返回1；
注：沒有注冊用戶不能寫S區(qū)字節(jié)值，可尋址范圍IB0、QB0、MB0、VB0；
2)、字元件數(shù)據(jù)寫入
Function FcnWwrite(nport,purpose,source,name,address,Count:longint;Sendstr:Pchar):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值3(代表V)、取值7(代表AQ)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Count： 寫入字個數(shù)，這里1字應寫入4位16進制字符串；
Sendstr: 給字節(jié)寫入的值，該值為4個一組的16進制字符串組其取值為0000～FFFF(整數(shù)值為0～65535)；
返回值： 長整數(shù)，操作成功返回1，不能寫入或操作錯誤返回0；
當要寫入多個字節(jié)值時依次排列即可。如給VW2與VW4寫值100和1000，先將100轉(zhuǎn)成16進制字符串0064、1000轉(zhuǎn)成16進制字符串03E8，
則sendstr=006403E8；一次最多寫64個字即字符串長應小于等于256;
－－－－－－－－－－ －－－－ ~ －－－－－－－－－
寫字符串序列如: | 0064 | 03E8 | 0010 | 6004 | ~ | 0008 | 0400 |
－－－－－－－－－－ －－－－ ~ －－－－－－－－－
使用舉例：
FcnWwrite(1,0,2,3,2,2,"006403E8")由COM1 0號站(計算機) 寫入PPI 2號站 數(shù)據(jù)VW2=0064(10進制100)、VW4=03E8(10進制1000)，
操作成功返回1；
注：沒有注冊用戶不能寫AQ區(qū)字值，可尋址范圍VW0；
3)、雙字元件數(shù)據(jù)寫入
Function FcnDWwrite(nport,purpose,source,name,address,Count:longint;Sendstr:Pchar):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值3(代表V)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Count： 寫入雙字個數(shù)，這里1雙字應寫入8位16進制字符串；
Sendstr: 給字節(jié)寫入的值，該值為8個一組的16進制字符串組其取值為00000000～FFFFFFFF(整數(shù)值為0～4294967295)；
返回值： 長整數(shù)，操作成功返回1，不能寫入或操作錯誤返回0；
當要寫入多個字節(jié)值時依次排列即可。如給VD0與VD4寫值10000和8000，先將10000轉(zhuǎn)成16進制字符串00002710、8000轉(zhuǎn)成16進制字符串
為00001F40，則sendstr=0000271000001F40；一次最多寫32個雙字即字符串長應小于等于256;
－－－－－－－－－－ － ~ －－－－－－－－－－－－
寫字符串序列如: | 00000064 | 00002710 | ~ | 10000008 | 04008010 |
－－－－－－－－－－ － ~ －－－－－－－－－－－－
使用舉例：
FcnDWwrite(1,0,2,3,0,2,"0000271000001F40")由COM1 0號站(計算機) 寫入PPI 2號站 數(shù)據(jù)VD0=00002710(10進制10000)、
VD4=00001F40(10進制8000)，操作成功返回1；
注：沒有注冊用戶可尋址范圍VD0；
4)、位元件的置位
Function FcnSet(nport,purpose,source,name,address,Bit:longint):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值2(代表M)、取值3(代表V)、取值4(代表S)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Bit: 置位的字節(jié)元件的位地址如S1.0指S1字節(jié)元件的第0位；
返回值： 長整數(shù)，操作成功返回1，不能置位或操作錯誤返回0；
使用舉例：
FcnSet(1,0,2,2,2,6),由COM1 0號站(計算機) 置位PPI 2號站 M2.6，如返回值為1，則表示置位成功；
注：沒有注冊用戶可尋址范圍M0.0~M0.7、V0.0~V0.7、S0.0~S0.7；
5)、位元件的復位
Function FcnReset(nport,purpose,source,name,address,Bit:longint):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值2(代表M)、取值3(代表V)、取值4(代表S)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Bit: 復位的字節(jié)元件的位地址如M1.0指M1字節(jié)元件的第0位；
返回值： 長整數(shù)，操作成功返回1，不能復位或操作錯誤返回0；
使用舉例：
FcnReset(1,0,2,3,2,6),由COM1 0號站(計算機) 復位PPI 2號站 V2.6，如返回值為1，則表示復位成功；
注：沒有注冊用戶可尋址范圍M0.0~M0.7、V0.0~V0.7、S0.0~S0.7；
5、I/Q元件的強制功能 (未注冊用戶不可使用)
注：關于強制功能，如果你再操作時給一個元件強制了值，PLC程序的正常功能將不能改變被強值元件的狀態(tài)，所以在不需要對
某個元件進行強制時請使用取消強制函數(shù)，來取消對該位的強制狀態(tài)，但取消強制狀態(tài)并不改變元件的通段狀態(tài)。
1)、位元件的強制置位
Function FcnEset(nport,purpose,source,name,address,Bit:longint):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值0(代表I)、取值1(代表Q)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Bit: 置位的字節(jié)元件的位地址如I1.0指I1字節(jié)元件的第0位；
返回值： 長整數(shù)，操作成功返回1，不能置位或操作錯誤返回0；
使用舉例：
FcnEset(1,0,2,0,0,6),由COM1 0號站(計算機) 置位PPI 2號站 I0.6，如返回值為1，則表示置位成功；
注：沒有注冊用戶不可以使用；
2)、位元件的強制復位
Function FcnEreset(nport,purpose,source,name,address,Bit:longint):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值0(代表I)、取值1(代表Q)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Bit: 復位的字節(jié)元件的位地址如Q1.0指Q1字節(jié)元件的第0位；
返回值： 長整數(shù)，操作成功返回1，不能復位或操作錯誤返回0；
使用舉例：
FcnEreset(1,0,2,1,2,6),由COM1 0號站(計算機) 復位PPI 2號站 Q2.6，如返回值為1，則表示復位成功；
注：沒有注冊用戶不可以使用；
3)、位元件取消強制
Function FcnECancel(nport,purpose,source,name,address,Bit:longint):longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
name: 取值0(代表I)、取值1(代表Q)；
address: 元件地址，取值為請參照 2.2 S7-200PLC CPU內(nèi)存地址范圍；
Bit: 取消強制的字節(jié)元件的位地址如Q1.0指Q1字節(jié)元件的第0位；
返回值： 長整數(shù)，操作成功返回1，不能復位或操作錯誤返回0；
使用舉例：
FcnECancel(1,0,2,1,2,6),由COM1 0號站(計算機) 取消PPI 2號站 Q2.6的強制轉(zhuǎn)狀態(tài)，如返回值為1，則表示取消強制成功；
注：沒有注冊用戶不可以使用；
6、PLC運行函數(shù)(該函數(shù)可在Run、Stop功能選項開關打在Run上且PLC處于停止模式時可將PLC轉(zhuǎn)換到運行模式)
Function FcnRun(nport,purpose,source:longint):Longint;stdcall;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
返回值： 長整數(shù)，操作成功返回1，不能復位或操作錯誤返回0；
使用舉例：
FcnRun(1,0,2),由COM1 0號站(計算機) 使PPI 2號進入運行模式，如返回值為1，則表示運行成功；
注：沒有注冊用戶不可以使用；
7、PLC停止函數(shù)(該函數(shù)可在Run、Stop功能選項開關打在Run上且PLC處于運行模式時可將PLC轉(zhuǎn)換到停止模式)
Function FcnStop(nport,purpose,source:longint):Longint;stdcall;
參數(shù)：
nport: 串口號，取值為1～8，代表COM1～COM8;
purpose：目標地址，取值0～126；
source： 源地址，取值0～126；(這里是PLC的相應端口的PPI站地址，PLC的地址實際是從2開始的)
返回值： 長整數(shù)，操作成功返回1，不能復位或操作錯誤返回0；
使用舉例：
FcnStop(1,0,2),由COM1 0號站(計算機) 使PPI 2號進入停止模式，如返回值為1，則表示停止成功；
注：沒有注冊用戶不可以使用；
四、DLL附加函數(shù)說明 (本段函數(shù)對未注冊用戶沒有限制，完全可以使用。)
1、串口打開狀態(tài)的讀取
Function ComTrue(nport:longint):longint;stdcall;
參數(shù)：
noprt: 串口號，取值為1～8，代表COM1～COM8;
返回值：長整型，串口成功打開返回“1”，否則返回“0”;
2、整數(shù)轉(zhuǎn)換成16進制字符串 (為VC等非RAD開發(fā)環(huán)境所增設)
Function CIntToHex(Dcint,Digits:Longint):Pchar;stdcall;
參數(shù)：
Cint: 待轉(zhuǎn)換整數(shù)，取值為（0～65535）;
Digits: 轉(zhuǎn)換的字符串位數(shù)，指定位數(shù)小于實際位數(shù)時按實際輸出;
在參數(shù)錯誤等非法的情況下返回“Error@”
使用舉例：
CIntToHex(200,2),則返回字符串“C8@”;
CIntToHex(200,4),則返回字符串“00C8@”;
CIntToHex(200,8),則返回字符串“000000C8@”;
CIntToHex(4500,4),則返回字符串“1194@”;
CIntToHex(4500,3),則返回字符串“1194@”，因為“194”不足以表示4500這個數(shù)所以按實際輸出字符串“1194@”;
"@"為字符串數(shù)據(jù)的終止符。
3、16進制字符串轉(zhuǎn)換成整數(shù) (為VC等非RAD開發(fā)環(huán)境所增設)
Function CHexToInt(CHex:Pchar):Longint;stdcall;
參數(shù)：
CHex: 待轉(zhuǎn)換字符串，取值為（0000～FFFF）;
使用舉例：
CHexToInt("03E8"),則返回整數(shù)1000;
注：在參數(shù)不正確等出錯情況下返回值為“-1”。
4、抽取(0～65535)所示整數(shù)中(0～15)某個位的值
Function CinBin(CHex,Start:longint):longint;stdcall;
參數(shù)：
CHex: 待轉(zhuǎn)換整數(shù)，取值為0～65535(0000～FFFF);
Start: 抽取的位，取值為（0～15）;
使用舉例：
CinBin(15,3),則返回值1;
CinBin(15,4),則返回值0;
CinBin(1000,6),則返回值1;
讀取MB0組合成的字節(jié)值為“FC”(252)時，要讀取M0.1的值時，則調(diào)用CinBin(252,1)返回值0表示M0.1的值為0。
注：在參數(shù)不正確等出錯情況下返回值為“-1”。
5、返回字符串Text左邊的Count個字符 (為VC等非RAD開發(fā)環(huán)境所增設)
Function CLeftStr(Text:Pchar;Count:longint):Pchar;stdcall;
參數(shù)：
Text: 字符串原型;
Count: 指定返回左側(cè)字符串個數(shù);
在參數(shù)錯誤等非法的情況下返回“Error@”
使用舉例：
CleftStr("123456", 3) = "123@";
"@"為字符串數(shù)據(jù)的終止符。
6、返回字符串Text右邊的Count個字符 (為VC等非RAD開發(fā)環(huán)境所增設)
Function CRightStr(Text:Pchar;Count:longint):Pchar;stdcall;
參數(shù)：
Text: 字符串原型;
Count: 指定返回右側(cè)字符串個數(shù)
在參數(shù)錯誤等非法的情況下返回“Error@”
使用舉例：
CRightStr("123456", 3) = "456@";
"@"為字符串數(shù)據(jù)的終止符。
7、返回字符串Text從Start開始的Count個字符 (為VC等非RAD開發(fā)環(huán)境所增設)
Function CMidStr(Text:Pchar;Start,Count:longint):Pchar;stdcall;
參數(shù)：
Text: 字符串原型;
Start: 指定返回字符串的起始位置;
Count: 指定返回字符串個數(shù);
在參數(shù)錯誤等非法的情況下返回“Error@”
使用舉例：
CMidStr("123456",2，3) = "234@";
"@"為字符串數(shù)據(jù)的終止符。
8、字符串Cstr開始于字符串Ostr的位置 (為VC等非RAD開發(fā)環(huán)境所增設)
Function Cinstr(Ostr,Ckstr:Pchar;Dcint:Longint):Longint;stdcall;
參數(shù)：
Ostr: 字符串原型;
Cstr: 查詢的字符串;
Dcint: 設定查詢字符串的起始位置,取值>=1,即最少從源字符串的第一個字符開始查詢；
返回值：長整型;
使用舉例：
CinStr("1Tfdg23456","2",2) = 6
注：在參數(shù)不正確等出錯情況下返回值為“0”。
9、PC喇叭的報警過程函數(shù)；
Function MyBeep(SoundHz:longint):longint;stdcall;
參數(shù):SoundHz:長整型;
返回值:長整型,操作成功返回“1”，否則返回“0”。
使用舉例：
MyBeep(2000); 按2000的頻率發(fā)出報警聲。
DLL中關于傳出字符串值的函數(shù)都以"@"為字符串函數(shù)值終止符，這是對多開發(fā)環(huán)境應用時方便用戶正確讀取返回字符串數(shù)據(jù)而設。
五、詳細的DLL使用請參DEMO程序或DLL手冊(DLL手冊提供VB、VC、Delphi的調(diào)用說明)，相關DEMO程序和說明所使用的開發(fā)環(huán)境
VB指的是VB6.0，Delphi指的是Delphi6.0/Delphi7.0,VC指的是VC6.0。如果使用了高版本開發(fā)環(huán)境請根據(jù)開發(fā)軟件更新后所兼容的聲明方式進行聲明調(diào)用。
作者： wjun7610
QQ： 157610979
淘寶店：
http://shop34821629.taobao.com 
滬公網(wǎng)安備31010802001143號
