Merge pull request #30 from libdriver/dev

fix: fix doc errors

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.0.2 (2025-01-01)
+
+## Bug Fixes
+
+- fix doc errors
+
 ## 1.0.1 (2024-08-10)
 
 ## Bug Fixes

doc/html/group__ws2812b__base__driver.html

@@ -220,7 +220,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga6fa1311ef2353ea55c58aa3
 <p>close the chip </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a ws2812b handle structure </td></tr>
   </table>
   </dd>
 </dl>
@@ -256,7 +256,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga2d68712e7e7d1b8f8329217
 <p>get chip's information </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[out]</td><td class="paramname">*info</td><td>points to a ws2812b info structure </td></tr>
+    <tr><td class="paramdir">[out]</td><td class="paramname">*info</td><td>pointer to a ws2812b info structure </td></tr>
   </table>
   </dd>
 </dl>
@@ -290,7 +290,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#gae6fbb749585737a343245f9
 <p>initialize the chip </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a ws2812b handle structure </td></tr>
   </table>
   </dd>
 </dl>
@@ -342,9 +342,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#gaf9000e2cf8036d77c73d913
 <p>set the chip register </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*buf</td><td>points to a data buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the data length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*buf</td><td>pointer to a data buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>data length </td></tr>
   </table>
   </dd>
 </dl>
@@ -408,11 +408,11 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga60effc5b5f3a3326ffaa3a8
 <p>write reset and color frame </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*rgb</td><td>points to a rgb color buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the rgb length </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>points to a temp buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>is the temp buffer length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*rgb</td><td>pointer to a rgb color buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>rgb length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>pointer to a temp buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>temp buffer length </td></tr>
   </table>
   </dd>
 </dl>
@@ -479,11 +479,11 @@ <h2 class="memtitle"><span class="permalink"><a href="#gac6fd3f9b02dff6d25690de9
 <p>write the color frame </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*rgb</td><td>points to a rgb color buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the rgb length </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>points to a temp buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>is the temp buffer length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*rgb</td><td>pointer to a rgb color buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>rgb length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>pointer to a temp buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>temp buffer length </td></tr>
   </table>
   </dd>
 </dl>
@@ -544,10 +544,10 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga9143c3d9bf67e15e3124f06
 <p>write the reset frame </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the rgb length </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>points to a temp buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>is the temp buffer length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>rgb length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>pointer to a temp buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>temp buffer length </td></tr>
   </table>
   </dd>
 </dl>

doc/html/group__ws2812b__example__driver.html

@@ -206,10 +206,10 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga0290134d7f85efe7a3c3018
 <p>basic example write </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*rgb</td><td>points to a rgb color buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the rgb length </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>points to a temp buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>is the temp buffer length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*rgb</td><td>pointer to a rgb color buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>rgb length </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*temp</td><td>pointer to a temp buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">temp_len</td><td>temp buffer length </td></tr>
   </table>
   </dd>
 </dl>

doc/html/group__ws2812b__interface__driver.html

@@ -144,7 +144,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga06272a71df762b39a7a5577
 <p>interface print format data </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">fmt</td><td>is the format data </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">fmt</td><td>format data </td></tr>
   </table>
   </dd>
 </dl>
@@ -173,7 +173,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#gafbc8bb115b98f6821e9abce
 <p>interface delay ms </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">ms</td><td></td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">ms</td><td>time </td></tr>
   </table>
   </dd>
 </dl>
@@ -268,8 +268,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga4a5339883cb90bc06763b2c
 <p>interface spi bus write command </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">*buf</td><td>points to a data buffer </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the length of data buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">*buf</td><td>pointer to a data buffer </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>length of data buffer </td></tr>
   </table>
   </dd>
 </dl>

doc/html/group__ws2812b__link__driver.html

@@ -147,8 +147,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga2fa848fe3582a8d5aa7008e
 <p>link debug_print function </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>points to a debug_print function address </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>pointer to a debug_print function address </td></tr>
   </table>
   </dd>
 </dl>
@@ -187,8 +187,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#gad96acb900fe5494fca54f6e
 <p>link delay_ms function </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>points to a delay_ms function address </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>pointer to a delay_ms function address </td></tr>
   </table>
   </dd>
 </dl>
