ResetReason: Update the header file

Minor doxygen fixes.
pull/10902/head
Filip Jagodzinski 2019-06-25 15:33:42 +02:00 committed by Martin Kojtal
parent f084bd5a9d
commit e2ba0bb533
2 changed files with 13 additions and 13 deletions

View File

@ -15,11 +15,6 @@
* limitations under the License. * limitations under the License.
*/ */
/**
* @addtogroup drivers_reset_reason_tests
* @{
*/
#ifndef MBED_DRIVERS_RESET_REASON_TESTS_H #ifndef MBED_DRIVERS_RESET_REASON_TESTS_H
#define MBED_DRIVERS_RESET_REASON_TESTS_H #define MBED_DRIVERS_RESET_REASON_TESTS_H
@ -36,6 +31,3 @@ void test_reset_reason();
#endif #endif
#endif #endif
/** @}*/

View File

@ -23,15 +23,19 @@
namespace mbed { namespace mbed {
/** \addtogroup drivers */ /** \addtogroup drivers */
/** ResetReason API. When the system is restarted, the reason for the restart is /** A platform-independent method of checking the cause of the last system reset.
* contained in the system registers at boot time in a platform specific manner, *
* this API provides a generic method of fetching the reason for the restart. * When the system is restarted, the reason for the restart is contained in
* the system registers at boot time in a platform specific manner. This API
* provides a generic method of fetching the reason for the restart.
* *
* @ingroup drivers * @ingroup drivers
*/ */
class ResetReason { class ResetReason {
public: public:
/** Get the platform-independent reason code for the last system reset. /** Get the platform-independent reason code for the last system reset.
*
* @return enum containing the last reset reason for the board.
* *
* Example: * Example:
* @code * @code
@ -47,12 +51,16 @@ public:
/** Get the platform specific reason code for the last system reset. /** Get the platform specific reason code for the last system reset.
* *
* Platform specific reasons that are not covered by the reset_reason_t enum * Platform specific reasons that are not covered by the ::reset_reason_t enum
* will cause the ResetReason::get() function to return * will cause the ResetReason::get() function to return
* RESET_REASON_PLATFORM. In order to get the actual reason the register * ::RESET_REASON_PLATFORM. In order to get the actual reason the register
* value must be fetched directly using this function and interpreted in a * value must be fetched directly using this function and interpreted in a
* platform specific manner. * platform specific manner.
* *
* @return value containing the reset reason register for the given platform.
* If the platform contains reset reasons across multiple registers they
* will be concatenated here.
*
* Example: * Example:
* @code * @code
* if (ResetReason::get() == RESET_REASON_PLATFORM) { * if (ResetReason::get() == RESET_REASON_PLATFORM) {