/****************************************Copyright (c)**************************************************
**                                  廣州致遠電子有限公司
**
**                                 http://www.21cm.com.cn
**
**
**--------------File Info-------------------------------------------------------------------------------
** File name:			OSFUNfile.h
** Last modified Date:  2005-01-11
** Last Version:		1.0
** Descriptions:		
**
**------------------------------------------------------------------------------------------------------
** Created by:			ZhouLishan
** Created date:		2005-01-11
** Version:				1.0
** Descriptions:		
**
**------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
** Version:
** Descriptions:
**
********************************************************************************************************/

#ifndef OSFUNFILE_H
#define OSFUNFILE_H
//*********************************************************************************
// 函數名稱：OSReadCoils
// 輸入參數：ID，從機地址
//			 StartAddress，線圈起始地址
//			 Quantity，線圈數量
//			 ReaValuePtr，保存線圈值的指針
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：讀取線圈值。0x01
//*********************************************************************************
 uint8 OSReadCoils(uint8 ID, 
 					 uint16 StartAddress,
 					 uint16 Quantity,
 					 uint8 *ReaValuePtr);	
//*********************************************************************************
// 函數名稱：OSReadCoils
// 輸入參數：ID，從機地址
//			 StartAddress，線圈起始地址
//			 Quantity，線圈數量
//			 ReaValuePtr，保存線圈值的指針
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：讀取線圈值。0x02
//*********************************************************************************
 uint8 OSReadDisInputs(uint8 ID, 
 					 uint16 StartAddress,
 					 uint16 Quantity,
 					 uint8 *ReaValuePtr);
//*********************************************************************************
// 函數名稱：OSReadHoldReg
// 輸入參數：ID，從機地址
//			 StartAddress，寄存器起始地址
//			 Quantity，寄存器數量
//			 ReaValuePtr，保存讀出寄存器值的指針
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：讀取保持寄存器值，指令代碼為：0x03。
//*********************************************************************************
 uint8 OSReadHoldReg(uint8 ID, 
 					 uint16 StartAddress,
 					 uint16 Quantity,
 					 uint16 *ReaValuePtr);		// 讀保持寄存器

//*********************************************************************************
// 函數名稱：OSReadInputReg
// 輸入參數：ID，從機地址
//			 StartAddress，寄存器起始地址
//			 Quantity，寄存器數量
//			 ReaValuePtr，保存讀出寄存器值的指針
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：讀取輸入寄存器值，指令代碼為：0x04。
//*********************************************************************************
 uint8 OSReadInputReg(uint8 ID, 
 					 uint16 StartAddress,
 					 uint16 Quantity,
 					 uint16 *ReaValuePtr);		

//*********************************************************************************
// 函數名稱：OSWriteSingleCoil
// 輸入參數：ID，從機地址
//			 OutAddress，寫入的地址
//			 OutValue，寫入的值COIL_OFF、COIL_ON
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：寫單線圈操作。
//*********************************************************************************
 uint8 OSWriteSingleCoil(uint8  ID,
 						 uint16 OutAddress,
 						 uint16 OutValue); 					 

//*********************************************************************************
// 函數名稱：OSWriteMultipleCoils
// 輸入參數：ID，從機地址
//			 StartAddress，寫入的地址
//			 Quantity，寫入的數量
//			 ValuePtr，寫入數據的指針
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：寫多線圈操作。0x0f
//*********************************************************************************
uint8  OSWriteMultipleCoils(uint8 ID,uint16 StartAddress,uint16 Quantity,uint8 *ValuePtr);

//*********************************************************************************
// 函數名稱：MaskWriteReg
// 輸入參數：ID，從機地址
//			 Addr，寫入的地址(0x0001~0xffff)
//			 And_Mask，屏蔽寫與數據
//			 Or_Mask，屏蔽寫或數據
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：屏蔽寫寄存器操作。如果Or_Mask值為零，那么結果是當前內容和And_Mask的簡單邏輯AND（與）；
//			 如果And_Mask值為零，結果等于Or_Mask值。0x16
//*********************************************************************************
uint8  OSMaskWriteReg(uint8 ID, 
 					uint16 Addr,
 					uint16 And_Mask,
 					uint16 Or_Mask);
//*********************************************************************************
// 函數名稱：ReadWriteMultipleReg2PDU
// 輸入參數：ID，從機地址
//			 WStartAddr，寫入寄存器的地址(0x0001~0xffff)
//           WQuantity，寫入寄存器的數量
//			 RStartAddr，讀出寄存器的地址(0x0001~0xffff)
//			 RQuantity，讀出寄存器的數量
//			 DataPtr，寫入寄存器的指針和讀出數據存放指針
// 輸出參數：完成代碼：(見異常代碼表)
// 功能描述：寫多寄存器操作。0x17
//*********************************************************************************
uint8  OSReadWriteMultipleReg(uint8 ID, 
 					 	uint16 WStartAddr,
 					 	uint16 WQuantity,
 					 	uint16 RStartAddr,
 					 	uint16 RQuantity,
 					 	uint16 *DataPtr); 					 
#endif