michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doxygen: make device and init comments doxygen friendly

Browse source 
Document structs and some typo fixes

Change-Id: Idf9df3f4f401d141a2332a83c2c60cb19c9fb8e3
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
This commit is contained in:
Anas Nashif 2015-07-10 14:52:53 -04:00
commit 538cb82151
2 changed files with 16 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

24
include/device.h
View file

@ -60,26 +60,28 @@
struct device;
/* Static device infomation (In ROM) Per driver instance */
/**
* @brief Static device information (In ROM) Per driver instance
* @param name name of the device
* @param init init function for the driver
* @param config_info address of driver instance config information
*/
struct device_config {
/** name of the device */
char *name;
/** init function for the driver */
int (*init)(struct device *device);
/** address of driver instance config information */
void *config_info;
};
/* Runtime device structure (In memory) Per driver instance */
/**
* @brief Runtime device structure (In memory) Per driver instance
* @param device_config Build time config information
* @param driver_api pointer to structure containing the API unctions for
* the device type. This pointer is filled in by the driver at init time.
* @param driver_data river instance data. For driver use only
*/
struct device {
/** Build time config information */
struct device_config *config;
/** pointer to structure containing the API functions for the
* device type. This pointer is filled in by the driver at
* init time.
*/
void *driver_api;
/** Driver instance data. For driver use only*/
void *driver_data;
};

6
include/init.h
View file

@ -41,13 +41,13 @@
#define MICRO_LATE 4
#define APP_EARLY 5
#define APP_LATE 6
/** @def __define_initconfig
*
* @brief Define an init object
*
* @details This macro declares an init object to be placed a
* given init level section in the image. This macro not should be used
* @details This macro declares an init object to be placed in a
* given init level section in the image. This macro should not be used
* directly.
*
* @param cfg_name Name of the config object created with