/*************************************************************************************************** * * 版权信息：版权所有 (c) 2018保留所有权利 * * 文件名称：MvInterfaceBoxDefine.h * 摘 要：视觉控制器常见定义头文件 * * 备 注：无 * ***************************************************************************************************/ /*************************************************************************************************** * * Copyright: Copyright: Copyright (c) 2018 all rights reserved * * File name: MvInterfaceBoxDefine.h * Abstract: Common definition header file of Visual controller * * Remarks: None * ***************************************************************************************************/ #ifndef MV_IO_INTERFACE_BOX_DEFINE_H__ #define MV_IO_INTERFACE_BOX_DEFINE_H__ #ifndef IN #define IN #endif #ifndef OUT #define OUT #endif #define MV_SERIAL_BUF_LEN 1024 //ch:串口buffer长度 | en : Serial buffer length #define MV_SERIAL_RECVBUF_MAXLEN (1024*1024) //ch:一次性接收串口数据的最大值 | en:Max value of received data at one time // 用于区分命令类型 typedef enum MVCL_CTRL_TYPE__ { CTRL_INPUT_LEVEL = 0x00, // ch:获取输入口高低电平信息 |en: Get high and low level information of input port CTRL_RESET_PARAM = 0x01, // ch:恢复默认参数值 |en: Restore default parameter values CTRL_VERSION_INFO = 0x02, // ch:获取版本信息 |en: Get vision information CTRL_PATTERN_SET_INFO = 0x03, // ch:获取模式信息 |en: Get mode information CTRL_INPUT_SET_INFO = 0x04, // ch:获取IO输入口设置信息 |en: Get IO input port setting information CTRL_OUTPUT_SET_INFO = 0x05, // ch:获取IO输出口设置信息 |en: Get IO output port setting information CTRL_LIGHT_SET_INFO = 0x06, // ch:获取光源设置信息 |en: Get lighting settings information CTRL_FILTER_SET_INFO = 0x07, // ch:获取滤波设置信息 |en: Get filter setting information }MVCL_CTRL_TYPE; /************************************************************************* *ch:常见宏定义 en| Common macro definitions *************************************************************************/ const static unsigned int MV_IO_MAX_COM_NAME_LENGTH = 64; // ch:最大的串口名称长度 | en:Max serial port name length const static unsigned int MV_IO_MAX_PROC_STATE_LEN = 64; // ch:最大的升级进度状态长度 | en:Max upgrade state length /************************************************************************* * 枚举定义 | en: Enumeration definition *************************************************************************/ // ch:关闭串口默认超时时间 en: Default timeout for closing serial port #define CLOSE_SERIAL_DEFAULT_TIMEOUT 3000 /** @enum MV_IO_PATTERN_OUT * @brief ch:输出模式选择 | en: Output mode selection */ typedef enum MV_IO_PATTERN_OUT__ { MV_IO_PATTERN_PWM = 0x05, // PWM MV_IO_PATTERN_SINGLE = 0x06, // SINGLE } MV_IO_PATTERN_OUT; /** @enum MV_IO_PORT_NUMBER * @brief ch:Port口定义 | en: port definition * ch:输入和输出的7个Port口均用这7个宏定义表示 | en:The eight port ports of input and output are represented by these seven macro definitions * ch:若要同时控制两个Port口输出，可以将其或运算（例如: MV_IO_PORT_1 | MV_IO_PORT_2） * en: To enable the output of two port ports at the same time, the or operation can be performed(ex: MV_IO_PORT_1 | MV_IO_PORT_2) */ typedef enum MV_IO_PORT_NUMBER__ { MV_IO_PORT_1 = 0x1, // ch:端口1 | en: port1 MV_IO_PORT_2 = 0x2, // ch:端口2 | en: port2 MV_IO_PORT_3 = 0x4, // ch:端口3 | en: port3 MV_IO_PORT_4 = 0x8, // ch:端口4 | en: port4 MV_IO_PORT_5 = 0x10, // ch:端口5 | en: port5 MV_IO_PORT_6 = 0x20, // ch:端口6 | en: port6 MV_IO_PORT_7 = 0x40, // ch:端口7 | en: port7 MV_IO_PORT_8 = 0x80, // ch:端口8 | en: port8 } MV_IO_PORT_NUMBER; /** @enum MV_IO_EDGE_TYPE * @brief ch:沿定义,用户表示输入信号的触发 | en:Edge definition */ typedef enum MV_IO_EDGE_TYPE__ { MV_IO_EDGE_UNKNOW = 0x00, // ch:未知 | en: Unknow MV_IO_EDGE_RISING = 0x01, // ch:上升沿 | en: Rising edge MV_IO_EDGE_FALLING = 0x02, // ch:下降沿 | en: Falling edge } MV_IO_EDGE_TYPE; /** @enum MV_IO_ENABLE_TYPE * @brief ch:使能类型定义，用于控制串口模式情况下的触发 | en: Enable type definition, used to control the trigger in serial mode */ typedef enum MV_IO_ENABLE_TYPE__ { MV_IO_ENABLE_START = 0x00, // ch:使能开始 | en: Enable MV_IO_ENABLE_END = 0x01, // ch:使能结束 | en: Disable } MV_IO_ENABLE_TYPE; /** @enum MV_IO_LIGHTSTATE * @brief ch:光源常亮常灭 | en: Light states */ typedef enum MV_IO_LIGHTSTATE__ { MV_IO_LIGHTSTATE_ON = 0x0001, // ch:触发后常亮 | en:Light on after triggering MV_IO_LIGHTSTATE_OFF = 0x0002, // ch:触发后常灭 | en:Light off after triggering } MV_IO_LIGHTSTATE; // 消息类型 typedef enum MVCL_MSG_TYPE__ { MSG_TYPE_UNKNOW = 0x00, // ch:未知 | en:Unknow MSG_TYPE_NORMAL = 0x02, // ch:可识别正常消息类型 | en:Normal }MVCL_MSG_TYPE; /************************************************************************* * ch:结构体定义 | en:Struct definition *************************************************************************/ /** @struct MV_IO_SERIAL * @brief ch:串口参数 | en:Serial param */ typedef struct MV_IO_SERIAL__ { char strComName[MV_IO_MAX_COM_NAME_LENGTH]; // ch:串口名称 | en:Serial port name unsigned int nReserved[8]; // ch:保留字段 | en:Reserve } MV_IO_SERIAL; /** @struct MV_IO_LIGHT_PARAM * @brief ch:亮度参数设置 | en:Parameter setting of light source module */ typedef struct MV_IO_LIGHT_PARAM__ { unsigned char nPortNumber; // ch:亮度端口 | en:Light port unsigned short nLightValue; // ch:光源亮度值(0-100之间) | en:Light value(0-100) unsigned short nLightState; // ch:触发后常亮还是常灭 | en:Light on or off after triggering unsigned short nLightEdge; // ch:上升沿触发还是下降沿触发 | en:Rising or falling edge trigger unsigned int nDurationTime; // ch:持续时间 | en:Duration Time unsigned int nReserved[3]; // ch:保留字段 | en:Reserved } MV_IO_LIGHT_PARAM; /** @struct MV_IO_ASSOCIATE_PARAM * @brief ch:输入关联输出端口参数设置 | en:Input associated output port parameter setting */ typedef struct MV_IO_ASSOCIATEPORT_PARAM__ { unsigned short nInPortNum; // ch:被关联的输入端口 | en:Associated input port unsigned short nOutPortNum; // ch:关联的输出端口，(PORT_1)代表关联1号口，(PORT_1 | PORT_2)代表关联1号和2号口，(以此类推) // en:Associated output port, (Port_ 1)For the associated port 1, (Port_ 1 | PORT_ 2) Represents the connection between port 1 and port 2, and so on unsigned int nReserved[4]; // ch:保留字段 | en:Reserved } MV_IO_ASSOCIATEPORT_PARAM; /** @struct MV_IO_OUTPUT_ENABLE * @brief ch:设置输出使能 | en:Set output enable */ typedef struct MV_IO_OUTPUT_ENABLE__ { unsigned char nPortNumber; // 使能端口,若多个端口同时使能可以执行或运算 | en:Enable port, if more than one port is enabled at the same time, it can perform or operation unsigned char nType; // MV_IO_ENABLE_START 表示使能开始，MV_IO_ENABLE_END表示使能结束 | en:en:MV_IO_ENABLE_START:start of enabling,MV_IO_ENABLE_END:end of enabling unsigned int nReserved[4]; // 保留字段 | en:Reserved } MV_IO_OUTPUT_ENABLE; /** @struct MV_IO_INPUT_LEVEL * @brief ch:输入电平 en: Input level */ typedef struct MV_IO_INPUT_LEVEL__ { unsigned char nPortNumber; // ch:端口号,参考MV_IO_PORT_NUMBER | en: Port number.reference MV_IO_PORT_NUMBER unsigned char nLevel0; // ch:1号口电平信息 |en:Level information of port1 unsigned char nLevel1; // ch:2号口电平信息 |en:Level information of port2 unsigned char nLevel2; // ch:3号口电平信息 |en:Level information of port3 unsigned char nLevel3; // ch:4号口电平信息 |en:Level information of port4 unsigned char nLevel4; // ch:5号口电平信息 |en:Level information of port5 unsigned char nLevel5; // ch:6号口电平信息 |en:Level information of port6 unsigned char nLevel6; // ch:7号口电平信息 |en:Level information of port7 unsigned char nLevel7; // ch:8号口电平信息 |en:Level information of port8 unsigned int nReserved[8]; // ch:保留字节 | en:Reserved }MV_IO_INPUT_LEVEL; /** @struct MV_IO_INPUT_EDGE * @brief ch:检测输入沿信息类型的结构体 | en:Detects the structure of the input along the information type */ typedef struct MV_IO_INPUT_EDGE_TYPE__ { unsigned char nPortNumber; // ch:端口号 | en:Port number unsigned short nTriggerTimes; // ch:对应端口触发次数 | en:Trigger times of corresponding port enum MV_IO_EDGE_TYPE enEdgeType; // ch:沿类型 | en:Trigger edge type unsigned int nReserved[8]; // ch:保留字节 | en:Reserved }MV_IO_INPUT_EDGE_TYPE; /** @struct MV_IO_VERSION * @brief ch:SDK版本号 | en:SDK vision */ typedef struct MV_IO_VERSION__ { unsigned int nMainVersion; // ch:主版本号 | en:Major version unsigned int nSubVersion; // ch:次版本号 | en:Minor version unsigned int nModifyVersion; // ch:修订版本号 | en:Revision unsigned int nYear; // ch:年 | en:Year unsigned int nMonth; // ch:月 | en:month unsigned int nDay; // ch:日 | en:date unsigned int nReserved[8]; // ch:保留字节 | en:Reserved }MV_IO_VERSION; /** @struct MV_IO_SET_INPUT * @brief ch:输入端口设置 | en:Input port setting */ typedef struct MV_IO_SET_INPUT__ { unsigned int nPort; // ch:输入端口 | Input port unsigned int nEnable; // ch:使能状态，1表示开启，0表示关闭 | en:Enable state, 1 is on, 0 is off unsigned int nEdge; // ch:触发沿 | en:Trigger edge unsigned int nDelayTime; // ch:触发延迟 | en:Trigger delay unsigned int nGlitch; // ch:去抖时间 | en:Debounce time unsigned int nReserved[8]; // ch:保留字节 | en:Reserved }MV_IO_SET_INPUT; /** @struct MV_IO_SET_OUTPUT * @brief ch:输出端口设置 | en:Output port setting */ typedef struct MV_IO_SET_OUTPUT__ { unsigned int nPort; // 输出端口 | en:Output port unsigned int nType; // 输出模式(包含单脉冲模式和PWM模式) | en:Output mode(Single pulse and PWM mode ) unsigned int nPulseWidth; // 脉冲宽度 | en:Pulse width unsigned int nPulsePeriod; // 脉冲周期 | en:Pulse period unsigned int nDurationTime; // 脉冲持续时间 | en:Pulse duration unsigned int nValidLevel; // 有效电平，1表示高电平，0表示低电平 | en:Effective level, 1 is high level, 0 is low level unsigned int nReserved[8]; // 保留字节 | en:Reserved }MV_IO_SET_OUTPUT; /** @struct MV_IO_LOCAL_UPGRADE * @brief ch:固件升级状态 | en:Firmware upgrade status */ typedef struct MV_IO_LOCAL_UPGRADE__ { unsigned int nProcPercent; // ch:升级进度 | en:Upgrade progress char chProcState[MV_IO_MAX_PROC_STATE_LEN]; // ch:升级状态 | en:Upgrade status unsigned int nReserved[8]; // ch:保留字节 | en:Reserved }MV_IO_LOCAL_UPGRADE; // ch:检测电平回调函数 | en:Detection level callback function typedef void (__stdcall* DetectFunType)(void *, MV_IO_INPUT_EDGE_TYPE*, void*); /** @struct MV_SERIAL_DEVICE * @brief ch: 串口设备 en: serial device */ typedef struct MV_SERIAL_DEVICE_ { void* pMvSerial; // 串口句柄 DetectFunType pCallbackFun; // 沿检测函数 void* hCallBackThreadHandle; // 回调句柄 unsigned int bCallbackRunning; // 判断回调线程是否正在执行 void* hSerialRecvThreadHandle; // 串口接收数据线程句柄 unsigned int bSerialRecvRunning; // 判断串口是否正在接收数据 char nReserved[32]; // 保留字节 }MV_SERIAL_DEVICE; /** @struct MV_SERIAL_DATA * @brief ch: 串口数据 | en: serial Data */ typedef struct MV_SERIAL_DATA_ { unsigned int bUsed; // ch:标志位，数据是否使用 | en:Flag bit, whether the data is used or not MVCL_MSG_TYPE nType; // ch:数据类型 | en: Data type unsigned int nRecvLen; // ch:接收数据长度 | en:Received data length double fRecvTime; // ch:接收数据时间 | en:Received data time char* pSerialRecvBuf; // ch:接收的数据 | en:Data received char* pInitRecvBuf; // ch:初始数据 | en:Initial data }MV_SERIAL_DATA; #endif