/* Copyright 2018 Espressif Systems (Shanghai) PTE LTD * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef _MB_IFACE_COMMON_H #define _MB_IFACE_COMMON_H #include "driver/uart.h" // for UART types #define MB_CONTROLLER_STACK_SIZE (CONFIG_FMB_CONTROLLER_STACK_SIZE) // Stack size for Modbus controller #define MB_CONTROLLER_PRIORITY (CONFIG_FMB_SERIAL_TASK_PRIO - 1) // priority of MB controller task // Default port defines #define MB_DEVICE_ADDRESS (1) // Default slave device address in Modbus #define MB_DEVICE_SPEED (115200) // Default Modbus speed for now hard defined #define MB_UART_PORT (UART_NUM_2) // Default UART port number #define MB_PAR_INFO_TOUT (10) // Timeout for get parameter info #define MB_PARITY_NONE (UART_PARITY_DISABLE) // The Macros below handle the endianness while transfer N byte data into buffer #define _XFER_4_RD(dst, src) { \ *(uint8_t *)(dst)++ = *(uint8_t*)(src + 1); \ *(uint8_t *)(dst)++ = *(uint8_t*)(src + 0); \ *(uint8_t *)(dst)++ = *(uint8_t*)(src + 3); \ *(uint8_t *)(dst)++ = *(uint8_t*)(src + 2); \ (src) += 4; \ } #define _XFER_2_RD(dst, src) { \ *(uint8_t *)(dst)++ = *(uint8_t *)(src + 1); \ *(uint8_t *)(dst)++ = *(uint8_t *)(src + 0); \ (src) += 2; \ } #define _XFER_4_WR(dst, src) { \ *(uint8_t *)(dst + 1) = *(uint8_t *)(src)++; \ *(uint8_t *)(dst + 0) = *(uint8_t *)(src)++; \ *(uint8_t *)(dst + 3) = *(uint8_t *)(src)++; \ *(uint8_t *)(dst + 2) = *(uint8_t *)(src)++ ; \ } #define _XFER_2_WR(dst, src) { \ *(uint8_t *)(dst + 1) = *(uint8_t *)(src)++; \ *(uint8_t *)(dst + 0) = *(uint8_t *)(src)++; \ } /** * @brief Types of actual Modbus implementation */ typedef enum { MB_PORT_SERIAL_MASTER = 0x00, /*!< Modbus port type serial master. */ MB_PORT_SERIAL_SLAVE, /*!< Modbus port type serial slave. */ MB_PORT_TCP_MASTER, /*!< Modbus port type TCP master. */ MB_PORT_TCP_SLAVE, /*!< Modbus port type TCP slave. */ MB_PORT_COUNT /*!< Modbus port count. */ } mb_port_type_t; /** * @brief Event group for parameters notification */ typedef enum { MB_EVENT_NO_EVENTS = 0x00, MB_EVENT_HOLDING_REG_WR = BIT0, /*!< Modbus Event Write Holding registers. */ MB_EVENT_HOLDING_REG_RD = BIT1, /*!< Modbus Event Read Holding registers. */ MB_EVENT_INPUT_REG_RD = BIT3, /*!< Modbus Event Read Input registers. */ MB_EVENT_COILS_WR = BIT4, /*!< Modbus Event Write Coils. */ MB_EVENT_COILS_RD = BIT5, /*!< Modbus Event Read Coils. */ MB_EVENT_DISCRETE_RD = BIT6, /*!< Modbus Event Read Discrete bits. */ MB_EVENT_STACK_STARTED = BIT7 /*!< Modbus Event Stack started */ } mb_event_group_t; /** * @brief Type of Modbus parameter */ typedef enum { MB_PARAM_HOLDING = 0x00, /*!< Modbus Holding register. */ MB_PARAM_INPUT, /*!< Modbus Input register. */ MB_PARAM_COIL, /*!< Modbus Coils. */ MB_PARAM_DISCRETE, /*!< Modbus Discrete bits. */ MB_PARAM_COUNT, MB_PARAM_UNKNOWN = 0xFF } mb_param_type_t; /*! * \brief Modbus serial transmission modes (RTU/ASCII). */ typedef enum { MB_MODE_RTU, /*!< RTU transmission mode. */ MB_MODE_ASCII, /*!< ASCII transmission mode. */ MB_MODE_TCP /*!< TCP mode. */ } mb_mode_type_t; // Todo: This is common type leave it here for now /** * @brief Device communication structure to setup Modbus controller */ typedef union { // Serial communication structure struct { mb_mode_type_t mode; /*!< Modbus communication mode */ uint8_t slave_addr; /*!< Modbus slave address field (dummy for master) */ uart_port_t port; /*!< Modbus communication port (UART) number */ uint32_t baudrate; /*!< Modbus baudrate */ uart_parity_t parity; /*!< Modbus UART parity settings */ uint16_t dummy_port; }; // Tcp communication structure struct { mb_mode_type_t tcp_mode; /*!< Modbus communication mode */ uint8_t dummy_addr; /*!< Modbus slave address field (dummy for master) */ uart_port_t dummy_uart_port; /*!< Modbus communication port (UART) number */ uint32_t dummy_baudrate; /*!< Modbus baudrate */ uart_parity_t dummy_parity; /*!< Modbus UART parity settings */ uint16_t tcp_port; /*!< Modbus TCP port */ }; } mb_communication_info_t; /** * common interface method types */ typedef esp_err_t (*iface_init)(mb_port_type_t, void**); /*!< Interface method init */ typedef esp_err_t (*iface_destroy)(void); /*!< Interface method destroy */ typedef esp_err_t (*iface_setup)(void*); /*!< Interface method setup */ typedef esp_err_t (*iface_start)(void); /*!< Interface method start */ #endif // _MB_IFACE_COMMON_H