Merge pull request #32 from libdriver/dev

fix: fix doc errors

Author: libdriver

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 2.0.8 (2025-03-15)
+
+## Bug Fixes
+
+- fix doc errors
+
 ## 2.0.7 (2025-01-05)
 
 ## Bug Fixes

project/raspberrypi4b/interface/inc/iic.h

@@ -55,8 +55,8 @@ extern "C" {
 
 /**
  * @brief      iic bus init
- * @param[in]  *name points to an iic device name buffer
- * @param[out] *fd points to an iic device handle buffer
+ * @param[in]  *name pointer to an iic device name buffer
+ * @param[out] *fd pointer to an iic device handle buffer
  * @return     status code
  *             - 0 success
  *             - 1 init failed
@@ -66,7 +66,7 @@ uint8_t iic_init(char *name, int *fd);
 
 /**
  * @brief     iic bus deinit
- * @param[in] fd is the iic handle
+ * @param[in] fd iic handle
  * @return    status code
  *            - 0 success
  *            - 1 deinit failed
@@ -76,10 +76,10 @@ uint8_t iic_deinit(int fd);
 
 /**
  * @brief      iic bus read command
- * @param[in]  fd is the iic handle
- * @param[in]  addr is the iic device write address
- * @param[out] *buf points to a data buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd iic handle
+ * @param[in]  addr iic device write address
+ * @param[out] *buf pointer to a data buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -89,11 +89,11 @@ uint8_t iic_read_cmd(int fd, uint8_t addr, uint8_t *buf, uint16_t len);
 
 /**
  * @brief      iic bus read
- * @param[in]  fd is the iic handle
- * @param[in]  addr is the iic device write address
- * @param[in]  reg is the iic register address
- * @param[out] *buf points to a data buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd iic handle
+ * @param[in]  addr iic device write address
+ * @param[in]  reg iic register address
+ * @param[out] *buf pointer to a data buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -103,11 +103,11 @@ uint8_t iic_read(int fd, uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);
 
 /**
  * @brief      iic bus read with 16 bits register address
- * @param[in]  fd is the iic handle
- * @param[in]  addr is the iic device write address
- * @param[in]  reg is the iic register address
- * @param[out] *buf points to a data buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd iic handle
+ * @param[in]  addr iic device write address
+ * @param[in]  reg iic register address
+ * @param[out] *buf pointer to a data buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -117,10 +117,10 @@ uint8_t iic_read_address16(int fd, uint8_t addr, uint16_t reg, uint8_t *buf, uin
 
 /**
  * @brief     iic bus write command
- * @param[in] fd is the iic handle
- * @param[in] addr is the iic device write address
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of the data buffer
+ * @param[in] fd iic handle
+ * @param[in] addr iic device write address
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of the data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -130,11 +130,11 @@ uint8_t iic_write_cmd(int fd, uint8_t addr, uint8_t *buf, uint16_t len);
 
 /**
  * @brief     iic bus write
- * @param[in] fd is the iic handle
- * @param[in] addr is the iic device write address
- * @param[in] reg is the iic register address
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of the data buffer
+ * @param[in] fd iic handle
+ * @param[in] addr iic device write address
+ * @param[in] reg iic register address
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of the data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -144,11 +144,11 @@ uint8_t iic_write(int fd, uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len)
 
 /**
  * @brief     iic bus write with 16 bits register address
- * @param[in] fd is the iic handle
- * @param[in] addr is the iic device write address
- * @param[in] reg is the iic register address
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of the data buffer
+ * @param[in] fd iic handle
+ * @param[in] addr iic device write address
+ * @param[in] reg iic register address
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of the data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed

project/raspberrypi4b/interface/inc/shell.h

@@ -89,8 +89,8 @@ uint8_t shell_init(void);
 
 /**
  * @brief     shell register function
- * @param[in] *name points to a name buffer
- * @param[in] *fuc points to a function address
+ * @param[in] *name pointer to a name buffer
+ * @param[in] *fuc pointer to a function address
  * @return    status code
  *            - 0 success
  *            - 1 buffer is full
@@ -100,8 +100,8 @@ uint8_t shell_register(char *name, uint8_t (*fuc)(uint8_t argc, char **argv));
 
 /**
  * @brief     shell parse command
- * @param[in] *buf points to a buffer address
- * @param[in] len is the buffer length
+ * @param[in] *buf pointer to a buffer address
+ * @param[in] len buffer length
  * @return    status code
  *            - 0 success
  *            - 1 run failed

project/raspberrypi4b/interface/inc/spi.h

@@ -67,10 +67,10 @@ typedef enum
 
 /**
  * @brief      spi bus init
- * @param[in]  *name points to a spi device name buffer
- * @param[out] *fd points to a spi device handle buffer
- * @param[in]  mode is the spi mode.
- * @param[in]  freq is the spi running frequence
+ * @param[in]  *name pointer to a spi device name buffer
+ * @param[out] *fd pointer to a spi device handle buffer
+ * @param[in]  mode spi mode
+ * @param[in]  freq spi running frequence
  * @return     status code
  *             - 0 success
  *             - 1 init failed
@@ -80,7 +80,7 @@ uint8_t spi_init(char *name, int *fd, spi_mode_type_t mode, uint32_t freq);
 
 /**
  * @brief     spi bus deinit
- * @param[in] fd is the spi handle
+ * @param[in] fd spi handle
  * @return    status code
  *            - 0 success
  *            - 1 deinit failed
@@ -90,9 +90,9 @@ uint8_t spi_deinit(int fd);
 
 /**
  * @brief      spi bus read command
- * @param[in]  fd is the spi handle
- * @param[out] *buf points to a data buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd spi handle
+ * @param[out] *buf pointer to a data buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -102,10 +102,10 @@ uint8_t spi_read_cmd(int fd, uint8_t *buf, uint16_t len);
 
 /**
  * @brief      spi bus read
- * @param[in]  fd is the spi handle
- * @param[in]  reg is the spi register address
- * @param[out] *buf points to a data buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd spi handle
+ * @param[in]  reg spi register address
+ * @param[out] *buf pointer to a data buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -115,10 +115,10 @@ uint8_t spi_read(int fd, uint8_t reg, uint8_t *buf, uint16_t len);
 
 /**
  * @brief      spi bus read address 16
- * @param[in]  fd is the spi handle
- * @param[in]  reg is the spi register address
- * @param[out] *buf points to a data buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd spi handle
+ * @param[in]  reg spi register address
+ * @param[out] *buf pointer to a data buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -128,9 +128,9 @@ uint8_t spi_read_address16(int fd, uint16_t reg, uint8_t *buf, uint16_t len);
 
 /**
  * @brief     spi bus write command
- * @param[in] fd is the spi handle
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of the data buffer
+ * @param[in] fd spi handle
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of the data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -140,10 +140,10 @@ uint8_t spi_write_cmd(int fd, uint8_t *buf, uint16_t len);
 
 /**
  * @brief     spi bus write
- * @param[in] fd is the spi handle
- * @param[in] reg is the spi register address
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of the data buffer
+ * @param[in] fd spi handle
+ * @param[in] reg spi register address
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of the data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -153,10 +153,10 @@ uint8_t spi_write(int fd, uint8_t reg, uint8_t *buf, uint16_t len);
 
 /**
  * @brief     spi bus write address 16
- * @param[in] fd is the spi handle
- * @param[in] reg is the spi register address
- * @param[in] *buf points to a data buffer
- * @param[in] len is the length of the data buffer
+ * @param[in] fd spi handle
+ * @param[in] reg spi register address
+ * @param[in] *buf pointer to a data buffer
+ * @param[in] len length of the data buffer
  * @return    status code
  *            - 0 success
  *            - 1 write failed
@@ -166,11 +166,11 @@ uint8_t spi_write_address16(int fd, uint16_t reg, uint8_t *buf, uint16_t len);
 
 /**
  * @brief      spi bus write read
- * @param[in]  fd is the spi handle
- * @param[in]  *in_buf points to an input buffer
- * @param[in]  in_len is the input length
- * @param[out] *out_buf points to an output buffer
- * @param[in]  out_len is the output length
+ * @param[in]  fd spi handle
+ * @param[in]  *in_buf pointer to an input buffer
+ * @param[in]  in_len input length
+ * @param[out] *out_buf pointer to an output buffer
+ * @param[in]  out_len output length
  * @return     status code
  *             - 0 success
  *             - 1 write read failed
@@ -180,10 +180,10 @@ uint8_t spi_write_read(int fd, uint8_t *in_buf, uint32_t in_len, uint8_t *out_bu
 
 /**
  * @brief      spi transmit
- * @param[in]  fd is the spi handle
- * @param[in]  *tx points to a tx buffer
- * @param[out] *rx points to a rx buffer
- * @param[in]  len is the length of the data buffer
+ * @param[in]  fd spi handle
+ * @param[in]  *tx pointer to a tx buffer
+ * @param[out] *rx pointer to a rx buffer
+ * @param[in]  len length of the data buffer
  * @return     status code
  *             - 0 success
  *             - 1 transmit failed

project/raspberrypi4b/interface/inc/wire.h

@@ -70,7 +70,7 @@ uint8_t wire_deinit(void);
 
 /**
  * @brief      wire bus read data
- * @param[out] *value points to a data buffer
+ * @param[out] *value pointer to a data buffer
  * @return     status code
  *             - 0 success
  *             - 1 read failed
@@ -80,7 +80,7 @@ uint8_t wire_read(uint8_t *value);
 
 /**
  * @brief     wire bus write data
- * @param[in] value is the write data
+ * @param[in] value write data
  * @return    status code
  *            - 0 success
  *             - 1 write failed
@@ -107,7 +107,7 @@ uint8_t wire_clock_deinit(void);
 
 /**
  * @brief     wire bus write data
- * @param[in] value is the write data
+ * @param[in] value write data
  * @return    status code
  *            - 0 success
  *            - 1 write failed