Release v6.1.0

Author: ALABSTM

Core/openbl_core.h

@@ -20,6 +20,10 @@
 #ifndef OPENBL_CORE_H
 #define OPENBL_CORE_H
 
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
 /* Includes ------------------------------------------------------------------*/
 #include <stdint.h>
 
@@ -30,7 +34,7 @@
 #define ACK_BYTE                          0x79U             /* Acknowledge Byte ID */
 #define NACK_BYTE                         0x1FU             /* No Acknowledge Byte ID */
 #define BUSY_BYTE                         0x76U             /* Busy Byte */
-#define SYNC_BYTE                         0xA5U             /* synchronization byte */
+#define SYNC_BYTE                         0xA5U             /* Synchronization byte */
 #define SPECIAL_CMD_SIZE_BUFFER1          128U              /* Special command received data buffer size */
 #define SPECIAL_CMD_SIZE_BUFFER2          1024U             /* Special command write data buffer size */
 
@@ -54,8 +58,8 @@
 #define CMD_NS_WRITE_UNPROTECT            0x74U             /* No Stretch Write Unprotect command */
 #define CMD_NS_READ_PROTECT               0x83U             /* No Stretch Read Protect command */
 #define CMD_NS_READ_UNPROTECT             0x93U             /* No Stretch Read Unprotect command */
-#define CMD_SPECIAL_COMMAND               0x50U             /* Special Read Protect */
-#define CMD_EXTENDED_SPECIAL_COMMAND      0x51U             /* Special write command */
+#define CMD_SPECIAL_COMMAND               0x50U             /* Special Command command */
+#define CMD_EXTENDED_SPECIAL_COMMAND      0x51U             /* Extended Special Command command */
 #define CMD_CHECKSUM                      0xA1U             /* Checksum command */
 
 /* Exported types ------------------------------------------------------------*/
@@ -123,4 +127,8 @@ uint32_t OPENBL_InterfaceDetection(void);
 void OPENBL_CommandProcess(void);
 ErrorStatus OPENBL_RegisterInterface(OPENBL_HandleTypeDef *Interface);
 
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
 #endif /* OPENBL_CORE_H */

Interfaces/Patterns/FDCAN/fdcan_interface.c

