modbususer.h

ZLG MINIARM-N20源代码

** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern void MB_Ini(void);


/*********************************************************************************************************
** Function name:			MB_CfgCh
**
** Descriptions:			配置Modbus管道。
**
** input parameters:		mb_ch，从机描述信息数据结构指针
** Returned value:			配置成功返回MB_NO_ERR(0)，出错返回非零值。
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern uint8 MB_CfgCh(MB_CFG *mb_ch);


/*********************************************************************************************************
** Function name:			ReceOneChar
**
** Descriptions:			接收一个字符处理
**				            要求:接收到一个字符后立即传入该函数处理。
**
** input parameters:		ch,接收到数据的管道号
**							ReceCharacter,接收到的字符
**							err,非零值表时接收字符出错，如奇偶效验出错。
** Returned value:			None
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern void ReceOneChar(uint8 ch,uint8 ReceCharacter,uint8 err);



/*********************************************************************************************************
** Function name:			MB_TmrUpdate
**
** Descriptions:			ZY/Modbus时间处理，处理T15、T13的事件和协栈状态事件。
**                          该函数需要在500uS被调用一次。
** input parameters:		None
** Returned value:			None
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/17
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern void MB_TmrUpdate(void);


/********************************************************************************************************
** Function name:			MBS_UDFCodeAdd
**
** Descriptions:			Modbus从机栈初始化用户自定义功能代码,该函数使用了动态分配内存。
**
** input parameters:		code_ptr,用户自定义功能代码结构指针
** Returned value:			正常添加自定义功能代码返回0，出错返回出错代码
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern uint8 MBS_UDFCodeAdd(SUD_FUN_CODE * code_ptr);


/********************************************************************************************************
** Function name:			MBM_UDFCodeAdd
**
** Descriptions:			Modbus主机栈初始化用户自定义功能代码,该函数使用了动态分配内存。
**
** input parameters:		request_ptr,用户自定义功能代码结构指针
** Returned value:			正常添加自定义功能代码返回0，出错返回出错代码
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern uint8 MBM_UDFCodeAdd(MUD_FUN_CODE *request_ptr);


/*********************************************************************************************************
** Function name:			MB_DataHandleFunPtr
**
** Descriptions:			该函数用于传递Modbus从机处理用户数据函数结构体指针
**
** input parameters:		dhfPtr,从机数据处理功能代码函数数据结构指针
** Returned value:			none
**         
** Created by:				ZhouLishan
** Created Date:			2006/06/06
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern void MB_DataHandleFunPtr (DATA_HANDLE_FUN  *dhfPtr );


/********************************************************************************************************
** Function name:			PutDataInPUD
**
** Descriptions:			将数据写入PDU数据,不管是RTU传输模还是ASCII，写入PDU的数据都是以16进制形式写入。
**
** input parameters:		ch,操作管首
**							*CharPtr,缓冲区指针
**							Length，缓冲区数据长度
** Returned value:			正常添加自定义功能代码返回0，出错返回出错代码
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern uint8 PutDataInPUD(uint8 ch,uint8 *CharPtr,uint16 Length);


/********************************************************************************************************
** Function name:			MB_ExitCh
**
** Descriptions:			调用该函数将释放Modbus管道占用的资源。
**
** input parameters:		ch,释放的管道号
** Returned value:			None
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern void MB_ExitCh(uint8 ch );


/********************************************************************************************************
** Function name:			ModbusPoll
**
** Descriptions:			执行该函数发报Modbus主机请求。该函数可重入
**
** input parameters:		ch,通讯管道号
**							NodeID,节点ID（设备地址）
**				 			FunctionCode，功能代码
**							ParameterPtr，参数入口
** Returned value:			err,指令执行状态
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern uint8 ModbusPoll(uint8 ch,uint8 NodeID,uint8 FunctionCode,void *ParameterPtr);

/********************************************************************************************************
** Function name:			OSModbusMServe
**
** Descriptions:			ZY/Modbus主机栈服务任务函数,基于uC/OS-II系统下使用。
**
** input parameters:		*pdata，任务参数指针，不使用。
** Returned value:			None
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern void OSModbusMServe	(void *pdata);


/********************************************************************************************************
** Function name:			OSModbusSServe
**
** Descriptions:			ZY/Modbus从机栈服务任务函数,基于uC/OS-II系统下使用。
**
** input parameters:		*pdata，任务参数指针，不使用。
** Returned value:			None
**         
** Created by:				ZhouLishan
** Created Date:			2006/05/12
**-------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
**-------------------------------------------------------------------------------------------------------
*********************************************************************************************************/
extern void OSModbusSServe	(void *pdata);




#ifdef __cplusplus
}
#endif                                                                  /*  __cplusplus                 */
#endif                                                                  /*  __MODBUSUSER_H              */

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