Подтягивание всех изменений с релиза в ветку

Modbus/Inc/modbus.h

@@ -5,7 +5,7 @@
 ******************************************************************************
 @addtogroup MODBUS Modbus tools
 ******************************************************************************
-@addtogroup MODBUS_FUNCTIONS Modbus library funtions
+@addtogroup MODBUS_FUNCTIONS Main API for Modbus Library
 @ingroup    MODBUS
 @{
 ******************************************************************************
@@ -17,35 +17,45 @@
 @section Инструкция по подключению
 Для корректной работы надо:
 - Подключить обработчики RS_UART_Handler(), RS_TIM_Handler(), в соответствубщие 
-  низкоуровневые прерывания UART_IRQHandler, TIM_IRQHandler. Вместо HAL'овского обработчика
+  низкоуровневые прерывания UART_IRQHandler, TIM_IRQHandler вместо HAL'овского обработчика
  
-В modbus_config.h настроить дефайны для нужной работы UART
+- В modbus_config.h настроить дефайны для нужной работы UART
 
-- Инициализировать хендл мобдас. По умолчанию глобально создается hmodbus1, но можно сделать свой
-После для запуска Modbus:
-@verbatim
-//----------------Прием модбас----------------//
-#include "modbus.h"
+- Инициализировать хендл мобдас. По умолчанию глобально создается hmodbus1
+- После для запуска Modbus:
+  @verbatim
+  //----------------Слейв модбас----------------//
+  #include "modbus.h"
 
-MODBUS_SetupHardware(&hmodbus1, &huart1, &htim3);
-MODBUS_SlaveStart(&hmodbus1, NULL);
-// или если нужно переключится на другой 
-@endverbatim
+  MODBUS_FirstInit(&hmodbus1, &huart1, &htim3);
+  MODBUS_Config(&hmodbus1, 1, 1000, MODBUS_MODE_SLAVE);
+  MODBUS_SlaveStart(&hmodbus1, NULL);
+  @endverbatim
+  @verbatim
+  //----------------Мастер модбас----------------//
+  #include "modbus.h"
+
+  MODBUS_FirstInit(&hmodbus1, &huart1, &htim3);
+  MODBUS_Config(&hmodbus1, 0, 1000, MODBUS_MODE_MASTER); // - если нужны другие настройки, не из modbus_config.h
+  // Запрос на 1 ID, считать холдинг регистры с 0 адреса 10 штук
+  RS_MsgTypeDef msg = MB_REQUEST_READ_HOLDING_REGS(1, 0, 10);
+  MODBUS_MasterRequest(&hmodbus1, &msg, &callback_func);
+  
+  void callback_func(RS_HandleTypeDef *hmodbus, RS_MsgTypeDef *modbus_msg) 
+  {
+    // modbus_msg содержит ответ от устройства
+  }
+  @endverbatim
 
 
 @section Подключаемые модули:
+- rs_message.h - работа с uart
 - modbus_core.h - базовые определения
 - modbus_coils.h - работа с дискретными выходами
 - modbus_holdregs.h - работа с регистрами хранения  
 - modbus_inputregs.h - работа с входными регистрами
 - modbus_devid.h - идентификация устройства
-- __crc_algs.h - алгоритмы CRC
-
-@section Использование в проекте:
-1. Настроить modbus_config.h под устройство
-2. Определить структуры данных в modbus_data.h
-3. Подключить этот файл в rs_message.h
-4. Вызвать MODBUS_FirstInit() и RS_Receive_IT()
+- modbus_diag.h - диагностика modbus
 
 
 @section Структура данных Modbus
@@ -62,12 +72,14 @@ MODBUS_SlaveStart(&hmodbus1, NULL);
 #ifndef __MODBUS_H_
 #define __MODBUS_H_
  
-#include "__crc_algs.h"
 #include "rs_message.h"
+#include "modbus_master.h"
+#include "modbus_slave.h"
 #include "modbus_coils.h"
 #include "modbus_holdregs.h"
 #include "modbus_inputregs.h"
 #include "modbus_devid.h"
+#include "modbus_diag.h"
 
   
 
@@ -76,20 +88,16 @@ MODBUS_SlaveStart(&hmodbus1, NULL);
 
   
 //----------------FUNCTIONS FOR USER----------------
-/** 
-  * @addtogroup MODBUS_INIT_FUNCTIONS Functions for Init
-  * @ingroup    MODBUS_FUNCTIONS
-  * @brief      Функции для инициализации
-  @{
-  */
-/* Инициализация периферии модбас. */
-void MODBUS_SetupHardware(RS_HandleTypeDef *hmodbus, UART_HandleTypeDef *huart, TIM_HandleTypeDef *htim);
-/* Программная конфигурация модбас. */
-void MODBUS_Config(RS_HandleTypeDef *hmodbus, uint8_t ID, uint16_t Timeout, uint8_t master);
 
-/** MODBUS_INIT_FUNCTIONS
-  * @} 
-  */
+/* Инициализация периферии модбас. */
+HAL_StatusTypeDef MODBUS_FirstInit(RS_HandleTypeDef *hmodbus, UART_HandleTypeDef *huart, TIM_HandleTypeDef *htim);
+/* Программная конфигурация модбас. */
+HAL_StatusTypeDef MODBUS_Config(RS_HandleTypeDef *hmodbus, uint8_t ID, uint16_t Timeout, uint8_t master);
+/* Запуск слейв устройства */
+HAL_StatusTypeDef MODBUS_SlaveStart(RS_HandleTypeDef *hmodbus, RS_MsgTypeDef *modbus_msg);
+/* Реквест мастера модбас */
+HAL_StatusTypeDef MODBUS_MasterRequest(RS_HandleTypeDef *hmodbus, RS_MsgTypeDef *modbus_msg, void (*pClbk)(RS_HandleTypeDef*, RS_MsgTypeDef*));
+
   
 //---------PROCESS MODBUS COMMAND FUNCTIONS---------
 /////////////////////////---FUNCTIONS---/////////////////////////////