Data Access API расширено функциями для чтения/записи регистров

2025-11-05 13:11:25 +03:00
parent fdf22949ed
commit 5bbbbde3e6
10 changed files with 196 additions and 60 deletions
--- a/Inc/modbus.h
+++ b/Inc/modbus.h
@@ -106,7 +106,7 @@ HAL_StatusTypeDef MODBUS_SlaveStart(RS_HandleTypeDef *hmodbus, RS_MsgTypeDef *mo
 HAL_StatusTypeDef MODBUS_MasterRequest(RS_HandleTypeDef *hmodbus, RS_MsgTypeDef *modbus_msg, void (*pClbk)(RS_HandleTypeDef*, RS_MsgTypeDef*));

  
-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
+
 /////////////////////////---FUNCTIONS---/////////////////////////////

 #endif //__MODBUS_H_
--- a/Inc/modbus_coils.h
+++ b/Inc/modbus_coils.h
@@ -34,51 +34,6 @@ Coils упакованы в 16-битные слова для эффективн

 //--------------------------------------------------

-/**
-  * @addtogroup MODBUS_COILS
-  * @{
-  */
-
-/** 
-  * @brief  Макрос для установки указателя на регистр, содержащий запрашиваемый коил
-  * @param  _parr_  - массив коилов.
-  * @param  _coil_  - Номер коила от начала массива _arr_.
-  * @note   Используется вместе с @ref MB_Set_Coil_Mask
-  @verbatim Пояснение выражений
-  - (_coil_/16) - индекс регистра, в котором содержится коил по адресу _coil_
-
-Визуальный пример: 30 коил будет в 30/16 = 1 регистре (индексация с 0)
-  xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxCx
-  |register[0]----| |register[1]----|
-  |skip this------| |get this-------|
-                    |shift to 14 bit|
-  @endverbatim
-  */
-#define MB_Set_Coil_Reg_Ptr(_parr_, _coil_)           ((uint16_t *)(_parr_)+((_coil_)/16))
-/** 
-  * @brief  Макрос для установки маски, чтобы выделить запрашиваемый коил из регистра
-  * @param  _coil_  - Номер коила от начала массива _arr_.
-  * @note   Используется вместе с @ref MB_Set_Coil_Reg_Ptr
-  @verbatim Пояснение выражений
-  - (16*(_coil_/16) - сколько коилов нужно пропустить. прим. (16*30/16) - первые 16 коилов находятся вне регистра
-  - _coil_-(16*(_coil_/16)) - сдвинуть бит на место запрашиваемого коила в регистре
-  
-  Визуальный пример: 30 коил будет регистре[1], на 14 бите:
-    register = 30/16 = 1
-    bit = 30 - (16*30/16) = 30 - 16 = 14
-    
-  xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxCx
-  |register[0]----| |register[1]----|
-  |skip this------| |get this-------|
-                    |shift to 14 bit|
-  @endverbatim
-  */
-#define MB_Set_Coil_Mask(_coil_)                      (1 << ( _coil_ - (16*((_coil_)/16)) ))
-  
-/** MODBUS_COILS
-  * @} 
-  */
-  

 /////////////////////////////////////////////////////////////////////
 /////////////////////////---FUNCTIONS---/////////////////////////////
@@ -93,7 +48,7 @@ Coils упакованы в 16-битные слова для эффективн
  * @{
  */

-/** @brief Structure for coils operation */
+/** @brief Enum for coils operation */
 typedef enum
 {
  SET_COIL,
@@ -144,7 +99,6 @@ uint16_t MB_Coil_Read_Global(uint16_t Addr, MB_ExceptionTypeDef *Exception);
  * @} 
  */
  
-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
 /** 
  * @addtogroup MODBUS_CMD_PROCESS_FUNCTIONS
  @{
@@ -161,8 +115,4 @@ uint8_t MB_Process_Write_Miltuple_Coils(RS_MsgTypeDef *modbus_msg);
  */
 /////////////////////////---FUNCTIONS---/////////////////////////////
  
-#endif //__MODBUS_COILS_H_
-
-/** MODBUS_COILS
-  * @} 
-  */
+#endif //__MODBUS_COILS_H_
--- a/Inc/modbus_core.h
+++ b/Inc/modbus_core.h
@@ -194,6 +194,42 @@ extern RS_MsgTypeDef MODBUS_MSG;
  */
 #define MB_Set_Register_Ptr(_parr_, _addr_)           ((uint16_t *)(_parr_)+(_addr_))

+/** 
+  * @brief  Макрос для установки указателя на регистр, содержащий запрашиваемый коил
+  * @param  _parr_  - массив коилов.
+  * @param  _coil_  - Номер коила от начала массива _arr_.
+  * @note   Используется вместе с @ref MB_Set_Coil_Mask
+  @verbatim Пояснение выражений
+  - (_coil_/16) - индекс регистра, в котором содержится коил по адресу _coil_
+
+Визуальный пример: 30 коил будет в 30/16 = 1 регистре (индексация с 0)
+  xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxCx
+  |register[0]----| |register[1]----|
+  |skip this------| |get this-------|
+                    |shift to 14 bit|
+  @endverbatim
+  */
+#define MB_Set_Coil_Reg_Ptr(_parr_, _coil_)           ((uint16_t *)(_parr_)+((_coil_)/16))
+/** 
+  * @brief  Макрос для установки маски, чтобы выделить запрашиваемый коил из регистра
+  * @param  _coil_  - Номер коила от начала массива _arr_.
+  * @note   Используется вместе с @ref MB_Set_Coil_Reg_Ptr
+  @verbatim Пояснение выражений
+  - (16*(_coil_/16) - сколько коилов нужно пропустить. прим. (16*30/16) - первые 16 коилов находятся вне регистра
+  - _coil_-(16*(_coil_/16)) - сдвинуть бит на место запрашиваемого коила в регистре
+  
+  Визуальный пример: 30 коил будет регистре[1], на 14 бите:
+    register = 30/16 = 1
+    bit = 30 - (16*30/16) = 30 - 16 = 14
+    
+  xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxCx
+  |register[0]----| |register[1]----|
+  |skip this------| |get this-------|
+                    |shift to 14 bit|
+  @endverbatim
+  */
+#define MB_Set_Coil_Mask(_coil_)                      (1 << ( _coil_ - (16*((_coil_)/16)) ))
+  
 /** GENERAL_MODBUS_STUFF
  * @} 
  */
@@ -233,7 +269,6 @@ extern RS_MsgTypeDef MODBUS_MSG;
 /////////////////////////////////////////////////////////////////////
 /////////////////////////---FUNCTIONS---/////////////////////////////
  
-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
 /** 
  * @addtogroup MODBUS_CMD_PROCESS_FUNCTIONS
  @{
--- a/Inc/modbus_devid.h
+++ b/Inc/modbus_devid.h
@@ -99,7 +99,7 @@ void MB_WriteObjectsToMessage(RS_MsgTypeDef *modbus_msg, unsigned maxidofobj);
 /** MODBUS_DEVID
  * @} 
  */
-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
+ 
 /** 
  * @addtogroup MODBUS_CMD_PROCESS_FUNCTIONS
  @{
--- a/Inc/modbus_diag.h
+++ b/Inc/modbus_diag.h
@@ -98,7 +98,6 @@ void MB_Diagnostics_SlaveBusyCnt(void);
  * @} 
  */

-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
 /** 
  * @addtogroup MODBUS_CMD_PROCESS_FUNCTIONS
  @{
--- a/Inc/modbus_holdregs.h
+++ b/Inc/modbus_holdregs.h
@@ -23,7 +23,22 @@
 /////////////////////////////////////////////////////////////////////
 /////////////////////////---FUNCTIONS---/////////////////////////////

-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
+/**   
+  * @addtogroup MODBUS_DATA_ACCESS_FUNCTIONS
+  * @{
+  */
+
+/* Записать регистр хранения по глобальному адресу. */
+MB_ExceptionTypeDef MB_Holding_Write_Global(uint16_t Addr, uint16_t WriteVal);
+/* Считать регистр хранения по глобальному адресу. */
+uint16_t MB_Holding_Read_Global(uint16_t Addr, MB_ExceptionTypeDef *Exception);
+
+/** MODBUS_DATA_ACCESS_FUNCTIONS
+  * @} 
+  */
+
+
+  
 /** 
  * @addtogroup MODBUS_CMD_PROCESS_FUNCTIONS
  @{
--- a/Inc/modbus_inputregs.h
+++ b/Inc/modbus_inputregs.h
@@ -21,7 +21,21 @@
 /////////////////////////////////////////////////////////////////////
 /////////////////////////---FUNCTIONS---/////////////////////////////

-//---------PROCESS MODBUS COMMAND FUNCTIONS---------
+/**   
+  * @addtogroup MODBUS_DATA_ACCESS_FUNCTIONS
+  * @{
+  */
+
+/* Записать входной регистр по глобальному адресу. */
+MB_ExceptionTypeDef MB_Input_Write_Global(uint16_t Addr, uint16_t WriteVal);
+/* Считать входной регистр по глобальному адресу. */
+uint16_t MB_Input_Read_Global(uint16_t Addr, MB_ExceptionTypeDef *Exception);
+
+/** MODBUS_DATA_ACCESS_FUNCTIONS
+  * @} 
+  */
+
+  
 /** 
  * @addtogroup MODBUS_CMD_PROCESS_FUNCTIONS Internal Process Functions
  * @ingroup    MODBUS_INTERNAL