Documentation-related fixes.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@13426 27425a3e-05d8-49a3-a47f-9c15f0e5edd8
This commit is contained in:
Giovanni Di Sirio 2020-03-15 13:41:45 +00:00
parent d9a0b13c96
commit 6efb153e11
7 changed files with 11 additions and 16 deletions

View File

@ -790,8 +790,6 @@ INPUT = ./src \
../../os/hal/dox \
../../os/hal/src \
../../os/hal/include \
../../os/hal/lib/peripherals/flash \
../../os/hal/lib/peripherals/sensors \
../../os/hal/lib/streams \
../../os/hal/lib/complex/mfs \
../../os/hal/lib/complex/serial_nor \

View File

@ -790,8 +790,6 @@ INPUT = ./src \
../../os/hal/dox \
../../os/hal/src \
../../os/hal/include \
../../os/hal/lib/peripherals/flash \
../../os/hal/lib/peripherals/sensors \
../../os/hal/lib/streams \
../../os/hal/lib/complex/mfs \
../../os/hal/lib/complex/serial_nor \

View File

@ -357,6 +357,7 @@ struct hal_wspi_driver {
* @brief Wakes up the waiting thread.
*
* @param[in] wspip pointer to the @p WSPIDriver object
* @param[in] msg the wakeup message
*
* @notapi
*/

View File

@ -392,7 +392,6 @@ static mfs_error_t mfs_bank_write_header(MFSDriver *mfsp,
* @brief Checks integrity of the header in the shared buffer.
*
* @param[in] mfsp pointer to the @p MFSDriver object
* @param[in] bank bank identifier
* @return The header state.
*
* @notapi

View File

@ -135,10 +135,6 @@ systime_t stGetAlarm(void) {
return st_lld_get_alarm();
}
/**
* @name Macro Functions
* @{
*/
/**
* @brief Returns the time counter value.
* @note This functionality is only available in free running mode, the

View File

@ -213,6 +213,9 @@ void wspiStartReceive(WSPIDriver *wspip, const wspi_command_t *cmdp,
*
* @param[in] wspip pointer to the @p WSPIDriver object
* @param[in] cmdp pointer to the command descriptor
* @return The operation status.
* @retval false if the operation succeeded.
* @retval true if the operation failed because HW issues.
*
* @api
*/

View File

@ -128,7 +128,7 @@ void efl_lld_stop(EFlashDriver *eflp) {
/**
* @brief Gets the flash descriptor structure.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @return A flash device descriptor.
*
* @notapi
@ -143,7 +143,7 @@ const flash_descriptor_t *efl_lld_get_descriptor(void *instance) {
/**
* @brief Read operation.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @param[in] offset flash offset
* @param[in] n number of bytes to be read
* @param[out] rp pointer to the data buffer
@ -187,7 +187,7 @@ flash_error_t efl_lld_read(void *instance, flash_offset_t offset,
* @note The device supports ECC, it is only possible to write erased
* pages once except when writing all zeroes.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @param[in] offset flash offset
* @param[in] n number of bytes to be programmed
* @param[in] pp pointer to the data buffer
@ -232,7 +232,7 @@ flash_error_t efl_lld_program(void *instance, flash_offset_t offset,
* touched because it is where the program is running on.
* Pages on bank 1 can be individually erased.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @return An error code.
* @retval FLASH_NO_ERROR if there is no erase operation in progress.
* @retval FLASH_BUSY_ERASING if there is an erase operation in progress.
@ -263,7 +263,7 @@ flash_error_t efl_lld_start_erase_all(void *instance) {
/**
* @brief Starts an sector erase operation.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @param[in] sector sector to be erased
* @return An error code.
* @retval FLASH_NO_ERROR if there is no erase operation in progress.
@ -297,7 +297,7 @@ flash_error_t efl_lld_start_erase_sector(void *instance,
/**
* @brief Queries the driver for erase operation progress.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @param[out] msec recommended time, in milliseconds, that
* should be spent before calling this
* function again, can be @p NULL
@ -328,7 +328,7 @@ flash_error_t efl_lld_query_erase(void *instance, uint32_t *msec) {
/**
* @brief Returns the erase state of a sector.
*
* @param[in] ip pointer to a @p EFlashDriver instance
* @param[in] instance pointer to a @p EFlashDriver instance
* @param[in] sector sector to be verified
* @return An error code.
* @retval FLASH_NO_ERROR if the sector is erased.