/****************************************Copyright (c)**************************************************
**                               廣州周立功單片機發展有限公司
**                                     研    究    所
**                                        產品一部 
**
**                                 http://www.zlgmcu.com
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: OSFUNfile.h
**創   建   人: 周立山
**最后修改日期: 2005年7月29日
**描        述: MODBUS RTU 協議棧
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 周立山
** 版  本: 1.0a
** 日　期: 2005年7月29日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人: 
** 版  本: 
** 日　期: 
** 描　述: 
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
** 描　述: 
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#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