@@ -227,8 +227,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga4ed311131502d4a9f112056
 <p>initialize ws2812b_handle_t structure </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">STRUCTURE</td><td>is ws2812b_handle_t </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">STRUCTURE</td><td>ws2812b_handle_t </td></tr>
   </table>
   </dd>
 </dl>
@@ -267,8 +267,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga2e74fcd73d577d01706521a
 <p>link spi_10mhz_init function </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>points to a spi_10mhz_init function address </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>pointer to a spi_10mhz_init function address </td></tr>
   </table>
   </dd>
 </dl>
@@ -307,8 +307,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#gac7f6e4e290d0cd4390acf26
 <p>link spi_deinit function </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>points to a spi_deinit function address </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>pointer to a spi_deinit function address </td></tr>
   </table>
   </dd>
 </dl>
@@ -347,8 +347,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga5690d20be0f3ccf553c9348
 <p>link spi_write_cmd function </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>points to a ws2812b handle structure </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>points to a spi_write_cmd function address </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">HANDLE</td><td>pointer to a ws2812b handle structure </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">FUC</td><td>pointer to a spi_write_cmd function address </td></tr>
   </table>
   </dd>
 </dl>

doc/html/group__ws2812b__test__driver.html

@@ -132,8 +132,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga9a0887c35117ee6647fc0c9
 <p>write test </p>
 <dl class="params"><dt>Parameters</dt><dd>
   <table class="params">
-    <tr><td class="paramdir">[in]</td><td class="paramname">cnt</td><td>is the number of the ws2812b led </td></tr>
-    <tr><td class="paramdir">[in]</td><td class="paramname">times</td><td>is the test times </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">cnt</td><td>number of the ws2812b led </td></tr>
+    <tr><td class="paramdir">[in]</td><td class="paramname">times</td><td>test times </td></tr>
   </table>
   </dd>
 </dl>

example/driver_ws2812b_basic.c

@@ -71,10 +71,10 @@ uint8_t ws2812b_basic_init(void)
 
 /**
  * @brief     basic example write 
- * @param[in] *rgb points to a rgb color buffer
- * @param[in] len is the rgb length
- * @param[in] *temp points to a temp buffer
- * @param[in] temp_len is the temp buffer length
+ * @param[in] *rgb pointer to a rgb color buffer
+ * @param[in] len rgb length
+ * @param[in] *temp pointer to a temp buffer
+ * @param[in] temp_len temp buffer length
  * @return    status code
  *            - 0 success
  *            - 1 write failed

example/driver_ws2812b_basic.h

@@ -70,10 +70,10 @@ uint8_t ws2812b_basic_deinit(void);
 
 /**
  * @brief     basic example write 
- * @param[in] *rgb points to a rgb color buffer
- * @param[in] len is the rgb length
- * @param[in] *temp points to a temp buffer
- * @param[in] temp_len is the temp buffer length
+ * @param[in] *rgb pointer to a rgb color buffer
+ * @param[in] len rgb length
+ * @param[in] *temp pointer to a temp buffer
+ * @param[in] temp_len temp buffer length
  * @return    status code
  *            - 0 success
  *            - 1 write failed

interface/driver_ws2812b_interface.h

@@ -70,8 +70,8 @@ uint8_t ws2812b_interface_spi_deinit(void);
 
 /**
  * @brief     interface spi bus write command
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of data buffer
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -81,14 +81,14 @@ uint8_t ws2812b_interface_spi_write_cmd(uint8_t *buf, uint16_t len);
 
 /**
  * @brief     interface delay ms
- * @param[in] ms
+ * @param[in] ms time
  * @note      none
  */
 void ws2812b_interface_delay_ms(uint32_t ms);
 
 /**
  * @brief     interface print format data
- * @param[in] fmt is the format data
+ * @param[in] fmt format data
  * @note      none
  */
 void ws2812b_interface_debug_print(const char *const fmt, ...);

interface/driver_ws2812b_interface_template.c

@@ -62,8 +62,8 @@ uint8_t ws2812b_interface_spi_deinit(void)
 
 /**
  * @brief     interface spi bus write command
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of data buffer
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -76,7 +76,7 @@ uint8_t ws2812b_interface_spi_write_cmd(uint8_t *buf, uint16_t len)
 
 /**
  * @brief     interface delay ms
- * @param[in] ms
+ * @param[in] ms time
  * @note      none
  */
 void ws2812b_interface_delay_ms(uint32_t ms)
