release 0.4 (*API CHANGED)
*Не совсем апи, но поменялись enum в modbus_core.h: - MB_ExceptionTypeDef - MB_FunctonTypeDef Необходимо обновить modbus_data.c: NO_ERRORS -> NO_ERRORS ILLEGAL_FUNCTION -> ET_ILLEGAL_FUNCTION ILLEGAL_DATA_ADDRESS -> ET_ILLEGAL_DATA_ADDRESS ILLEGAL_DATA_ADDRESS -> ET_ILLEGAL_DATA_ADDRESS - множественные правки докумнтации - множественный рефакторинг
This commit is contained in:
107
Inc/rs_message.h
107
Inc/rs_message.h
@@ -1,29 +1,29 @@
|
||||
/**
|
||||
******************************************************************************
|
||||
*******************************************************************************
|
||||
* @file rs_message.h
|
||||
* @brief Библиотека обмена сообщениями по RS-интерфейсу
|
||||
******************************************************************************
|
||||
*******************************************************************************
|
||||
@defgroup RS_TOOLS RS Tools
|
||||
@brief Всякое для работы по UART/RS
|
||||
@{
|
||||
******************************************************************************
|
||||
*******************************************************************************
|
||||
* @details
|
||||
Универсальная библиотека для работы с последовательными протоколами (Modbus, Custom)
|
||||
через UART в режиме прерываний с поддержкой таймаутов.
|
||||
|
||||
@section Основные возможности:
|
||||
@section posibility Основные возможности:
|
||||
- Прием/передача в прерываниях
|
||||
- Обработка IDLE линии для определения конца фрейма
|
||||
- Таймауты приема через TIM
|
||||
- Гибкая настройка размера сообщений
|
||||
|
||||
@section Использование:
|
||||
@section usage Использование:
|
||||
1. Определить структуру сообщения и размеры буфера
|
||||
2. Реализовать weak-функции обработки сообщений
|
||||
3. Добавить вызовы RS_UART_Handler/RS_TIM_Handler в прерывания
|
||||
4. Инициализировать через RS_Init() и запустить прием RS_Receive_IT()
|
||||
|
||||
@section Особенности:
|
||||
@section features Особенности:
|
||||
- Буфер: RS_Buffer[MSG_SIZE_MAX] Общий для приема/передачи
|
||||
- Состояния: отслеживается через флаги в RS_HandleTypeDef
|
||||
- Таймауты: контролируют максимальное время ожидания фрейма
|
||||
@@ -76,42 +76,6 @@
|
||||
#define RS_Is_TX_Busy(_hRS_) (_hRS_->f.TX_Busy == 1)
|
||||
|
||||
|
||||
#ifndef printf_rs_err
|
||||
#define printf_rs_err(...)
|
||||
#endif
|
||||
|
||||
#ifndef printf_rs
|
||||
#define printf_rs(...)
|
||||
#endif
|
||||
|
||||
#ifndef __MYLIBS_CONFIG_H_
|
||||
// дефайны из mylibs include
|
||||
static int dummy;
|
||||
#define TrackerTypeDef(num_user_vars) void *
|
||||
#define num_of_usercnts(_user_) 0
|
||||
#define assert_tracecnt(_cntstruct_, _uservarnumb_) 0
|
||||
#define if_assert_usertracker(_cntstruct_, _uservarnumb_) if(0)
|
||||
#define tern_assert_usertracker(_cntstruct_, _uservarnumb_) 0
|
||||
#define TrackerGet_Ok(_cntstruct_) dummy
|
||||
#define TrackerGet_Err(_cntstruct_) dummy
|
||||
#define TrackerGet_Warn(_cntstruct_) dummy
|
||||
#define TrackerGet_User(_cntstruct_, _uservarnumb_) dummy
|
||||
#define TrackerCnt_Ok(_cntstruct_)
|
||||
#define TrackerCnt_Err(_cntstruct_)
|
||||
#define TrackerCnt_Warn(_cntstruct_)
|
||||
#define TrackerCnt_User(_cntstruct_, _uservarnumb_)
|
||||
#define TrackerWrite_User(_cntstruct_, _uservarnumb_, _val_)
|
||||
#define TrackerClear_All(_cntstruct_)
|
||||
#define TrackerClear_Ok(_cntstruct_)
|
||||
#define TrackerClear_Err(_cntstruct_)
|
||||
#define TrackerClear_Warn(_cntstruct_)
|
||||
#define TrackerClear_User(_cntstruct_)
|
||||
#define TrackerClear_UserAll(_cntstruct_)
|
||||
#else
|
||||
#include "mylibs_include.h"
|
||||
#endif
|
||||
|
||||
|
||||
#ifndef RS_USER_VARS_NUMB
|
||||
#define RS_USER_VARS_NUMB 0
|
||||
#endif
|
||||
@@ -122,6 +86,65 @@ static int dummy;
|
||||
/** @endcond */
|
||||
|
||||
|
||||
/**
|
||||
* @addtogroup RS_DEBUG Tools for debug RS/UART/TIM
|
||||
* @ingroup RS_TOOLS
|
||||
* @brief Дефайны для отладки периферии
|
||||
* @{
|
||||
*/
|
||||
|
||||
#ifndef RS_USER_VARS_NUMB
|
||||
#define RS_USER_VARS_NUMB 0 ///< Количество переменных в @ref TrackerTypeDef
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Тип структуры для счетчиков-переменных
|
||||
* @param num_user_vars Есть возмоность добавления num_user_vars количества пользовательскиъх переменных
|
||||
*/
|
||||
#define TrackerTypeDef(num_user_vars) void *
|
||||
/** @brief Инкрементировать переменную - успешных событий */
|
||||
#define TrackerCnt_Ok(_cntstruct_)
|
||||
/** @brief Инкрементировать переменную - ошибок */
|
||||
#define TrackerCnt_Err(_cntstruct_)
|
||||
/** @brief Инкрементировать переменную - предупреждений */
|
||||
#define TrackerCnt_Warn(_cntstruct_)
|
||||
|
||||
|
||||
|
||||
#ifndef printf_rs
|
||||
/** @brief Printf обычных событий RS/UART/TIM */
|
||||
#define printf_rs(...)
|
||||
#endif
|
||||
|
||||
#ifndef printf_rs_err
|
||||
/** @brief Printf ошибок RS/UART/TIM */
|
||||
#define printf_rs_err(...)
|
||||
#endif
|
||||
|
||||
|
||||
#ifndef RS_TIM_Handler_ENTER
|
||||
/** @brief Действия при заходе в прерывания таймера */
|
||||
#define RS_TIM_Handler_ENTER()
|
||||
#endif
|
||||
#ifndef RS_TIM_Handler_EXIT
|
||||
/** @brief Действия при выходе из прерывания таймера */
|
||||
#define RS_TIM_Handler_EXIT()
|
||||
#endif
|
||||
|
||||
#ifndef RS_UART_Handler_ENTER
|
||||
/** @brief Действия при заходе в прерывания UART */
|
||||
#define RS_UART_Handler_ENTER()
|
||||
#endif
|
||||
#ifndef RS_UART_Handler_EXIT
|
||||
/** @brief Действия при выходе из прерывания UART */
|
||||
#define RS_UART_Handler_EXIT()
|
||||
#endif
|
||||
/** RS_TOOLS
|
||||
* @}
|
||||
*/
|
||||
|
||||
|
||||
|
||||
// направление передачи rs485
|
||||
#ifndef RS_EnableReceive
|
||||
#define RS_EnableReceive() ///< Функция изменения направления передачи на ПРИЕМ для RS-485
|
||||
|
||||
Reference in New Issue
Block a user