Minor documentation improvements.

pull/1469/head
Dean Camera 12 years ago
parent 88bcc6fde5
commit 03cdb09071

@ -86,7 +86,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -148,7 +148,7 @@ bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -186,7 +186,7 @@ static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -208,7 +208,7 @@ static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -232,7 +232,7 @@ static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInt
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo, static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
const bool IsDataRead) const bool IsDataRead)
@ -274,7 +274,7 @@ static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfa
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {

@ -80,7 +80,7 @@ static bool PageDirty = false;
* *
* \param[in] Byte ASCII byte of data to check * \param[in] Byte ASCII byte of data to check
* *
* \return Boolean \c true if the input data is ASCII encoded HEX, false otherwise. * \return Boolean \c true if the input data is ASCII encoded HEX, \c false otherwise.
*/ */
static bool IsHex(const char Byte) static bool IsHex(const char Byte)
{ {

@ -227,7 +227,7 @@ void EVENT_USB_Device_ControlRequest(void)
* \param[in,out] Data Pointer to a location where the parameter data is stored for SET operations, or where * \param[in,out] Data Pointer to a location where the parameter data is stored for SET operations, or where
* the retrieved data is to be stored for GET operations. * the retrieved data is to be stored for GET operations.
* *
* \return Boolean true if the property get/set was successful, false otherwise * \return Boolean \c true if the property get/set was successful, \c false otherwise
*/ */
bool CALLBACK_Audio_Device_GetSetEndpointProperty(USB_ClassInfo_Audio_Device_t* const AudioInterfaceInfo, bool CALLBACK_Audio_Device_GetSetEndpointProperty(USB_ClassInfo_Audio_Device_t* const AudioInterfaceInfo,
const uint8_t EndpointProperty, const uint8_t EndpointProperty,

@ -136,7 +136,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -138,7 +138,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -138,7 +138,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -166,7 +166,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -137,7 +137,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -501,7 +501,7 @@ void DataflashManager_ResetDataflashProtections(void)
/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working. /** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
* *
* \return Boolean true if all media chips are working, false otherwise * \return Boolean \c true if all media chips are working, \c false otherwise
*/ */
bool DataflashManager_CheckDataflashOperation(void) bool DataflashManager_CheckDataflashOperation(void)
{ {

@ -86,7 +86,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -150,7 +150,7 @@ bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -188,7 +188,7 @@ static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -210,7 +210,7 @@ static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -233,7 +233,7 @@ static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInt
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -272,7 +272,7 @@ static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInte
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo, static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
const bool IsDataRead) const bool IsDataRead)
@ -330,7 +330,7 @@ static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfa
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {

@ -501,7 +501,7 @@ void DataflashManager_ResetDataflashProtections(void)
/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working. /** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
* *
* \return Boolean true if all media chips are working, false otherwise * \return Boolean \c true if all media chips are working, \c false otherwise
*/ */
bool DataflashManager_CheckDataflashOperation(void) bool DataflashManager_CheckDataflashOperation(void)
{ {

@ -86,7 +86,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -150,7 +150,7 @@ bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -188,7 +188,7 @@ static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -210,7 +210,7 @@ static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -233,7 +233,7 @@ static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInt
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -272,7 +272,7 @@ static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInte
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo, static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
const bool IsDataRead) const bool IsDataRead)
@ -330,7 +330,7 @@ static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfa
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {

@ -193,7 +193,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -138,7 +138,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -62,7 +62,7 @@
* \param[in] MAC1 First MAC address * \param[in] MAC1 First MAC address
* \param[in] MAC2 Second MAC address * \param[in] MAC2 Second MAC address
* *
* \return True if the addresses match, false otherwise * \return True if the addresses match, \c false otherwise
*/ */
#define MAC_COMPARE(MAC1, MAC2) (memcmp(MAC1, MAC2, sizeof(MAC_Address_t)) == 0) #define MAC_COMPARE(MAC1, MAC2) (memcmp(MAC1, MAC2, sizeof(MAC_Address_t)) == 0)

@ -59,7 +59,7 @@
* \param[in] IP1 First IP address * \param[in] IP1 First IP address
* \param[in] IP2 Second IP address * \param[in] IP2 Second IP address
* *
* \return True if the addresses match, false otherwise * \return True if the addresses match, \c false otherwise
*/ */
#define IP_COMPARE(IP1, IP2) (memcmp(IP1, IP2, sizeof(IP_Address_t)) == 0) #define IP_COMPARE(IP1, IP2) (memcmp(IP1, IP2, sizeof(IP_Address_t)) == 0)

@ -173,7 +173,7 @@ void TCP_Init(void)
* \param[in] State New state of the port, a value from the \ref TCP_PortStates_t enum * \param[in] State New state of the port, a value from the \ref TCP_PortStates_t enum
* \param[in] Handler Application callback handler for the port * \param[in] Handler Application callback handler for the port
* *
* \return Boolean true if the port state was set, false otherwise (no more space in the port state table) * \return Boolean \c true if the port state was set, \c false otherwise (no more space in the port state table)
*/ */
bool TCP_SetPortState(const uint16_t Port, bool TCP_SetPortState(const uint16_t Port,
const uint8_t State, const uint8_t State,
@ -247,7 +247,7 @@ uint8_t TCP_GetPortState(const uint16_t Port)
* \param[in] RemotePort TCP port of the remote device in the connection, specified in big endian * \param[in] RemotePort TCP port of the remote device in the connection, specified in big endian
* \param[in] State TCP connection state, a value from the \ref TCP_ConnectionStates_t enum * \param[in] State TCP connection state, a value from the \ref TCP_ConnectionStates_t enum
* *
* \return Boolean true if the connection was updated or created, false otherwise (no more space in the connection state table) * \return Boolean \c true if the connection was updated or created, \c false otherwise (no more space in the connection state table)
*/ */
bool TCP_SetConnectionState(const uint16_t Port, bool TCP_SetConnectionState(const uint16_t Port,
const IP_Address_t* RemoteAddress, const IP_Address_t* RemoteAddress,

@ -91,7 +91,7 @@
* *
* \param[in] Buffer Application buffer to check * \param[in] Buffer Application buffer to check
* *
* \return Boolean true if the buffer contains a packet from the host, false otherwise * \return Boolean \c true if the buffer contains a packet from the host, \c false otherwise
*/ */
#define TCP_APP_HAS_RECEIVED_PACKET(Buffer) (Buffer->Ready && (Buffer->Direction == TCP_PACKETDIR_IN)) #define TCP_APP_HAS_RECEIVED_PACKET(Buffer) (Buffer->Ready && (Buffer->Direction == TCP_PACKETDIR_IN))
@ -99,7 +99,7 @@
* *
* \param[in] Buffer Application buffer to check * \param[in] Buffer Application buffer to check
* *
* \return Boolean true if the buffer has been captured by the application for device-to-host transmissions, false otherwise * \return Boolean \c true if the buffer has been captured by the application for device-to-host transmissions, \c false otherwise
*/ */
#define TCP_APP_HAVE_CAPTURED_BUFFER(Buffer) (!(Buffer->Ready) && Buffer->InUse && (Buffer->Direction == TCP_PACKETDIR_OUT)) #define TCP_APP_HAVE_CAPTURED_BUFFER(Buffer) (!(Buffer->Ready) && Buffer->InUse && (Buffer->Direction == TCP_PACKETDIR_OUT))
@ -107,7 +107,7 @@
* *
* \param[in] Buffer Application buffer to check * \param[in] Buffer Application buffer to check
* *
* \return Boolean true if the buffer may be captured by the application for device-to-host transmissions, false otherwise * \return Boolean \c true if the buffer may be captured by the application for device-to-host transmissions, \c false otherwise
*/ */
#define TCP_APP_CAN_CAPTURE_BUFFER(Buffer) Buffer->InUse #define TCP_APP_CAN_CAPTURE_BUFFER(Buffer) Buffer->InUse

@ -88,7 +88,7 @@ void Webserver_Init(void)
* \param[in] RequestHeader HTTP request made by the host * \param[in] RequestHeader HTTP request made by the host
* \param[in] Command HTTP command to compare the request to * \param[in] Command HTTP command to compare the request to
* *
* \return Boolean true if the command matches the request, false otherwise * \return Boolean \c true if the command matches the request, \c false otherwise
*/ */
static bool IsHTTPCommand(uint8_t* RequestHeader, static bool IsHTTPCommand(uint8_t* RequestHeader,
char* Command) char* Command)

@ -501,7 +501,7 @@ void DataflashManager_ResetDataflashProtections(void)
/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working. /** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
* *
* \return Boolean true if all media chips are working, false otherwise * \return Boolean \c true if all media chips are working, \c false otherwise
*/ */
bool DataflashManager_CheckDataflashOperation(void) bool DataflashManager_CheckDataflashOperation(void)
{ {

@ -86,7 +86,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -150,7 +150,7 @@ bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -188,7 +188,7 @@ static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -210,7 +210,7 @@ static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -233,7 +233,7 @@ static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInt
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -272,7 +272,7 @@ static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInte
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo, static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
const bool IsDataRead) const bool IsDataRead)
@ -330,7 +330,7 @@ static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfa
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {

@ -203,7 +203,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -407,7 +407,7 @@ void TMC_Task(void)
* *
* \param[out] MessageHeader Pointer to a location where the read header (if any) should be stored * \param[out] MessageHeader Pointer to a location where the read header (if any) should be stored
* *
* \return Boolean true if a header was read, false otherwise * \return Boolean \c true if a header was read, \c false otherwise
*/ */
bool ReadTMCHeader(TMC_MessageHeader_t* const MessageHeader) bool ReadTMCHeader(TMC_MessageHeader_t* const MessageHeader)
{ {

@ -134,7 +134,7 @@ void EVENT_USB_Device_ControlRequest(void)
* *
* \param[out] ReportData Pointer to a HID report data structure to be filled * \param[out] ReportData Pointer to a HID report data structure to be filled
* *
* \return Boolean true if the new report differs from the last report, false otherwise * \return Boolean \c true if the new report differs from the last report, \c false otherwise
*/ */
bool GetNextReport(USB_JoystickReport_Data_t* const ReportData) bool GetNextReport(USB_JoystickReport_Data_t* const ReportData)
{ {

@ -37,7 +37,7 @@
#include "Keyboard.h" #include "Keyboard.h"
/** Indicates what report mode the host has requested, true for normal HID reporting mode, false for special boot /** Indicates what report mode the host has requested, true for normal HID reporting mode, \c false for special boot
* protocol reporting mode. * protocol reporting mode.
*/ */
static bool UsingReportProtocol = true; static bool UsingReportProtocol = true;

@ -497,7 +497,7 @@ void DataflashManager_ResetDataflashProtections(void)
/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working. /** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
* *
* \return Boolean true if all media chips are working, false otherwise * \return Boolean \c true if all media chips are working, \c false otherwise
*/ */
bool DataflashManager_CheckDataflashOperation(void) bool DataflashManager_CheckDataflashOperation(void)
{ {

@ -84,7 +84,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* to the appropriate SCSI command handling routine if the issued command is supported by the device, else it returns * to the appropriate SCSI command handling routine if the issued command is supported by the device, else it returns
* a command failure due to a ILLEGAL REQUEST. * a command failure due to a ILLEGAL REQUEST.
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(void) bool SCSI_DecodeSCSICommand(void)
{ {
@ -146,7 +146,7 @@ bool SCSI_DecodeSCSICommand(void)
/** Command processing for an issued SCSI INQUIRY command. This command returns information about the device's features /** Command processing for an issued SCSI INQUIRY command. This command returns information about the device's features
* and capabilities to the host. * and capabilities to the host.
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(void) static bool SCSI_Command_Inquiry(void)
{ {
@ -183,7 +183,7 @@ static bool SCSI_Command_Inquiry(void)
/** Command processing for an issued SCSI REQUEST SENSE command. This command returns information about the last issued command, /** Command processing for an issued SCSI REQUEST SENSE command. This command returns information about the last issued command,
* including the error code and additional error information so that the host can determine why a command failed to complete. * including the error code and additional error information so that the host can determine why a command failed to complete.
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(void) static bool SCSI_Command_Request_Sense(void)
{ {
@ -208,7 +208,7 @@ static bool SCSI_Command_Request_Sense(void)
/** Command processing for an issued SCSI READ CAPACITY (10) command. This command returns information about the device's capacity /** Command processing for an issued SCSI READ CAPACITY (10) command. This command returns information about the device's capacity
* on the selected Logical Unit (drive), as a number of OS-sized blocks. * on the selected Logical Unit (drive), as a number of OS-sized blocks.
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(void) static bool SCSI_Command_Read_Capacity_10(void)
{ {
@ -235,7 +235,7 @@ static bool SCSI_Command_Read_Capacity_10(void)
* board, and indicates if they are present and functioning correctly. Only the Self-Test portion of the diagnostic command is * board, and indicates if they are present and functioning correctly. Only the Self-Test portion of the diagnostic command is
* supported. * supported.
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Send_Diagnostic(void) static bool SCSI_Command_Send_Diagnostic(void)
{ {
@ -273,7 +273,7 @@ static bool SCSI_Command_Send_Diagnostic(void)
* *
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(const bool IsDataRead) static bool SCSI_Command_ReadWrite_10(const bool IsDataRead)
{ {
@ -325,7 +325,7 @@ static bool SCSI_Command_ReadWrite_10(const bool IsDataRead)
/** Command processing for an issued SCSI MODE SENSE (6) command. This command returns various informational pages about /** Command processing for an issued SCSI MODE SENSE (6) command. This command returns various informational pages about
* the SCSI device, as well as the device's Write Protect status. * the SCSI device, as well as the device's Write Protect status.
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(void) static bool SCSI_Command_ModeSense_6(void)
{ {

@ -222,7 +222,7 @@ void MassStorage_Task(void)
/** Function to read in a command block from the host, via the bulk data OUT endpoint. This function reads in the next command block /** Function to read in a command block from the host, via the bulk data OUT endpoint. This function reads in the next command block
* if one has been issued, and performs validation to ensure that the block command is valid. * if one has been issued, and performs validation to ensure that the block command is valid.
* *
* \return Boolean true if a valid command block has been read in from the endpoint, false otherwise * \return Boolean \c true if a valid command block has been read in from the endpoint, \c false otherwise
*/ */
static bool ReadInCommandBlock(void) static bool ReadInCommandBlock(void)
{ {

@ -36,7 +36,7 @@
#include "Mouse.h" #include "Mouse.h"
/** Indicates what report mode the host has requested, true for normal HID reporting mode, false for special boot /** Indicates what report mode the host has requested, true for normal HID reporting mode, \c false for special boot
* protocol reporting mode. * protocol reporting mode.
*/ */
static bool UsingReportProtocol = true; static bool UsingReportProtocol = true;

@ -60,7 +60,7 @@
* \param[in] MAC1 First MAC address * \param[in] MAC1 First MAC address
* \param[in] MAC2 Second MAC address * \param[in] MAC2 Second MAC address
* *
* \return True if the addresses match, false otherwise * \return True if the addresses match, \c false otherwise
*/ */
#define MAC_COMPARE(MAC1, MAC2) (memcmp(MAC1, MAC2, sizeof(MAC_Address_t)) == 0) #define MAC_COMPARE(MAC1, MAC2) (memcmp(MAC1, MAC2, sizeof(MAC_Address_t)) == 0)

@ -59,7 +59,7 @@
* \param[in] IP1 First IP address * \param[in] IP1 First IP address
* \param[in] IP2 Second IP address * \param[in] IP2 Second IP address
* *
* \return True if the addresses match, false otherwise * \return True if the addresses match, \c false otherwise
*/ */
#define IP_COMPARE(IP1, IP2) (memcmp(IP1, IP2, sizeof(IP_Address_t)) == 0) #define IP_COMPARE(IP1, IP2) (memcmp(IP1, IP2, sizeof(IP_Address_t)) == 0)

@ -237,7 +237,7 @@ void ProcessRNDISControlMessage(void)
* \param[out] ResponseData Pointer to the start of the query response inside the RNDIS message buffer * \param[out] ResponseData Pointer to the start of the query response inside the RNDIS message buffer
* \param[out] ResponseSize Pointer to the size in bytes of the response data being sent to the host * \param[out] ResponseSize Pointer to the size in bytes of the response data being sent to the host
* *
* \return Boolean true if the query was handled, false otherwise * \return Boolean \c true if the query was handled, \c false otherwise
*/ */
static bool ProcessNDISQuery(const uint32_t OId, void* QueryData, uint16_t QuerySize, static bool ProcessNDISQuery(const uint32_t OId, void* QueryData, uint16_t QuerySize,
void* ResponseData, uint16_t* ResponseSize) void* ResponseData, uint16_t* ResponseSize)
@ -367,7 +367,7 @@ static bool ProcessNDISQuery(const uint32_t OId, void* QueryData, uint16_t Query
* \param[in] SetData Pointer to the parameter value in the RNDIS message buffer * \param[in] SetData Pointer to the parameter value in the RNDIS message buffer
* \param[in] SetSize Size in bytes of the parameter value being sent by the host * \param[in] SetSize Size in bytes of the parameter value being sent by the host
* *
* \return Boolean true if the set was handled, false otherwise * \return Boolean \c true if the set was handled, \c false otherwise
*/ */
static bool ProcessNDISSet(uint32_t OId, void* SetData, uint16_t SetSize) static bool ProcessNDISSet(uint32_t OId, void* SetData, uint16_t SetSize)
{ {

@ -172,7 +172,7 @@ void TCP_Init(void)
* \param[in] State New state of the port, a value from the \ref TCP_PortStates_t enum * \param[in] State New state of the port, a value from the \ref TCP_PortStates_t enum
* \param[in] Handler Application callback handler for the port * \param[in] Handler Application callback handler for the port
* *
* \return Boolean true if the port state was set, false otherwise (no more space in the port state table) * \return Boolean \c true if the port state was set, \c false otherwise (no more space in the port state table)
*/ */
bool TCP_SetPortState(const uint16_t Port, bool TCP_SetPortState(const uint16_t Port,
const uint8_t State, const uint8_t State,
@ -246,7 +246,7 @@ uint8_t TCP_GetPortState(const uint16_t Port)
* \param[in] RemotePort TCP port of the remote device in the connection, specified in big endian * \param[in] RemotePort TCP port of the remote device in the connection, specified in big endian
* \param[in] State TCP connection state, a value from the \ref TCP_ConnectionStates_t enum * \param[in] State TCP connection state, a value from the \ref TCP_ConnectionStates_t enum
* *
* \return Boolean true if the connection was updated or created, false otherwise (no more space in the connection state table) * \return Boolean \c true if the connection was updated or created, \c false otherwise (no more space in the connection state table)
*/ */
bool TCP_SetConnectionState(const uint16_t Port, bool TCP_SetConnectionState(const uint16_t Port,
const IP_Address_t* RemoteAddress, const IP_Address_t* RemoteAddress,

@ -91,7 +91,7 @@
* *
* \param[in] Buffer Application buffer to check * \param[in] Buffer Application buffer to check
* *
* \return Boolean true if the buffer contains a packet from the host, false otherwise * \return Boolean \c true if the buffer contains a packet from the host, \c false otherwise
*/ */
#define TCP_APP_HAS_RECEIVED_PACKET(Buffer) (Buffer->Ready && (Buffer->Direction == TCP_PACKETDIR_IN)) #define TCP_APP_HAS_RECEIVED_PACKET(Buffer) (Buffer->Ready && (Buffer->Direction == TCP_PACKETDIR_IN))
@ -99,7 +99,7 @@
* *
* \param[in] Buffer Application buffer to check * \param[in] Buffer Application buffer to check
* *
* \return Boolean true if the buffer has been captured by the application for device-to-host transmissions, false otherwise * \return Boolean \c true if the buffer has been captured by the application for device-to-host transmissions, \c false otherwise
*/ */
#define TCP_APP_HAVE_CAPTURED_BUFFER(Buffer) (!(Buffer->Ready) && Buffer->InUse && \ #define TCP_APP_HAVE_CAPTURED_BUFFER(Buffer) (!(Buffer->Ready) && Buffer->InUse && \
(Buffer->Direction == TCP_PACKETDIR_OUT)) (Buffer->Direction == TCP_PACKETDIR_OUT))
@ -108,7 +108,7 @@
* *
* \param[in] Buffer Application buffer to check * \param[in] Buffer Application buffer to check
* *
* \return Boolean true if the buffer may be captured by the application for device-to-host transmissions, false otherwise * \return Boolean \c true if the buffer may be captured by the application for device-to-host transmissions, \c false otherwise
*/ */
#define TCP_APP_CAN_CAPTURE_BUFFER(Buffer) Buffer->InUse #define TCP_APP_CAN_CAPTURE_BUFFER(Buffer) Buffer->InUse

@ -88,7 +88,7 @@ void Webserver_Init(void)
* \param[in] RequestHeader HTTP request made by the host * \param[in] RequestHeader HTTP request made by the host
* \param[in] Command HTTP command to compare the request to * \param[in] Command HTTP command to compare the request to
* *
* \return Boolean true if the command matches the request, false otherwise * \return Boolean \c true if the command matches the request, \c false otherwise
*/ */
static bool IsHTTPCommand(uint8_t* RequestHeader, static bool IsHTTPCommand(uint8_t* RequestHeader,
char* Command) char* Command)

@ -103,7 +103,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -250,7 +250,7 @@ void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -272,7 +272,7 @@ void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -259,7 +259,7 @@ void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -77,7 +77,7 @@ uint8_t GetHIDReportData(void)
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -77,7 +77,7 @@ uint8_t GetHIDReportData(void)
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -77,7 +77,7 @@ uint8_t GetHIDReportData(void)
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -246,7 +246,7 @@ uint8_t SImage_ReadData(void* const Buffer,
/** Function to test if a PIMA event block is waiting to be read in from the attached device. /** Function to test if a PIMA event block is waiting to be read in from the attached device.
* *
* \return True if an event is waiting to be read in from the device, false otherwise * \return True if an event is waiting to be read in from the device, \c false otherwise
*/ */
bool SImage_IsEventReceived(void) bool SImage_IsEventReceived(void)
{ {

@ -82,7 +82,7 @@
* *
* \param[in] x Value to check compile-time constantness of. * \param[in] x Value to check compile-time constantness of.
* *
* \return Boolean true if the given value is known to be a compile time constant, false otherwise. * \return Boolean \c true if the given value is known to be a compile time constant, \c false otherwise.
*/ */
#define GCC_IS_COMPILE_CONST(x) __builtin_constant_p(x) #define GCC_IS_COMPILE_CONST(x) __builtin_constant_p(x)
#else #else

@ -204,7 +204,7 @@
* *
* \param[in,out] Buffer Pointer to a ring buffer structure to insert into. * \param[in,out] Buffer Pointer to a ring buffer structure to insert into.
* *
* \return Boolean \c true if the buffer contains no free space, false otherwise. * \return Boolean \c true if the buffer contains no free space, \c false otherwise.
*/ */
static inline bool RingBuffer_IsEmpty(RingBuffer_t* const Buffer) ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(1); static inline bool RingBuffer_IsEmpty(RingBuffer_t* const Buffer) ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(1);
static inline bool RingBuffer_IsEmpty(RingBuffer_t* const Buffer) static inline bool RingBuffer_IsEmpty(RingBuffer_t* const Buffer)
@ -218,7 +218,7 @@
* *
* \param[in,out] Buffer Pointer to a ring buffer structure to insert into. * \param[in,out] Buffer Pointer to a ring buffer structure to insert into.
* *
* \return Boolean \c true if the buffer contains no free space, false otherwise. * \return Boolean \c true if the buffer contains no free space, \c false otherwise.
*/ */
static inline bool RingBuffer_IsFull(RingBuffer_t* const Buffer) ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(1); static inline bool RingBuffer_IsFull(RingBuffer_t* const Buffer) ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(1);
static inline bool RingBuffer_IsFull(RingBuffer_t* const Buffer) static inline bool RingBuffer_IsFull(RingBuffer_t* const Buffer)

@ -369,7 +369,7 @@
/** Indicates if the current ADC conversion is completed, or still in progress. /** Indicates if the current ADC conversion is completed, or still in progress.
* *
* \return Boolean false if the reading is still taking place, or true if the conversion is * \return Boolean \c false if the reading is still taking place, or true if the conversion is
* complete and ready to be read out with \ref ADC_GetResult(). * complete and ready to be read out with \ref ADC_GetResult().
*/ */
static inline bool ADC_IsReadingComplete(void) ATTR_WARN_UNUSED_RESULT ATTR_ALWAYS_INLINE; static inline bool ADC_IsReadingComplete(void) ATTR_WARN_UNUSED_RESULT ATTR_ALWAYS_INLINE;

@ -131,7 +131,7 @@
* send and/or received. * send and/or received.
* *
* \param[in,out] AudioInterfaceInfo Pointer to a structure containing an Audio Class host configuration and state. * \param[in,out] AudioInterfaceInfo Pointer to a structure containing an Audio Class host configuration and state.
* \param[in] EnableStreaming Boolean true to enable streaming of the specified interface, false to disable * \param[in] EnableStreaming Boolean true to enable streaming of the specified interface, \c false to disable
* *
* \return A value from the \ref USB_Host_SendControlErrorCodes_t enum. * \return A value from the \ref USB_Host_SendControlErrorCodes_t enum.
*/ */

@ -501,7 +501,7 @@
UECONX |= (1 << STALLRQC); UECONX |= (1 << STALLRQC);
} }
/** Determines if the currently selected endpoint is stalled, false otherwise. /** Determines if the currently selected endpoint is stalled, \c false otherwise.
* *
* \ingroup Group_EndpointPacketManagement_AVR8 * \ingroup Group_EndpointPacketManagement_AVR8
* *

@ -236,7 +236,7 @@
} }
/** Determines if the attached device is currently issuing a Remote Wakeup request, requesting /** Determines if the attached device is currently issuing a Remote Wakeup request, requesting
* that the host resume the USB bus and wake up the device, false otherwise. * that the host resume the USB bus and wake up the device, \c false otherwise.
* *
* \return Boolean \c true if the attached device has sent a Remote Wakeup request, \c false otherwise. * \return Boolean \c true if the attached device has sent a Remote Wakeup request, \c false otherwise.
*/ */

@ -501,7 +501,7 @@
(&AVR32_USBB.UECON0CLR)[USB_Endpoint_SelectedEndpoint].stallrqc = true; (&AVR32_USBB.UECON0CLR)[USB_Endpoint_SelectedEndpoint].stallrqc = true;
} }
/** Determines if the currently selected endpoint is stalled, false otherwise. /** Determines if the currently selected endpoint is stalled, \c false otherwise.
* *
* \ingroup Group_EndpointPacketManagement_UC3 * \ingroup Group_EndpointPacketManagement_UC3
* *

@ -233,7 +233,7 @@
} }
/** Determines if the attached device is currently issuing a Remote Wakeup request, requesting /** Determines if the attached device is currently issuing a Remote Wakeup request, requesting
* that the host resume the USB bus and wake up the device, false otherwise. * that the host resume the USB bus and wake up the device, \c false otherwise.
* *
* \return Boolean \c true if the attached device has sent a Remote Wakeup request, \c false otherwise. * \return Boolean \c true if the attached device has sent a Remote Wakeup request, \c false otherwise.
*/ */

@ -495,7 +495,7 @@
USB_Endpoint_SelectedHandle->CTRL &= ~USB_EP_STALL_bm; USB_Endpoint_SelectedHandle->CTRL &= ~USB_EP_STALL_bm;
} }
/** Determines if the currently selected endpoint is stalled, false otherwise. /** Determines if the currently selected endpoint is stalled, \c false otherwise.
* *
* \ingroup Group_EndpointPacketManagement_XMEGA * \ingroup Group_EndpointPacketManagement_XMEGA
* *

@ -263,7 +263,7 @@ uint8_t ISPTarget_TransferSoftSPIByte(const uint8_t Byte)
/** Asserts or deasserts the target's reset line, using the correct polarity as set by the host using a SET PARAM command. /** Asserts or deasserts the target's reset line, using the correct polarity as set by the host using a SET PARAM command.
* When not asserted, the line is tristated so as not to interfere with normal device operation. * When not asserted, the line is tristated so as not to interfere with normal device operation.
* *
* \param[in] ResetTarget Boolean true when the target should be held in reset, false otherwise * \param[in] ResetTarget Boolean true when the target should be held in reset, \c false otherwise
*/ */
void ISPTarget_ChangeTargetResetLine(const bool ResetTarget) void ISPTarget_ChangeTargetResetLine(const bool ResetTarget)
{ {

@ -72,7 +72,7 @@ static void TINYNVM_SendWriteNVMRegister(const uint8_t Address)
/** Busy-waits while the NVM controller is busy performing a NVM operation, such as a FLASH page read. /** Busy-waits while the NVM controller is busy performing a NVM operation, such as a FLASH page read.
* *
* \return Boolean true if the NVM controller became ready within the timeout period, false otherwise * \return Boolean \c true if the NVM controller became ready within the timeout period, \c false otherwise
*/ */
bool TINYNVM_WaitWhileNVMBusBusy(void) bool TINYNVM_WaitWhileNVMBusBusy(void)
{ {
@ -97,7 +97,7 @@ bool TINYNVM_WaitWhileNVMBusBusy(void)
/** Waits while the target's NVM controller is busy performing an operation, exiting if the /** Waits while the target's NVM controller is busy performing an operation, exiting if the
* timeout period expires. * timeout period expires.
* *
* \return Boolean true if the NVM controller became ready within the timeout period, false otherwise * \return Boolean \c true if the NVM controller became ready within the timeout period, \c false otherwise
*/ */
bool TINYNVM_WaitWhileNVMControllerBusy(void) bool TINYNVM_WaitWhileNVMControllerBusy(void)
{ {
@ -121,7 +121,7 @@ bool TINYNVM_WaitWhileNVMControllerBusy(void)
/** Enables the physical TPI interface on the target and enables access to the internal NVM controller. /** Enables the physical TPI interface on the target and enables access to the internal NVM controller.
* *
* \return Boolean true if the TPI interface was enabled successfully, false otherwise * \return Boolean \c true if the TPI interface was enabled successfully, \c false otherwise
*/ */
bool TINYNVM_EnableTPI(void) bool TINYNVM_EnableTPI(void)
{ {
@ -165,7 +165,7 @@ void TINYNVM_DisableTPI(void)
* \param[out] ReadBuffer Buffer to store read data into * \param[out] ReadBuffer Buffer to store read data into
* \param[in] ReadSize Length of the data to read from the device * \param[in] ReadSize Length of the data to read from the device
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool TINYNVM_ReadMemory(const uint16_t ReadAddress, bool TINYNVM_ReadMemory(const uint16_t ReadAddress,
uint8_t* ReadBuffer, uint8_t* ReadBuffer,
@ -198,7 +198,7 @@ bool TINYNVM_ReadMemory(const uint16_t ReadAddress,
* \param[in] WriteBuffer Buffer to source data from * \param[in] WriteBuffer Buffer to source data from
* \param[in] WriteLength Total number of bytes to write to the device (must be an integer multiple of 2) * \param[in] WriteLength Total number of bytes to write to the device (must be an integer multiple of 2)
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool TINYNVM_WriteMemory(const uint16_t WriteAddress, bool TINYNVM_WriteMemory(const uint16_t WriteAddress,
uint8_t* WriteBuffer, uint8_t* WriteBuffer,
@ -245,7 +245,7 @@ bool TINYNVM_WriteMemory(const uint16_t WriteAddress,
* \param[in] EraseCommand NVM erase command to send to the device * \param[in] EraseCommand NVM erase command to send to the device
* \param[in] Address Address inside the memory space to erase * \param[in] Address Address inside the memory space to erase
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool TINYNVM_EraseMemory(const uint8_t EraseCommand, bool TINYNVM_EraseMemory(const uint8_t EraseCommand,
const uint16_t Address) const uint16_t Address)

@ -67,7 +67,7 @@ static void XMEGANVM_SendNVMRegAddress(const uint8_t Register)
/** Busy-waits while the NVM controller is busy performing a NVM operation, such as a FLASH page read or CRC /** Busy-waits while the NVM controller is busy performing a NVM operation, such as a FLASH page read or CRC
* calculation. * calculation.
* *
* \return Boolean true if the NVM controller became ready within the timeout period, false otherwise * \return Boolean \c true if the NVM controller became ready within the timeout period, \c false otherwise
*/ */
bool XMEGANVM_WaitWhileNVMBusBusy(void) bool XMEGANVM_WaitWhileNVMBusBusy(void)
{ {
@ -92,7 +92,7 @@ bool XMEGANVM_WaitWhileNVMBusBusy(void)
/** Waits while the target's NVM controller is busy performing an operation, exiting if the /** Waits while the target's NVM controller is busy performing an operation, exiting if the
* timeout period expires. * timeout period expires.
* *
* \return Boolean true if the NVM controller became ready within the timeout period, false otherwise * \return Boolean \c true if the NVM controller became ready within the timeout period, \c false otherwise
*/ */
bool XMEGANVM_WaitWhileNVMControllerBusy(void) bool XMEGANVM_WaitWhileNVMControllerBusy(void)
{ {
@ -120,7 +120,7 @@ bool XMEGANVM_WaitWhileNVMControllerBusy(void)
/** Enables the physical PDI interface on the target and enables access to the internal NVM controller. /** Enables the physical PDI interface on the target and enables access to the internal NVM controller.
* *
* \return Boolean true if the PDI interface was enabled successfully, false otherwise * \return Boolean \c true if the PDI interface was enabled successfully, \c false otherwise
*/ */
bool XMEGANVM_EnablePDI(void) bool XMEGANVM_EnablePDI(void)
{ {
@ -170,7 +170,7 @@ void XMEGANVM_DisablePDI(void)
* \param[in] CRCCommand NVM CRC command to issue to the target * \param[in] CRCCommand NVM CRC command to issue to the target
* \param[out] CRCDest CRC Destination when read from the target * \param[out] CRCDest CRC Destination when read from the target
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool XMEGANVM_GetMemoryCRC(const uint8_t CRCCommand, bool XMEGANVM_GetMemoryCRC(const uint8_t CRCCommand,
uint32_t* const CRCDest) uint32_t* const CRCDest)
@ -221,7 +221,7 @@ bool XMEGANVM_GetMemoryCRC(const uint8_t CRCCommand,
* \param[out] ReadBuffer Buffer to store read data into * \param[out] ReadBuffer Buffer to store read data into
* \param[in] ReadSize Number of bytes to read * \param[in] ReadSize Number of bytes to read
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool XMEGANVM_ReadMemory(const uint32_t ReadAddress, bool XMEGANVM_ReadMemory(const uint32_t ReadAddress,
uint8_t* ReadBuffer, uint8_t* ReadBuffer,
@ -258,7 +258,7 @@ bool XMEGANVM_ReadMemory(const uint32_t ReadAddress,
* \param[in] WriteAddress Address to write to within the target's address space * \param[in] WriteAddress Address to write to within the target's address space
* \param[in] Byte Byte to write to the target * \param[in] Byte Byte to write to the target
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool XMEGANVM_WriteByteMemory(const uint8_t WriteCommand, bool XMEGANVM_WriteByteMemory(const uint8_t WriteCommand,
const uint32_t WriteAddress, const uint32_t WriteAddress,
@ -291,7 +291,7 @@ bool XMEGANVM_WriteByteMemory(const uint8_t WriteCommand,
* \param[in] WriteBuffer Buffer to source data from * \param[in] WriteBuffer Buffer to source data from
* \param[in] WriteSize Number of bytes to write * \param[in] WriteSize Number of bytes to write
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool XMEGANVM_WritePageMemory(const uint8_t WriteBuffCommand, bool XMEGANVM_WritePageMemory(const uint8_t WriteBuffCommand,
const uint8_t EraseBuffCommand, const uint8_t EraseBuffCommand,
@ -368,7 +368,7 @@ bool XMEGANVM_WritePageMemory(const uint8_t WriteBuffCommand,
* \param[in] EraseCommand NVM erase command to send to the device * \param[in] EraseCommand NVM erase command to send to the device
* \param[in] Address Address inside the memory space to erase * \param[in] Address Address inside the memory space to erase
* *
* \return Boolean true if the command sequence complete successfully * \return Boolean \c true if the command sequence complete successfully
*/ */
bool XMEGANVM_EraseMemory(const uint8_t EraseCommand, bool XMEGANVM_EraseMemory(const uint8_t EraseCommand,
const uint32_t Address) const uint32_t Address)

@ -314,7 +314,7 @@ void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
* *
* \param[in] CurrentItem Pointer to the item the HID report parser is currently working with * \param[in] CurrentItem Pointer to the item the HID report parser is currently working with
* *
* \return Boolean true if the item should be stored into the HID report structure, false if it should be discarded * \return Boolean \c true if the item should be stored into the HID report structure, \c false if it should be discarded
*/ */
bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem) bool CALLBACK_HIDParser_FilterHIDReportItem(HID_ReportItem_t* const CurrentItem)
{ {

@ -171,7 +171,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -138,7 +138,7 @@ void EVENT_USB_Device_StartOfFrame(void)
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, uint8_t* const ReportID, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, uint8_t* const ReportID,
const uint8_t ReportType, void* ReportData, uint16_t* const ReportSize) const uint8_t ReportType, void* ReportData, uint16_t* const ReportSize)

@ -501,7 +501,7 @@ void DataflashManager_ResetDataflashProtections(void)
/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working. /** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
* *
* \return Boolean true if all media chips are working, false otherwise * \return Boolean \c true if all media chips are working, \c false otherwise
*/ */
bool DataflashManager_CheckDataflashOperation(void) bool DataflashManager_CheckDataflashOperation(void)
{ {

@ -86,7 +86,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -150,7 +150,7 @@ bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -188,7 +188,7 @@ static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -210,7 +210,7 @@ static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -233,7 +233,7 @@ static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInt
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -272,7 +272,7 @@ static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInte
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo, static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
const bool IsDataRead) const bool IsDataRead)
@ -325,7 +325,7 @@ static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfa
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {

@ -281,7 +281,7 @@ bool CALLBACK_MS_Device_SCSICommandReceived(USB_ClassInfo_MS_Device_t* const MSI
* \param[out] ReportData Pointer to a buffer where the created report should be stored * \param[out] ReportData Pointer to a buffer where the created report should be stored
* \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent) * \param[out] ReportSize Number of bytes written in the report (or zero if no report is to be sent)
* *
* \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent * \return Boolean \c true to force the sending of the report, \c false to let the library determine if it needs to be sent
*/ */
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
uint8_t* const ReportID, uint8_t* const ReportID,

@ -72,7 +72,7 @@ uint8_t DHCPCommon_SetOption(uint8_t* DHCPOptionList,
* \param[in] Option DHCP option to retrieve to the list * \param[in] Option DHCP option to retrieve to the list
* \param[out] Destination Buffer where the option's data is to be written to if found * \param[out] Destination Buffer where the option's data is to be written to if found
* *
* \return Boolean true if the option was found in the DHCP packet's options list, false otherwise * \return Boolean \c true if the option was found in the DHCP packet's options list, \c false otherwise
*/ */
bool DHCPCommon_GetOption(const uint8_t* DHCPOptionList, bool DHCPCommon_GetOption(const uint8_t* DHCPOptionList,
const uint8_t Option, const uint8_t Option,

@ -196,7 +196,7 @@ static uint16_t DHCPServerApp_FillDHCPHeader(DHCP_Header_t* const DHCPHeader,
* *
* \pre The IP address must be within the same /24 subnet as the virtual webserver. * \pre The IP address must be within the same /24 subnet as the virtual webserver.
* *
* \return Boolean true if the IP has already been leased to a client, false otherwise. * \return Boolean \c true if the IP has already been leased to a client, \c false otherwise.
*/ */
static bool DHCPServerApp_CheckIfIPLeased(const uip_ipaddr_t* const IPAddress) static bool DHCPServerApp_CheckIfIPLeased(const uip_ipaddr_t* const IPAddress)
{ {

@ -501,7 +501,7 @@ void DataflashManager_ResetDataflashProtections(void)
/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working. /** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
* *
* \return Boolean true if all media chips are working, false otherwise * \return Boolean \c true if all media chips are working, \c false otherwise
*/ */
bool DataflashManager_CheckDataflashOperation(void) bool DataflashManager_CheckDataflashOperation(void)
{ {

@ -86,7 +86,7 @@ static SCSI_Request_Sense_Response_t SenseData =
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise * \return Boolean \c true if the command completed successfully, \c false otherwise
*/ */
bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -150,7 +150,7 @@ bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -188,7 +188,7 @@ static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -210,7 +210,7 @@ static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterf
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -233,7 +233,7 @@ static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInt
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {
@ -272,7 +272,7 @@ static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInte
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE) * \param[in] IsDataRead Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo, static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
const bool IsDataRead) const bool IsDataRead)
@ -325,7 +325,7 @@ static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfa
* *
* \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with * \param[in] MSInterfaceInfo Pointer to the Mass Storage class interface structure that the command is associated with
* *
* \return Boolean true if the command completed successfully, false otherwise. * \return Boolean \c true if the command completed successfully, \c false otherwise.
*/ */
static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo) static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
{ {

Loading…
Cancel
Save