@@ -43,9 +43,9 @@ static void OPENBL_FDCAN_Init(void);
 
 /* Private functions ---------------------------------------------------------*/
 /**
- * @brief  This function is used to initialize the used FDCAN instance.
- * @retval None.
- */
+  * @brief  This function is used to initialize the used FDCAN instance.
+  * @retval None.
+  */
 static void OPENBL_FDCAN_Init(void)
 {
   /*                Bit time configuration:
@@ -112,9 +112,9 @@ static void OPENBL_FDCAN_Init(void)
 /* Exported functions --------------------------------------------------------*/
 
 /**
- * @brief  This function is used to configure FDCAN pins and then initialize the used FDCAN instance.
- * @retval None.
- */
+  * @brief  This function is used to configure FDCAN pins and then initialize the used FDCAN instance.
+  * @retval None.
+  */
 void OPENBL_FDCAN_Configuration(void)
 {
   /* Enable all resources clocks --------------------------------------------*/
@@ -125,9 +125,9 @@ void OPENBL_FDCAN_Configuration(void)
 }
 
 /**
- * @brief  This function is used to De-initialize the FDCAN pins and instance.
- * @retval None.
- */
+  * @brief  This function is used to De-initialize the FDCAN pins and instance.
+  * @retval None.
+  */
 void OPENBL_FDCAN_DeInit(void)
 {
   /* Only de-initialize the FDCAN if it is not the current detected interface */
@@ -143,9 +143,9 @@ void OPENBL_FDCAN_DeInit(void)
 }
 
 /**
- * @brief  This function is used to detect if there is any activity on FDCAN protocol.
- * @retval Returns 1 if interface is detected else 0..
- */
+  * @brief  This function is used to detect if there is any activity on FDCAN protocol.
+  * @retval Returns 1 if interface is detected else 0..
+  */
 uint8_t OPENBL_FDCAN_ProtocolDetection(void)
 {
   /* check if FIFO 0 receive at least one message */
@@ -162,9 +162,9 @@ uint8_t OPENBL_FDCAN_ProtocolDetection(void)
 }
 
 /**
- * @brief  This function is used to get the command opcode from the host.
- * @retval Returns the command.
- */
+  * @brief  This function is used to get the command opcode from the host.
+  * @retval Returns the command.
+  */
 uint8_t OPENBL_FDCAN_GetCommandOpcode(void)
 {
   uint8_t command_opc      = 0x0;
@@ -273,10 +273,10 @@ void OPENBL_FDCAN_SendBytes(uint8_t *Buffer, uint32_t BufferSize)
 }
 
 /**
- * @brief  This function is used to process and execute the special commands.
- *         The user must define the special commands routine here.
- * @retval Returns NACK status in case of error else returns ACK status.
- */
+  * @brief  This function is used to process and execute the special commands.
+  *         The user must define the special commands routine here.
+  * @retval Returns NACK status in case of error else returns ACK status.
+  */
 void OPENBL_FDCAN_SpecialCommandProcess(OPENBL_SpecialCmdTypeDef *Frame)
 {
   switch (Frame->OpCode)

Interfaces/Patterns/FLASH/flash_interface.c

@@ -409,20 +409,20 @@ ErrorStatus OPENBL_FLASH_Erase(uint8_t *p_Data, uint32_t DataLength)
 }
 
 /**
- * @brief  This function is used to Set Flash busy state variable to activate busy state sending
- *         during flash operations
- * @retval None.
-*/
+  * @brief  This function is used to Set Flash busy state variable to activate busy state sending
+  *         during flash operations
+  * @retval None.
+  */
 void OPENBL_Enable_BusyState_Flag(void)
 {
   /* Enable Flash busy state sending */
   Flash_BusyState = FLASH_BUSY_STATE_ENABLED;
 }
 
 /**
- * @brief  This function is used to disable the send of busy state in I2C non stretch mode.
- * @retval None.
-*/
+  * @brief  This function is used to disable the send of busy state in I2C non stretch mode.
+  * @retval None.
+  */
 void OPENBL_Disable_BusyState_Flag(void)
 {
   /* Disable Flash busy state sending */
@@ -723,7 +723,7 @@ __attribute__((section(".ramfunc"))) static HAL_StatusTypeDef OPENBL_FLASH_Exten
   __IO uint32_t *reg_cr;
 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
   uint32_t primask_bit;
-#endif
+#endif /* (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U) */
 
   /* Process Locked */
   __HAL_LOCK(&FlashProcess);

Interfaces/Patterns/I2C/i2c_interface.c

@@ -38,9 +38,9 @@ static void OPENBL_I2C_Init(void);
 /* Private functions ---------------------------------------------------------*/
 
 /**
- * @brief  This function is used to initialize the used I2C instance.
- * @retval None.
- */
+  * @brief  This function is used to initialize the used I2C instance.
+  * @retval None.
+  */
 static void OPENBL_I2C_Init(void)
 {
   LL_I2C_InitTypeDef I2C_InitStruct;
@@ -60,9 +60,9 @@ static void OPENBL_I2C_Init(void)
 /* Exported functions --------------------------------------------------------*/
 
 /**
- * @brief  This function is used to configure I2C pins and then initialize the used I2C instance.
- * @retval None.
- */
+  * @brief  This function is used to configure I2C pins and then initialize the used I2C instance.
+  * @retval None.
+  */
 void OPENBL_I2C_Configuration(void)
 {
   GPIO_InitTypeDef GPIO_InitStruct;
@@ -92,9 +92,9 @@ void OPENBL_I2C_Configuration(void)
 }
 
 /**
- * @brief  This function is used to De-initialize the I2C pins and instance.
- * @retval None.
- */
+  * @brief  This function is used to De-initialize the I2C pins and instance.
+  * @retval None.
+  */
 void OPENBL_I2C_DeInit(void)
 {
   /* Only de-initialize the I2C if it is not the current detected interface */
@@ -107,9 +107,9 @@ void OPENBL_I2C_DeInit(void)
 }
 
 /**
- * @brief  This function is used to detect if there is any activity on I2C protocol.
- * @retval None.
- */
+  * @brief  This function is used to detect if there is any activity on I2C protocol.
+  * @retval None.
+  */
 uint8_t OPENBL_I2C_ProtocolDetection(void)
 {
   /* Check if the I2Cx is addressed */
@@ -126,9 +126,9 @@ uint8_t OPENBL_I2C_ProtocolDetection(void)
 }
 
 /**
- * @brief  This function is used to get the command opcode from the host.
- * @retval Returns the command.
- */
+  * @brief  This function is used to get the command opcode from the host.
+  * @retval Returns the command.
+  */
 uint8_t OPENBL_I2C_GetCommandOpcode(void)
 {
   uint8_t command_opc = 0x0U;
@@ -353,11 +353,11 @@ __attribute__((section(".ramfunc"))) void OPENBL_I2C_SendBusyByte(void)
 }
 
 /**
- * @brief  This function is used to process and execute the special commands.
- *         The user must define the special commands routine here.
- * @param  SpecialCmd Pointer to the OPENBL_SpecialCmdTypeDef structure.
- * @retval Returns NACK status in case of error else returns ACK status.
- */
+  * @brief  This function is used to process and execute the special commands.
+  *         The user must define the special commands routine here.
+  * @param  SpecialCmd Pointer to the OPENBL_SpecialCmdTypeDef structure.
+  * @retval Returns NACK status in case of error else returns ACK status.
+  */
 void OPENBL_I2C_SpecialCommandProcess(OPENBL_SpecialCmdTypeDef *SpecialCmd)
 {
   switch (SpecialCmd->OpCode)
@@ -388,20 +388,20 @@ void OPENBL_I2C_SpecialCommandProcess(OPENBL_SpecialCmdTypeDef *SpecialCmd)
 }
 
 /**
- * @brief  This function is used to Set Flash busy state variable to activate busy state sending
- *         during flash operations
- * @retval None.
-*/
+  * @brief  This function is used to Set Flash busy state variable to activate busy state sending
+  *         during flash operations
+  * @retval None.
+  */
 void OPENBL_Enable_BusyState_Sending(void)
 {
   /* Enable Flash busy state sending */
   OPENBL_Enable_BusyState_Flag();
 }
 
 /**
- * @brief  This function is used to disable the send of busy state in I2C non stretch mode.
- * @retval None.
-*/
+  * @brief  This function is used to disable the send of busy state in I2C non stretch mode.
+  * @retval None.
+  */
 void OPENBL_Disable_BusyState_Sending(void)
 {
   /* Disable Flash busy state sending */