IDF release/v4.0 08219f3cf

tools/sdk/include/freemodbus/esp_modbus_common.h

@@ -0,0 +1,138 @@
+/* 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_MAX - 1)  // 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