requestfun.h

ZLG MINIARM-N20源代码

/****************************************Copyright (c)**************************************************
**                               Guangzou ZLG-MCU Development Co.,LTD.
**                                      graduate school
**                                 http://www.zlgmcu.com
**
**--------------File Info-------------------------------------------------------------------------------
** File name:			RequestFun.h
** Last modified Date:  2006-06-06
** Last Version:		2.0
** Descriptions:		
**
**------------------------------------------------------------------------------------------------------
** Created by:			ZhouLishan
** Created date:		2006-06-06
** Version:				2.0
** Descriptions:		
**
**------------------------------------------------------------------------------------------------------
** Modified by:			
** Modified date:		
** Version:				
** Descriptions:
**
********************************************************************************************************/
#ifndef __REQUESTFUN_H
#define __REQUESTFUN_H

#ifdef __cplusplus
extern "C" {
#endif    

/*********************************************************************************************************
** Function name:			OSReadCoils
**
** Descriptions:			读取线圈值。0x01
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							StartAddress，线圈起始地址
**							Quantity，线圈数量
**							ReaValuePtr，保存线圈值的指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
 INT8U ReadCoils01(INT8U ch,
 				   INT8U ID, 
 				   INT16U StartAddress,
 				   INT16U Quantity,
 				   INT8U *ReaValuePtr);	
#define  OSReadCoils	ReadCoils01
 					 

/*********************************************************************************************************
** Function name:			ReadDisInputs02
**
** Descriptions:			读取离散输入量。0x02
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							StartAddress，离散输入量起始地址
**							Quantity，离散输入量个数
**							ReaValuePtr，保存离散输入量值的指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
 INT8U ReadDisInputs02(INT8U ch,
 					   INT8U ID, 
 					   INT16U StartAddress,
 					   INT16U Quantity,
 					   INT8U *ReaValuePtr);
#define OSReadDisInputs		ReadDisInputs02 	
				 

/*********************************************************************************************************
** Function name:			ReadHoldReg03
**
** Descriptions:			读取保持寄存器值，指令代码为：0x03。
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							StartAddress，寄存器起始地址
**							Quantity，寄存器数量
**							ReaValuePtr，保存读出寄存器值的指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
INT8U ReadHoldReg03(INT8U ch,
 					INT8U ID, 
 					INT16U StartAddress,
 					INT16U Quantity,
 					INT16U *ReaValuePtr);		// 读保持寄存器
#define OSReadHoldReg	ReadHoldReg03

/*********************************************************************************************************
** Function name:			ReadInputReg04
**
** Descriptions:			读取输入寄存器值，指令代码为：0x04。
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							StartAddress，输入寄存器起始地址
**							Quantity，输入寄存器数量
**							ReaValuePtr，保存读出输入寄存器值的指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
 INT8U ReadInputReg04(INT8U ch,
 					  INT8U ID, 
 					  INT16U StartAddress,
 					  INT16U Quantity,
 					  INT16U *ReaValuePtr);
 #define OSReadInputReg		ReadInputReg04		
 

/*********************************************************************************************************
** Function name:			WriteSingleReg06
**
** Descriptions:			写单寄存器操作。0x06
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							OutAddress，写入的地址(0x0000~0xffff)
**							 OutValue，写入的值(0x0000~0xffff)
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
 INT8U WriteSingleReg06(INT8U ch,
 						INT8U  ID,
 						INT16U OutAddress,
 						INT16U OutValue);

/*********************************************************************************************************
** Function name:			WriteSingleCoil05
**
** Descriptions:			写单线圈操作，指令代码为：0x04。
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							OutAddress，写入线圈的地址(0x0000~0xffff)
**							 OutValue，写入线圈的值COIL_OFF、COIL_ON
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
 INT8U WriteSingleCoil05(INT8U ch,
 						 INT8U  ID,
 						 INT16U OutAddress,
 						 INT16U OutValue); 			
 #define OSWriteSingleCoil	WriteSingleCoil05		 

/*********************************************************************************************************
** Function name:			WriteMultipleCoils15
**
** Descriptions:			写多线圈操作。0x0f
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							StartAddress，写入线圈的起始地址(0x0000~0xffff)
**							Quantity，写入的线圈的数量
**							*ValuePtr，写入数据的指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
INT8U  WriteMultipleCoils15(INT8U ch,
							INT8U ID,
							INT16U StartAddress,
							INT16U Quantity,
							INT8U *ValuePtr);
#define WriteMultipleCoils0f 	WriteMultipleCoils15
#define WriteMultipleCoils0F 	WriteMultipleCoils15
#define OSWriteMultipleCoils 	WriteMultipleCoils15

/*********************************************************************************************************
** Function name:			WriteMultipleReg16
**
** Descriptions:			写多寄存器操作。0x10
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							StartAddress，写入寄存器的起始地址(0x0001~0xffff)
**							Quantity，写入寄存器的数量(0x0001~0x0078)
**							*ValuePtr，写入寄存器数据的指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
INT8U  WriteMultipleReg16(INT8U  ch,
 						  INT8U  ID, 
 					 	  INT16U StartAddress,
 					 	  INT16U Quantity,
 					 	  INT16U *ValuePtr)	;
 					 	

/*********************************************************************************************************
** Function name:			MaskWriteReg22
**
** Descriptions:			屏蔽写寄存器操作。如果Or_Mask值为零，那么结果是当前内容和And_Mask的简单
**							逻辑AND（与）；如果And_Mask值为零，结果等于Or_Mask值。0x16
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							Addr，写入寄存器的地址(0x0001~0xffff)
**							And_Mask，屏蔽写与数据
**							Or_Mask，屏蔽写或数据
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
INT8U  MaskWriteReg22(INT8U  ch,
					  INT8U  ID, 
 					  INT16U Addr,
 					  INT16U And_Mask,
 					  INT16U Or_Mask);
#define OSMaskWriteReg 	MaskWriteReg22
#define MaskWriteReg16 	MaskWriteReg22
 					

/*********************************************************************************************************
** Function name:			ReadWriteMultipleReg23
**
** Descriptions:			同时写读多寄存器操作，先写入后读出。0x17
**
** input parameters:		ch,Modbus通讯管道
**							ID，从机地址
**							WStartAddr，写入寄存器的起始地址(0x0001~0xffff)
**							WQuantity，写入寄存器的数量
**							RStartAddr，读出寄存器的起始地址(0x0001~0xffff)
**							RQuantity，读出寄存器的数量
**							*DataPtr，写入寄存器的指针和读出数据存放指针
** Returned value:			完成代码：(见modbus.h文件的异常代码表)
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
INT8U  ReadWriteMultipleReg23(INT8U   ch,
						      INT8U   ID, 
 					 	      INT16U  WStartAddr,
 					 	      INT16U  WQuantity,
 					 	      INT16U  RStartAddr,
 					 	      INT16U  RQuantity,
 					 	      INT16U *DataPtr); 		
#define OSReadWriteMultipleReg 	ReadWriteMultipleReg23 					 				 
#define ReadWriteMultipleReg17 	ReadWriteMultipleReg23 					 				 

 					 				 


#ifdef __cplusplus
}
#endif                                                                  /*  __cplusplus                 */
#endif                                                                  /*  __REQUESTFUN_H              */

/*********************************************************************************************************
  END FILE
*********************************************************************************************************/