@@ -86,7 +86,7 @@ void ws2812b_interface_delay_ms(uint32_t ms)
 
 /**
  * @brief     interface print format data
- * @param[in] fmt is the format data
+ * @param[in] fmt format data
  * @note      none
  */
 void ws2812b_interface_debug_print(const char *const fmt, ...)

project/raspberrypi4b/driver/src/raspberrypi4b_driver_ws2812b_interface.c

@@ -73,8 +73,8 @@ uint8_t ws2812b_interface_spi_deinit(void)
 
 /**
  * @brief     interface spi bus write command
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of data buffer
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -87,7 +87,7 @@ uint8_t ws2812b_interface_spi_write_cmd(uint8_t *buf, uint16_t len)
 
 /**
  * @brief     interface delay ms
- * @param[in] ms
+ * @param[in] ms time
  * @note      none
  */
 void ws2812b_interface_delay_ms(uint32_t ms)
@@ -97,7 +97,7 @@ void ws2812b_interface_delay_ms(uint32_t ms)
 
 /**
  * @brief     interface print format data
- * @param[in] fmt is the format data
+ * @param[in] fmt format data
  * @note      none
  */
 void ws2812b_interface_debug_print(const char *const fmt, ...)

project/raspberrypi4b/src/main.c

@@ -47,8 +47,8 @@ static uint8_t gs_temp[1024];              /**< temp buffer*/
 
 /**
  * @brief     ws2812b full function
- * @param[in] argc is arg numbers
- * @param[in] **argv is the arg address
+ * @param[in] argc arg numbers
+ * @param[in] **argv arg address
  * @return    status code
  *            - 0 success
  *            - 1 run failed
@@ -309,8 +309,8 @@ uint8_t ws2812b(uint8_t argc, char **argv)
 
 /**
  * @brief     main function
- * @param[in] argc is arg numbers
- * @param[in] **argv is the arg address
+ * @param[in] argc arg numbers
+ * @param[in] **argv arg address
  * @return    status code
  *             - 0 success
  * @note      none

project/stm32f407/MDK/stm32f407.uvprojx

@@ -10,14 +10,14 @@
       <TargetName>stm32f407</TargetName>
       <ToolsetNumber>0x4</ToolsetNumber>
       <ToolsetName>ARM-ADS</ToolsetName>
-      <pCCUsed>6140000::V6.14::ARMCLANG</pCCUsed>
+      <pCCUsed>6220000::V6.22::ARMCLANG</pCCUsed>
       <uAC6>1</uAC6>
       <TargetOption>
         <TargetCommonOption>
           <Device>STM32F407ZGTx</Device>
           <Vendor>STMicroelectronics</Vendor>
-          <PackID>Keil.STM32F4xx_DFP.2.14.0</PackID>
-          <PackURL>http://www.keil.com/pack/</PackURL>
+          <PackID>Keil.STM32F4xx_DFP.3.0.0</PackID>
+          <PackURL>https://www.keil.com/pack/</PackURL>
           <Cpu>IRAM(0x20000000,0x00020000) IRAM2(0x10000000,0x00010000) IROM(0x08000000,0x00100000) CPUTYPE("Cortex-M4") FPU2 CLOCK(12000000) ELITTLE</Cpu>
           <FlashUtilSpec></FlashUtilSpec>
           <StartupFile></StartupFile>
@@ -186,6 +186,7 @@
             <RvdsVP>2</RvdsVP>
             <RvdsMve>0</RvdsMve>
             <RvdsCdeCp>0</RvdsCdeCp>
+            <nBranchProt>0</nBranchProt>
             <hadIRAM2>1</hadIRAM2>
             <hadIROM2>0</hadIROM2>
             <StupSel>8</StupSel>
@@ -954,11 +955,6 @@
     <Layers>
       <Layer>
         <LayName>&lt;Project Info&gt;</LayName>
-        <LayDesc></LayDesc>
-        <LayUrl></LayUrl>
-        <LayKeys></LayKeys>
-        <LayCat></LayCat>
-        <LayLic></LayLic>
         <LayTarg>0</LayTarg>
         <LayPrjMark>1</LayPrjMark>
       </Layer>