| /**
|
| *
|
| * @file commgt_api.h
|
| * @brief
|
| * This file is part of tools.
|
| * ¹¤¾ßCommAgt½Ó¿Ú¹«¹²ÉùÃ÷
|
| *
|
| * @details
|
| * @author Tools Team.
|
| * @email
|
| * @copyright Copyright (C) 2013 Sanechips Technology Co., Ltd.
|
| * @warning
|
| * @date 2019/02/02
|
| * @version 1.4
|
| * @pre
|
| * @post
|
| *
|
| * @par
|
| * Change History :
|
| * ---------------------------------------------------------------------------
|
| * date version author description
|
| * ---------------------------------------------------------------------------
|
| * 2013/01/14 1.0 lu.xieji Create file
|
| * 2018/09/24 1.1 jiang.fenglin ºË¼äͨÐŹ²ÏíÄÚ´æÓÉ1Mµ÷ÕûΪ512K
|
| * 2018/09/25 1.2 dai.kang »·Ðλº³åÇøÄÚ´æÓÉ3.5Mµ÷ÕûΪ2M
|
| * 2018/12/25 1.3 dai.kang »·Ðλº³åÇøÄÚ´æÓɾ²Ì¬·ÖÅäµ÷ÕûΪzOss_GetUB¶¯Ì¬·Ö±ð
|
| * 2019/02/02 1.4 jiang.fenglin ÐÞ¸Ä×¢ÊÍ·½Ê½Îªdoxygen
|
| * 2019/03/11 1.5 dai.kang Ö§³ÖÎïÀí²ãlog + ap<->cp logÇø¼ä¶¯Ì¬·ÖÅä
|
| * 2019/05/13 1.6 dai.kang psÓëphy¼äµÄ»·ÐÎbufferÉÏÏÂÐзֿªÉêÇ룻ap²àbuffer¿Õ¼äλÖõ÷Õû
|
| * ---------------------------------------------------------------------------
|
| *
|
| *
|
| */
|
|
|
| #ifndef COMM_AGT_H_
|
| #define COMM_AGT_H_
|
|
|
| #include "ram_config.h"
|
| #include "ZspTrace.h"
|
|
|
| #define MAX_PACKET_LEN (0x10000)
|
| #define MAX_ENCODE_PACKET_LEN (MAX_PACKET_LEN * 2)
|
|
|
| // Buffer »ùµØÖ·
|
| extern UINT32 g_zToolAgtBaseDDR;
|
|
|
| #define COMM_SEND_BUFFER_BASE_ADDR (g_zToolAgtBaseDDR)
|
| #define COMM_SEND_BUFFER_SIZE (0x77000)
|
|
|
| #define COMM_RECV_BUFFER_BASE_ADDR (COMM_SEND_BUFFER_BASE_ADDR + COMM_SEND_BUFFER_SIZE)
|
| #define COMM_RECV_BUFFER_SIZE (0x0)
|
|
|
| #define COMM_READ_BUFFER_BASE_ADDR (COMM_RECV_BUFFER_BASE_ADDR + COMM_RECV_BUFFER_SIZE)
|
| #define COMM_READ_BUFFER_SIZE (0x0)
|
|
|
| #define COMM_ENCODE_BUFFER_BASE_ADDR (COMM_READ_BUFFER_BASE_ADDR + COMM_READ_BUFFER_SIZE)
|
| #define COMM_ENCODE_BUFFER_SIZE (0x0)
|
|
|
| #define COMM_DECODE_BUFFER_BASE_ADDR (COMM_ENCODE_BUFFER_BASE_ADDR + COMM_ENCODE_BUFFER_SIZE)
|
| #define COMM_DECODE_BUFFER_SIZE (0x0)
|
|
|
| // GSM buff
|
| #define ZCAT_GSM_BUFFER_BASE_ADDR (COMM_DECODE_BUFFER_BASE_ADDR + COMM_DECODE_BUFFER_SIZE)
|
|
|
| #ifdef _USE_L1G
|
| #define ZCAT_GSM_BUFFER_SIZE (0x8000)
|
| #else
|
| #define ZCAT_GSM_BUFFER_SIZE (0x0)
|
| #endif
|
|
|
| #define COMM_ARM1_ALL_ADDR (ZCAT_GSM_BUFFER_BASE_ADDR + ZCAT_GSM_BUFFER_SIZE)
|
| #define COMM_ARM1_ALL_SIZE (0x100)
|
| #define COMM_ARM1_TICK_ADDR (COMM_ARM1_ALL_ADDR)
|
| #define COMM_ARM1_TICK_SIZE (0x4)
|
| #define COMM_ARM1_ORITIME_ADDR (COMM_ARM1_TICK_ADDR + COMM_ARM1_TICK_SIZE)
|
| #define COMM_ARM1_ORITIME_SIZE (0x4)
|
| #define COMM_ARM1_ORITICK_ADDR (COMM_ARM1_ORITIME_ADDR + COMM_ARM1_ORITIME_SIZE)
|
| #define COMM_ARM1_ORITICK_SIZE (0x4)
|
|
|
| #if ((COMM_ARM1_TICK_SIZE + COMM_ARM1_ORITIME_SIZE + COMM_ARM1_ORITICK_SIZE) > COMM_ARM1_ALL_SIZE)
|
| #error "tool ram overflow!"
|
| #endif
|
|
|
| // PS CPU <-->PHY CPU
|
| #define COMM_PS_TO_PHY_BASE_ADDR (COMM_ARM1_ALL_ADDR + COMM_ARM1_ALL_SIZE)
|
| #define COMM_PS_TO_PHY_SIZE (0x100)
|
|
|
| #define COMM_PHY_TO_PS_BASE_ADDR (COMM_PS_TO_PHY_BASE_ADDR + COMM_PS_TO_PHY_SIZE)
|
| #define COMM_PHY_TO_PS_SIZE (0x100)
|
|
|
| #define ZCAT_KERNEL_TO_CP_BASE_ADDR (COMM_PHY_TO_PS_BASE_ADDR + COMM_PHY_TO_PS_SIZE)
|
| #define ZCAT_KERNEL_TO_CP_BUFFER_SIZE (0x4000)
|
|
|
| #define ZCAT_APP_TO_CP_BASE_ADDR (ZCAT_KERNEL_TO_CP_BASE_ADDR + ZCAT_KERNEL_TO_CP_BUFFER_SIZE)
|
| #define ZCAT_APP_TO_CP_BUFFER_SIZE (0x4000)
|
|
|
| #define COMM_CP_TO_AP_BASE_ADDR (ZCAT_APP_TO_CP_BASE_ADDR + ZCAT_APP_TO_CP_BUFFER_SIZE)
|
| #ifdef CONFIG_SINGLECORE
|
| #define COMM_CP_TO_AP_SIZE (0)
|
| #else
|
| #define COMM_CP_TO_AP_SIZE (0x20000)
|
| #endif
|
|
|
| #define COMM_AP_TO_CP_BASE_ADDR (COMM_CP_TO_AP_BASE_ADDR + COMM_CP_TO_AP_SIZE)
|
| #ifdef CONFIG_SINGLECORE
|
| #define COMM_AP_TO_CP_SIZE (0)
|
| #else
|
| #define COMM_AP_TO_CP_SIZE (0x8000)
|
| #endif
|
|
|
| #define TOOL_AGENT_RAM_SIZE (COMM_SEND_BUFFER_SIZE + COMM_RECV_BUFFER_SIZE + COMM_READ_BUFFER_SIZE + COMM_ENCODE_BUFFER_SIZE + \
|
| COMM_DECODE_BUFFER_SIZE + ZCAT_GSM_BUFFER_SIZE + COMM_ARM1_ALL_SIZE + COMM_PS_TO_PHY_SIZE + \
|
| COMM_PHY_TO_PS_SIZE + ZCAT_KERNEL_TO_CP_BUFFER_SIZE + ZCAT_APP_TO_CP_BUFFER_SIZE + COMM_CP_TO_AP_SIZE + \
|
| COMM_AP_TO_CP_SIZE)
|
|
|
| /* MODEM PRINT Ä£¿é±àºÅ */
|
| #define SUBMDL_TOOLAGENT_SET (85)
|
| #define SUBMDL_ZCATAGT (SUBMDL_TOOLAGENT_SET + 0) /* ZCAT¹¤¾ß´úÀí */
|
| #define SUBMDL_TOOLCOMMON (SUBMDL_TOOLAGENT_SET + 1) /* TOOL COMMON */
|
| #define SUBMDL_COMM (SUBMDL_TOOLAGENT_SET + 2) /* ¹¤¾ßͨѶ¹ÜÀí */
|
| #define SUBMDL_NVAGT (SUBMDL_TOOLAGENT_SET + 3) /* NV¹¤¾ß´úÀí */
|
|
|
| /* ͨѶģ¿éºÅ */
|
| #define MDL_TOOLS_BASE (100)
|
| #define MDL_WINTRACE (MDL_TOOLS_BASE + 1) /* WinTrace */
|
| #define MDL_NVEDIT (MDL_TOOLS_BASE + 3) /* NvTool */
|
| #define MDL_VUART1 (MDL_TOOLS_BASE + 4) /* Virtual of Serial Comm1,used in SimEnv */
|
| #define MDL_EFSTOOL (MDL_TOOLS_BASE + 7) /* EfsTool */
|
| #define MDL_PTET (MDL_TOOLS_BASE + 10) /* ÐÒéÕ»²âÊÔ¹¤¾ß */
|
| #define MDL_ZCAT (MDL_TOOLS_BASE + 15) /* ZCAT¹¤¾ß */
|
| #define MDL_NVTOOL (MDL_TOOLS_BASE + 16) /* NvTool */
|
| #define MDL_AUDIO (MDL_TOOLS_BASE + 17) /* audio */
|
|
|
| #define MDL_SIMTH (MDL_TOOLS_BASE + 18) /* TH */
|
|
|
| /*ÓëwincommÎÕÊÖ: Ó¦´ðÊÇ·ñ¿ªÆôHDLC±àÂë*/
|
| #define COMM_HEADER_PAD_HDLC (0xAB)
|
| #define COMM_HEADER_MSG_TYPE_HDLC (0x4)
|
| #define COMM_HEADER_RESERVED_HDLC (0xBBBB)
|
| #define COMM_ACK_HDLC_READY (0x2)
|
|
|
| #ifdef _OS_WIN
|
| #define MDL_PHONE (MDL_VUART1) /* windows ·ÂÕæ»·¾³ */
|
| #else
|
| #define MDL_PHONE (1) /* ÊÖ»ú */
|
| #endif
|
|
|
| #define ZCAT_MODE_INVALID (UINT32)0
|
|
|
| typedef enum
|
| {
|
| ZCAT_MODE_AP_USB = 0xC1,
|
| ZCAT_MODE_AP_NET,
|
| ZCAT_MODE_AP_TF,
|
| ZCAT_MODE_AP_FS,
|
| ZCAT_MODE_CP_USB,
|
| ZCAT_MODE_CP_TF,
|
| ZCAT_MODE_CP_NET,
|
| ZCAT_MODE_CP_FS,
|
| #ifdef _USE_VEHICLE_DC
|
| ZCAT_MODE_CAP_FS,
|
| ZCAT_MODE_CAP_NET,
|
| #endif
|
| ZCAT_MODE_LOG_OFF
|
| } E_ZCAT_MODE;
|
|
|
| typedef enum
|
| {
|
| ZCAT_IPC_SYN = 0xA0,
|
| ZCAT_IPC_ACK,
|
| ZCAT_IPC_ESTABLISHED,
|
| ZCAT_IPC_SET_TTY,
|
| ZCAT_IPC_SET_PERIPHERAL_MODE,
|
| ZCAT_IPC_STOP,
|
| ZCAT_IPC_START,
|
| ZCAT_IPC_EXIT,
|
| #ifdef _USE_VEHICLE_DC
|
| ZCAT_IPC_ALLOC_CAP_SMLOGBUF,
|
| #endif
|
| ZCAT_IPC_READ_IRAM_ZCAT_MODE,
|
| ZCAT_IPC_SET_VEHICLE_WAKE_SIGN,
|
| } E_ZCAT_IPC_HANDSHAKE;
|
|
|
|
|
| #define COMM_AP_FD 1001
|
| #define COMM_SINGLE_CORE_FD 1002
|
| #define COMM_CP_TF_FD 1234
|
|
|
| #define ZCAT_MEM_TYPE_KERNEL 0
|
| #define ZCAT_MEM_TYPE_USER 1
|
|
|
| #define HDLC_DECODE_CONTINUE (0x00)
|
| #define HDLC_DECODE_OK (0x01)
|
| #define HDLC_DECODE_FIRST_ESCAPE (0x02)
|
| #define HDLC_DECODE_DROP (0x03)
|
|
|
|
|
| /* zcatÈ«¾ÖÐÅÏ¢ */
|
| typedef struct
|
| {
|
| int status;
|
| int peripheral_mode;
|
| char usblog_path[8];
|
| } T_ZCAT_CONFIG_INFO;
|
|
|
|
|
| // Ä£¿é»Øµ÷º¯Êý
|
| typedef VOID (*ModuleFunc)(UINT32 msgID/*ÎÞÓÃ*/, const UINT8 *buf, UINT32 msgLen);
|
|
|
| typedef enum
|
| {
|
| LINK_CONNECT, /* Á´Â·½¨Á¢ÏûÏ¢ */
|
| LINK_BREAK, /* Á´Â·¶Ï¿ªÏûÏ¢ */
|
|
|
| MAX_LINK_INFO
|
| } LINK_INFO;
|
|
|
| typedef enum
|
| {
|
| COMM_RET_SUCCESS, /* Êý¾Ý³É¹¦¼ÓÈë¶ÓÁÐ,µÈ´ý·¢ËÍ */
|
| COMM_ERR_NOTINIT, /* ·¢ËÍʧ°Ü,ͨѶ´úÀíûÓгõʼ»¯ */
|
| COMM_ERR_LINKBREAK, /* ·¢ËÍʧ°Ü,Á´Â·ÒѾ¶Ï¿ª */
|
| COMM_ERR_DATALEN, /* ·¢ËÍʧ°Ü,ÏûÏ¢ÄÚÈݳ¤¶È³¬¹ý×î´ó³¤¶È */
|
| COMM_ERR_MEM, /* ·¢ËÍʧ°Ü,ÄÚ´æ²Ù×÷ʧ°Ü */
|
| COMM_ERR_MUTEX, /* ·¢ËÍʧ°Ü,»¥³âÌå³öÏÖ´íÎó */
|
|
|
| MAX_COMM_ERR
|
| } COMM_RET;
|
|
|
| typedef enum
|
| {
|
| FUNC_RET_FAILURE,
|
| FUNC_RET_SUCCESS,
|
|
|
| MAX_FUNC_RET
|
| } FUNC_RET;
|
|
|
| // Comm½á¹¹¶¨Òå
|
| typedef struct
|
| {
|
| UINT8 msg_type; /* ÏûÏ¢ÀàÐÍ */
|
| UINT8 pad; /* Ìî³äλ */
|
| UINT16 reserved; /* ±£Áô×ֶΣ¬ÌîΪ0xAAAA */
|
| UINT8 tgt_mdl_no; /* Ä¿±ê(½ÓÊÕÏûÏ¢)Ä£¿éÄ£¿éºÅ */
|
| UINT8 tgt_submdl_no; /* Ä¿±ê(½ÓÊÕÏûÏ¢)Ä£¿é×ÓÄ£¿éºÅ */
|
| UINT8 src_mdl_no; /* Ô´(·¢ËÍÏûÏ¢)Ä£¿éÄ£¿éºÅ */
|
| UINT8 src_submdl_no; /* Ô´(·¢ËÍÏûÏ¢)Ä£¿é×ÓÄ£¿éºÅ */
|
| UINT32 buf_len; /* ÏûÏ¢Êý¾Ý³¤¶È(²»º¬ÏûϢͷ) */
|
| } T_COMM_TYPE;
|
|
|
| /* ´òÓ¡»º³åÇø */
|
| typedef struct
|
| {
|
| UINT32 capacity; /* »º³åÇøÈÝÁ¿*/
|
| volatile UINT32 readPoint; /* ¶ÁÖ¸Õë */
|
| volatile UINT32 writePoint; /* дָÕë */
|
| UINT32 symbol; /* ¿ØÖÆ¿é±êʶ·û */
|
| UINT8 buf[1]; /* ´òÓ¡»º³åÇø */
|
| } T_RINGBUFFER;
|
|
|
| typedef struct
|
| {
|
| UINT8 *buf;
|
| UINT32 bufIndex; // Ö¸ÕëÆ«ÒÆ
|
| UINT32 bufSize;
|
| } T_HDLC_BUFFER_TYPE;
|
|
|
|
|
| /**
|
| * @brief ´Ócomm»·Ðλº³åÖÐÉêÇëÒ»¿éÄÚ´æ
|
| * @param[in] size ÉêÇëµÄʵ¼ÊÓÐÓÃÊý¾ÝµÄ¿Õ¼ä´óС
|
| * @return Èç¹û³É¹¦£¬·µ»ØÄÚ´æÖ¸Õ룬·ñÔò·µ»ØNULL
|
| * @note ÉêÇëµÄÄÚ´æÖ»ÓÃÓÚcommµÄÊý¾Ý·¢ËÍ£¬É÷ÓÃ!!! \n
|
| Èç¹û·¢Ëͳɹ¦Ôò²»ÐèÊÍ·Å£»\n
|
| δ·¢ËÍ»ò·¢ËͲ»³É¹¦Ôò±ØÐëµ÷ÓÃComm_Free½øÐÐÊÍ·Å£¬·ñÔòËÀÇÌÇÌ
|
| * @see
|
| */
|
| VOID* Comm_Malloc(UINT32 size);
|
|
|
| /**
|
| * @brief ÊÍ·ÅÓÉComm_MallocÉêÇëµÄÄÚ´æ
|
| * @param[in] mem_ptr ´ýÊͷŵÄcomm»º³åÇøÖÐÄÚ´æ¿éµÄÖ¸Õë
|
| * @return void
|
| * @note
|
| * @see
|
| */
|
| VOID Comm_Free(VOID *mem_ptr);
|
|
|
| /**
|
| * @brief ZCATͨѶ¹ÜÀíÄ£¿é³õʼ»¯
|
| * @param[in] void
|
| * @return ³É¹¦·µ»ØZOSS_SUCCESS£»Ê§°Ü·µ»ØZOSS_ERROR
|
| * @note
|
| * @see
|
| */
|
| UINT32 Comm_Init(VOID);
|
|
|
| /**
|
| * @brief ZCATͨѶ¹ÜÀíÄ£¿é×¢Ïú½Ó¿Ú,
|
| * @param[in] void
|
| * @return void
|
| * @note
|
| * @see
|
| */
|
| void Comm_Release(void);
|
|
|
|
|
| /**
|
| * @brief ZCAT×ÓÄ£¿é×¢²á½Ó¿Ú \n
|
| * Ìṩ¸ø¸÷¸ö×ÓÄ£¿éµ÷Óã¬×¢²á×ÓÄ£¿éÐÅÏ¢
|
| * @param[in] submdl_no ×¢²áµÄ×ÓÄ£¿éºÅ£¬ÒѾÔÚpub_mdldef.hÖж¨ÒåºÃ
|
| * @param[in] uart_name ÕâÀïÒòΪÐèÇó±ä¸ü£¬µ¼Ö²ÎÊýuart_nameÎÞЧ,ÇëÒ»ÂÉÌîuart/0
|
| * @param[in] moduleFunc ¸÷¸ö×ÓÄ£¿é»Øµ÷º¯Êý
|
| * @return ³É¹¦·µ»ØZOSS_SUCCESS, ʧ°Ü·µ»ØZOSS_ERROR
|
| * @note
|
| * @see
|
| */
|
| UINT32 zTools_CommReg(UINT8 submdl_no, const CHAR *uart_name, ModuleFunc moduleFunc);
|
|
|
| /**
|
| * @brief ZCAT×ÓÄ£¿é×¢Ïú½Ó¿Ú \n
|
| * Ìṩ¸ø¸÷¸ö×ÓÄ£¿éµ÷Óã¬×¢Ïú×ÓÄ£¿éÐÅÏ¢
|
| * @param[in] submdl_no ½«Òª×¢ÏúµÄ×ÓÄ£¿éºÅ
|
| * @return ³É¹¦·µ»ØZOSS_SUCCESS, ʧ°Ü·µ»ØZOSS_ERROR
|
| * @note
|
| * @see
|
| */
|
| UINT32 zTools_CommUnReg(UINT8 submdl_no);
|
|
|
| /**
|
| * @brief Ìṩ¸ø²»Í¬×ÓÄ£¿éÏò"ÍâÉè"·¢ËÍÊý¾ÝµÄ¹¦ÄÜ \n
|
| * ¸øTraceAgtÄ£¿éʹÓÃ,Õâ¸öÊÇÒì²½½Ó¿Ú£¬Ö»¹Ü·¢ËͶø²»¹ÜÊÇ·ñÄܹ»ÊÕµ½
|
| * ·¢ËÍÊý¾ÝÒ»°ãÏȵ½"ͳһ»º´æ"ÖУ¬È»ºó֪ͨ·¢ËÍÏß³ÌÓÐÊý¾Ý´ý·¢ËÍ
|
| * @param[in] buf ·¢ËÍÊý¾Ý(±ØÐëÊÇÓÉComm_MallocÉêÇëµÄÄÚ´æ!!!)
|
| * @param[in] buf_len ·¢ËÍÊý¾ÝµÄ³¤¶È
|
| * @param[in] tgt_mdl_no Ä¿±êÄ£¿éºÅ£¬ÊÖ»ú»òPCµÈ
|
| * @param[in] tgt_submdl_no Ä¿±ê×ÓÄ£¿éºÅ
|
| * @param[in] src_submdl_no Ô´×ÓÄ£¿éºÅ
|
| * @return ³É¹¦·µ»ØZOSS_SUCCESS, ·ñÔò·µ»ØZOSS_ERROR
|
| * @note
|
| * @see
|
| */
|
| UINT32 zTools_SendData(UINT8 *buf, UINT32 buf_len,
|
| UINT8 tgt_mdl_no, UINT8 tgt_submdl_no, UINT8 src_submdl_no);
|
|
|
| /**
|
| * @brief ´´½¨ÐèÒªµÄ»º³åÇø
|
| * Èç¹ûbuf²»ÎªNULL£¬ÔòÔÚÖ¸¶¨µØÖ·´´½¨»º³åÇø£»·ñÔò£¬ÉêÇëÒ»¿éÄÚ´æ×÷Ϊ»º³åÇø
|
| * @param[in] buf »º³åÇøµØÖ·
|
| * @param[in] bufSize »º³åÇø´óС
|
| * @return ³É¹¦·µ»ØÖ¸Ïò»º³åÇø½á¹¹ÌåµÄÖ¸Õ룬·ñÔò·µ»ØNULL
|
| * @note
|
| * @see
|
| */
|
| T_RINGBUFFER* CreateRingBuffer(UINT8 *buf, UINT32 bufSize);
|
|
|
| /**
|
| * @brief ´´½¨ÐèÒªµÄ»º³åÇø,²¢ÇÒÖ¸¶¨±ê¼ÇλµÄÖµ
|
| * Èç¹ûbuf²»ÎªNULL£¬ÔòÔÚÖ¸¶¨µØÖ·´´½¨»º³åÇø£»·ñÔò£¬ÉêÇëÒ»¿éÄÚ´æ×÷Ϊ»º³åÇø
|
| * @param[in] buf »º³åÇøµØÖ·
|
| * @param[in] bufSize »º³åÇø´óС
|
| * @param[in] bufSize ±ê¼Çλ
|
| * @return ³É¹¦·µ»ØÖ¸Ïò»º³åÇø½á¹¹ÌåµÄÖ¸Õ룬·ñÔò·µ»ØNULL
|
| * @note
|
| * @see
|
| */
|
| T_RINGBUFFER* CreateRingBufferWithSymbol(UINT8 *buf, UINT32 bufSize, UINT32 symbol);
|
|
|
| /**
|
| * @brief Åжϻº³åÇøÊÇ·ñÓÐЧ
|
| * @param[in] ringBuf »·Ðλº³å
|
| * @return ÊÇ·µ»ØTRUE,·ñ·µ»ØFALSE
|
| * @note
|
| * @see
|
| */
|
| BOOL IsRingBufferValid(T_RINGBUFFER *ringBuf);
|
|
|
| /**
|
| * @brief ½«»º³åÇøÖÿÕ
|
| * @param[in] ringBuf »·Ðλº³åÇøÖ¸Õë
|
| * @return void
|
| * @note
|
| * @see
|
| */
|
| VOID EmptyRingBuffer(T_RINGBUFFER *ringBuf);
|
|
|
| /**
|
| * @brief ½«Êý¾ÝдÈë»·Ðλº³å
|
| * @param[in] ringBuf »·Ðλº³åÖ¸Õë
|
| * @param[in] buf Êý¾Ý»º´æÖ¸Õë
|
| * @param[in] len Êý¾Ý³¤¶È
|
| * @param[in] flags Êý¾Ý»º´æÄÚ´æÀàÐÍ£º0:ÄÚºË̬,1:Óû§Ì¬
|
| * @return ·µ»ØдÈëµÄʵ¼Ê³¤¶È
|
| * @note
|
| * @see
|
| */
|
| UINT32 WriteRingBuffer(T_RINGBUFFER *ringBuf, UINT8 *buf, UINT32 len, UINT32 flags);
|
|
|
| /**
|
| * @brief ¶ÁÈ¡Ò»¶Î»·Ðλº³åÇøµÄÊý¾Ýµ½Ä¿±ê»º´æ
|
| * @param[in] ringBuf »·Ðλº³åÇøÖ¸Õë
|
| * @param[in] buf Ä¿±ê»º´æÖ¸Õë
|
| * @param[in] len Ä¿±ê»º´æ³¤¶È
|
| * @param[in] flags Ä¿±ê»º´æÄÚ´æÀàÐÍ£º0:ÄÚºË̬,1:Óû§Ì¬
|
| * @return ·µ»Ø¶ÁÈ¡³¤¶È
|
| * @note
|
| * @see
|
| */
|
| UINT32 ReadRingBuffer(T_RINGBUFFER *ringBuf, UINT8 *buf, UINT32 len, UINT32 flags);
|
|
|
| /**
|
| * @brief »ñÈ¡µ±Ç°Ring BufferÖпÕÏÐÇøµÄ´óС
|
| * @param[in] ringBuf »·Ðλº³åÇøÖ¸Õë
|
| * @return ·µ»Ø×Ö½ÚÊý
|
| * @note
|
| * @see
|
| */
|
| UINT32 GetRingBufferSize(T_RINGBUFFER *ringBuf);
|
|
|
| /**
|
| * @brief HDLC±àÂë
|
| * @param[out] dest Ä¿±êT_HDLC_BUFFER_TYPEÖ¸Õë
|
| * @param[in] src Ô´T_HDLC_BUFFER_TYPEÖ¸Õë
|
| * @return ³É¹¦·µ»ØTRUE£»Ê§°Ü·µ»ØFALSE
|
| * @note
|
| * @see
|
| */
|
| BOOL hdlc_encode(T_HDLC_BUFFER_TYPE *dest, const T_HDLC_BUFFER_TYPE *src);
|
|
|
| /**
|
| * @brief ½«Êý¾Ý½øÐÐHDLC½âÂëÖÁÖ¸¶¨µÄµ¥ÏòFIFOÖÐ
|
| * FIFOÖ»ÄÜ´ÓÍ·(0λÖÃ)°´Õû°ü¶Á³öÊý¾Ý»ò¶ªÆú£¬½âÂëʱ°´Ë³ÐòдÈëµ½FIFO£¬
|
| * ÿÕÒµ½Ò»´ÎÕû°ü£¬Í£Ö¹Ð´È룬Ȼºó¶Á³öÊý¾Ý»òÕ߶ªÆú
|
| * ¹ý³ÌÖÐÓò»µ½readPoint£¬Ê¼ÖÕΪ0
|
| * @param[out] dest ½âÂëºó´æ´¢µÄFIFOÖ¸Õë
|
| * @param[in] src ´ý½âÂëµÄ»º´æÖ¸Õë
|
| * @param[in] len ´ý½âÂëµÄ»º´æ³¤¶È
|
| * @return ·µ»Ø½âÂëµÄʵ¼Ê³¤¶È
|
| * @note
|
| * @see
|
| */
|
| UINT32 hdlc_decode(T_RINGBUFFER *dest, unsigned char *src, unsigned int len);
|
|
|
| /**************************************************************************
|
| CommAgt¹«¹²½Ó¿ÚÉùÃ÷
|
| **************************************************************************/
|
|
|
| /**************************************************************************
|
| *Ä£¿é½ÓÊÕÏûÏ¢»Øµ÷º¯Êý
|
| *²ÎÊý˵Ã÷:
|
| * (IN)
|
| * ucLinkMsg Á´Â·×´Ì¬
|
| * LINK_CONNECT Á´Â·½¨Á¢
|
| * LINK_BREAK Á´Â·¶Ï¿ª
|
| **************************************************************************/
|
| typedef void (* LINKRPTFUNC)(LINK_INFO ucLinkMsg);
|
|
|
| /**************************************************************************
|
| *ÆÕͨ×ÓÄ£¿é(²»ÓùØÐÄÏûÏ¢ID)½ÓÊÕÊý¾Ý»Øµ÷º¯Êý
|
| *²ÎÊý˵Ã÷:
|
| * (IN)
|
| * ucSrcModNo Ô´Ä£¿éºÅ
|
| * ucSrcSubModNo Ô´×ÓÄ£¿éºÅ
|
| * pBuf ÏûÏ¢Êý¾ÝÖ¸Õë
|
| * wLen ÏûÏ¢Êý¾Ý³¤¶È
|
| **************************************************************************/
|
| typedef void (* RECVFUNC)(unsigned char ucSrcModNo, unsigned char ucSrcSubModNo, const char *pBuf, unsigned short wLen);
|
|
|
| /**************************************************************************
|
| *À©Õ¹×ÓÄ£¿é(ʹÓÃÏûÏ¢ID)½ÓÊÕÊý¾Ý»Øµ÷º¯Êý
|
| *²ÎÊý˵Ã÷:
|
| * (IN)
|
| * ucSrcModNo Ô´Ä£¿éºÅ
|
| * ucSrcSubModNo Ô´×ÓÄ£¿éºÅ
|
| * dwMsgID ÏûÏ¢±àºÅ
|
| * pBuf ÏûÏ¢Êý¾ÝÖ¸Õë
|
| * wLen ÏûÏ¢Êý¾Ý³¤¶È
|
| **************************************************************************/
|
| typedef void (* RECVFUNCEX)(unsigned char ucSrcModNo, unsigned char ucSrcSubModNo, unsigned int dwMsgID, const char *pBuf, unsigned short wLen);
|
|
|
| /**************************************************************************
|
| *ÐéÄâ´®¿ÚÄ£¿é½ÓÊÕÊý¾Ý»Øµ÷º¯Êý,ʹÓÃÏûÏ¢ID
|
| *²ÎÊý˵Ã÷:
|
| * (IN)
|
| * ucSrcModNo Ô´Ä£¿éºÅ
|
| * ucSrcSubModNo Ô´×ÓÄ£¿éºÅ
|
| * ucTarSubModNo Ä¿±ê×ÓÄ£¿éºÅ
|
| * dwMsgID ÏûÏ¢±àºÅ
|
| * pBuf ÏûÏ¢Êý¾ÝÖ¸Õë
|
| * wLen ÏûÏ¢Êý¾Ý³¤¶È
|
| **************************************************************************/
|
| typedef void (* RECVFUNCUART)(unsigned char ucSrcModNo, unsigned char ucSrcSubModNo, unsigned char ucTarModNo, unsigned char ucTarSubModNo, unsigned int dwMsgID, const char *pBuf, unsigned short wLen);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_Register
|
| * ¹¦ÄÜÃèÊö£º ÆÕͨģ¿é(²»ÓùØÐÄÏûÏ¢ID)×¢²á½Ó¿Ú(97ÓÃ)
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * linkRptFunc Ä£¿é½ÓÊÕÏûÏ¢»Øµ÷º¯Êý
|
| * (OUT)
|
| * ·µ »Ø Öµ£º VOID
|
| * ÆäËü˵Ã÷£º ûÓзµ»ØÖµ
|
| **************************************************************************/
|
| FUNC_RET Comm_Register(unsigned char ucModNo, LINKRPTFUNC linkRptFunc);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_RegisterSub
|
| * ¹¦ÄÜÃèÊö£º ÆÕͨģ¿é(²»ÓùØÐÄÏûÏ¢ID)×ÓÄ£¿é×¢²á½Ó¿Ú(97ÓÃ)
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * ucSubModNo ×ÓÄ£¿éºÅ
|
| * recvFunc ×ÓÄ£¿é½ÓÊÕÊý¾Ý»Øµ÷º¯Êý
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * FUNC_RET_SUCCESS ×¢²á³É¹¦
|
| * FUNC_RET_FAILURE ×¢²áʧ°Ü,Á½ÖÖ¿ÉÄÜÇé¿ö,Ò»ÊÇ×ÓÄ£¿éºÅÖظ´ÁË,¶þÊÇ×¢²áµÄ×ÓÄ£¿éÊýÒѾµ½×î´óÏÞ¶È
|
| * ÆäËü˵Ã÷£º Ö»ÊÇ×¢²áÔÚͨѶ´úÀíÖÐ
|
| **************************************************************************/
|
| FUNC_RET Comm_RegisterSub(unsigned char ucModNo, unsigned char ucSubModNo, RECVFUNC recvFunc);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_SendMsg
|
| * ¹¦ÄÜÃèÊö£º ÆÕͨģ¿é(²»ÓùØÐÄÏûÏ¢ID)·¢ËÍÏûÏ¢½Ó¿Ú(97ÓÃ)
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucTarModNo Ä¿±êÄ£¿éºÅ
|
| * ucTarSubModNo Ä¿±ê×ÓÄ£¿éºÅ
|
| * ucSrcModNo Ô´Ä£¿éºÅ
|
| * ucSrcSubModNo Ô´×ÓÄ£¿éºÅ
|
| * pBuf ÏûÏ¢Êý¾ÝÖ¸Õë
|
| * wLen ÏûÏ¢Êý¾Ý³¤¶È,²»ÄÜ´óÓÚMAX_COMM_LEN
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * COMM_RET_SUCCESS ·¢Ëͳɹ¦
|
| * COMM_ERR_NOTINIT ·¢ËÍʧ°Ü,ͨѶ´úÀíÉÐδ³õʼ»¯
|
| * COMM_ERR_LINKBREAK ·¢ËÍʧ°Ü,ÒòΪÁ´Â·Î´Á¬½Ó(ÓÃÓÚPC²à)»ò¶Ë¿Úδ´ò¿ª(ÓÃÓÚÊÖ»ú²à)
|
| * COMM_ERR_DATALEN ·¢ËÍʧ°Ü,ÏûÏ¢ÄÚÈݳ¬¹ý×î´ó³¤¶È
|
| * COMM_ERR_MEM ·¢ËÍʧ°Ü,ÄÚ´æ²Ù×÷ʧ°Ü
|
| * COMM_ERR_MUTEX ·¢ËÍʧ°Ü,»¥³âÌå³öÏÖ´íÎó
|
| * ÆäËü˵Ã÷£º
|
| **************************************************************************/
|
| COMM_RET Comm_SendMsg(unsigned char ucTarModNo, unsigned char ucTarSubModNo, \
|
| unsigned char ucSrcModNo, unsigned char ucSrcSubModNo, \
|
| const char * pBuf, unsigned short wLen);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_GetStatus
|
| * ¹¦ÄÜÃèÊö£º »ñȡͨѶ´úÀíÓëͨѶ¹¤¾ßµÄÁ´Â·×´Ì¬
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * FUNC_RET_SUCCESS Á´Â·ÒÑÁ¬½Ó
|
| * FUNC_RET_FAILURE Á´Â·Î´Á¬½Ó
|
| * ÆäËü˵Ã÷£º
|
| **************************************************************************/
|
| FUNC_RET Comm_GetStatus(unsigned char ucModNo);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_UnRegister
|
| * ¹¦ÄÜÃèÊö£º Ä£¿é×¢Ïú½Ó¿Ú
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * FUNC_RET_SUCCESS ×¢Ïú³É¹¦
|
| * FUNC_RET_FAILURE ×¢Ïúʧ°Ü
|
| * ÆäËü˵Ã÷£º
|
| **************************************************************************/
|
| FUNC_RET Comm_UnRegister(unsigned char ucModNo);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_UnRegisterSub
|
| * ¹¦ÄÜÃèÊö£º ÆÕͨģ¿é(²»ÓùØÐÄÏûÏ¢ID)×ÓÄ£¿é×¢Ïú½Ó¿Ú
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * ucSubModNo ×ÓÄ£¿éºÅ
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * FUNC_RET_SUCCESS ×¢Ïú³É¹¦
|
| * FUNC_RET_FAILURE ×¢Ïúʧ°Ü
|
| * ÆäËü˵Ã÷£º
|
| **************************************************************************/
|
| FUNC_RET Comm_UnRegisterSub(unsigned char ucModNo, unsigned char ucSubModNo);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_RegisterEx
|
| * ¹¦ÄÜÃèÊö£º À©Õ¹Ä£¿é(ʹÓÃÏûÏ¢ID)×¢²á½Ó¿Ú
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * linkRptFunc Ä£¿é½ÓÊÕÏûÏ¢»Øµ÷º¯Êý
|
| * (OUT)
|
| * ·µ »Ø Öµ£º VOID
|
| * ÆäËü˵Ã÷£º ûÓзµ»ØÖµ
|
| **************************************************************************/
|
| FUNC_RET Comm_RegisterEx(unsigned char ucModNo, LINKRPTFUNC linkRptFunc);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_RegisterSubEx
|
| * ¹¦ÄÜÃèÊö£º À©Õ¹Ä£¿é(ʹÓÃÏûÏ¢ID)×ÓÄ£¿é×¢²á½Ó¿Ú
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * ucSubModNo ×ÓÄ£¿éºÅ
|
| * recvFunc ×ÓÄ£¿é½ÓÊÕÊý¾Ý»Øµ÷º¯Êý
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * FUNC_RET_SUCCESS ×¢²á³É¹¦
|
| * FUNC_RET_FAILURE ×¢²áʧ°Ü,Á½ÖÖ¿ÉÄÜÇé¿ö,Ò»ÊÇ×ÓÄ£¿éºÅÖظ´ÁË,¶þÊÇ×¢²áµÄ×ÓÄ£¿éÊýÒѾµ½×î´óÏÞ¶È
|
| * ÆäËü˵Ã÷£º Ö»ÊÇ×¢²áÔÚͨѶ´úÀíÖÐ
|
| **************************************************************************/
|
| FUNC_RET Comm_RegisterSubEx(unsigned char ucModNo, unsigned char ucSubModNo, RECVFUNCEX recvFunc);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_SendMsgEx
|
| * ¹¦ÄÜÃèÊö£º À©Õ¹Ä£¿é(ʹÓÃÏûÏ¢ID)·¢ËÍÏûÏ¢½Ó¿Ú
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucTarModNo Ä¿±êÄ£¿éºÅ
|
| * ucTarSubModNo Ä¿±ê×ÓÄ£¿éºÅ
|
| * ucSrcModNo Ô´Ä£¿éºÅ
|
| * ucSrcSubModNo Ô´×ÓÄ£¿éºÅ
|
| * dwMsgID ÏûÏ¢±àºÅ
|
| * pBuf ÏûÏ¢ÄÚÈÝÖ¸Õë
|
| * wLen ÏûÏ¢ÄÚÈݳ¤¶È,²»ÄÜ´óÓÚMAX_COMM_LEN - MSG_HEADER_LEN
|
| * (OUT)
|
| * ·µ »Ø Öµ£º
|
| * COMM_RET_SUCCESS ·¢Ëͳɹ¦
|
| * COMM_ERR_NOTINIT ·¢ËÍʧ°Ü,ͨѶ´úÀíÉÐδ³õʼ»¯
|
| * COMM_ERR_LINKBREAK ·¢ËÍʧ°Ü,ÒòΪÁ´Â·Î´Á¬½Ó(ÓÃÓÚPC²à)»ò¶Ë¿Úδ´ò¿ª(ÓÃÓÚÊÖ»ú²à)
|
| * COMM_ERR_DATALEN ·¢ËÍʧ°Ü,ÏûÏ¢ÄÚÈݳ¬¹ý×î´ó³¤¶È
|
| * COMM_ERR_MEM ·¢ËÍʧ°Ü,ÄÚ´æ²Ù×÷ʧ°Ü
|
| * COMM_ERR_MUTEX ·¢ËÍʧ°Ü,»¥³âÌå³öÏÖ´íÎó
|
| * ÆäËü˵Ã÷£º
|
| **************************************************************************/
|
| COMM_RET Comm_SendMsgEx(unsigned char ucTarModNo, unsigned char ucTarSubModNo, \
|
| unsigned char ucSrcModNo, unsigned char ucSrcSubModNo, \
|
| unsigned int dwMsgID, const char * pBuf, unsigned short wLen);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_RegisterUart
|
| * ¹¦ÄÜÃèÊö£º ÐéÄâ´®¿ÚÄ£¿é×¢²á½Ó¿Ú,Ö§³ÖÏûÏ¢ID,ÕâÖ־Ͳ»ÓÃ×¢²á×ÓÄ£¿éÁË
|
| * ²ÎÊý˵Ã÷£º (IN)
|
| * ucModNo Ä£¿éºÅ
|
| * linkRptFunc Ä£¿é½ÓÊÕÏûÏ¢»Øµ÷º¯Êý
|
| * recvFunc Ä£¿é½ÓÊÕÊý¾Ý»Øµ÷º¯Êý
|
| * (OUT)
|
| * ·µ »Ø Öµ£º VOID
|
| * ÆäËü˵Ã÷£º ûÓзµ»ØÖµ
|
| **************************************************************************/
|
| FUNC_RET Comm_RegisterUart(unsigned char ucModNo, LINKRPTFUNC linkRptFunc, RECVFUNCUART recvFunc);
|
|
|
| /**************************************************************************
|
| * º¯ÊýÃû³Æ£º Comm_TaskSendToPhone
|
| * ¹¦ÄÜÃèÊö£º ±¾½Ó¿ÚÌṩ¸øÐÒéÕ»µÄ²âÊÔ¹¤¾ßʹÓÃ,Ä£ÄâÈÎÎñ¸ø·¢Ë͵ÄÈÎÎñ»Ø¸´ÏûÏ¢µÄ½Ó¿Ú
|
| * ²ÎÊý˵Ã÷£º(IN)
|
| * msg_id ·¢ËÍÏûÏ¢±àºÅ£¬Õâ¸ö¿ÉÒÔÓÉÓû§×Ô¼º¶¨Òå
|
| * buf ÏûÏ¢Êý¾ÝÖ¸Õë
|
| * buf_len ÏûÏ¢Êý¾Ý³¤¶È
|
| * tgtMdlNo Ä¿±êÄ£¿éºÅ£¬ÊÖ»ú»òPCµÈ
|
| * tgtSubMdlNo Ä¿±ê×ÓÄ£¿éºÅ
|
| * srcSubMdlNo Ô´×ÓÄ£¿éºÅ
|
| * srcTask Ô´ÈÎÎñID
|
| * tgtTask Ä¿±êÈÎÎñID
|
| * (OUT)
|
| * ·µ »Ø Öµ£º Èç¹û·¢Ëͳɹ¦£¬·µ»ØZOSS_SUCCESS,·ñÔò·µ»ØZOSS_ERROR
|
| * ÆäËü˵Ã÷£º ÎÞ
|
| **************************************************************************/
|
| unsigned int Comm_TaskSendToPhone(unsigned int msg_id, const unsigned char *buf, unsigned short bufLen, \
|
| unsigned char tgtMdlNo, unsigned char tgtSubMdlNo, unsigned char srcSubMdlNo, void * srcTask, void * tgtTask);
|
|
|
|
|
| /**
|
| * @brief ·¢ËÍÊý¾Ýµ½"ͳһ»º´æ"ÖÐ
|
| * @param[in] buf ·¢ËÍÊý¾Ý(±ØÐëÊÇÓÉComm_MallocÉêÇëµÄÄÚ´æ!!!)
|
| * @param[in] buf_len ·¢ËÍÊý¾ÝµÄ³¤¶È
|
| * @param[in] tgt_mdl_no Ä¿±êÄ£¿éºÅ£¬ÊÖ»ú»òPCµÈ
|
| * @param[in] tgt_submdl_no Ä¿±ê×ÓÄ£¿éºÅ
|
| * @param[in] src_submdl_no Ô´×ÓÄ£¿éºÅ
|
| * @return ³É¹¦·µ»ØZOSS_SUCCESS, ·ñÔò·µ»ØZOSS_ERROR
|
| * @note
|
| * @see
|
| */
|
| VOID Comm_HeaderInit(T_COMM_TYPE *commHeader, UINT32 buf_len,
|
| UINT8 tgt_mdl_no, UINT8 tgt_submdl_no, UINT8 src_submdl_no);
|
| #endif /*COMM_PUB_H_*/
|
|
|