Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
Erik Strand
lufa
Commits
1f682ca2
Commit
1f682ca2
authored
Apr 15, 2010
by
Dean Camera
Browse files
Minor documentation improvements.
parent
3eb81df9
Changes
12
Hide whitespace changes
Inline
Side-by-side
Demos/Host/Incomplete/BluetoothHost/BluetoothHost.c
View file @
1f682ca2
...
...
@@ -199,7 +199,7 @@ void Bluetooth_Host_Task(void)
/** Bluetooth stack callback event for a Bluetooth connection request. When this callback fires, the
* user application must indicate if the connection is to be allowed or rejected.
*
* \param RemoteAddress Bluetooth address of the remote device attempting the connection
* \param
[in]
RemoteAddress Bluetooth address of the remote device attempting the connection
*
* \return Boolean true to accept the connection, false to reject it
*/
...
...
@@ -241,9 +241,9 @@ void Bluetooth_DisconnectionComplete(void)
/** Bluetooth stack callback event for a non-signal ACL packet reception. This callback fires once a connection
* to a remote Bluetooth device has been made, and the remote device has sent a non-signalling ACL packet.
*
* \param Data Pointer to a buffer where the received data is stored
* \param DataLen Length of the packet data, in bytes
* \param Channel Bluetooth ACL data channel information structure for the packet's destination channel
* \param
[in]
Data Pointer to a buffer where the received data is stored
* \param
[in]
DataLen Length of the packet data, in bytes
* \param
[in]
Channel Bluetooth ACL data channel information structure for the packet's destination channel
*/
void
Bluetooth_PacketReceived
(
void
*
Data
,
uint16_t
DataLen
,
Bluetooth_Channel_t
*
Channel
)
{
...
...
Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.c
View file @
1f682ca2
...
...
@@ -193,10 +193,10 @@ static void Bluetooth_ProcessIncommingACLPackets(void)
/** Sends a packet to the remote device on the specified channel.
*
* \param Data Pointer to a buffer where the data is to be sourced from
* \param DataLen Length of the data to send
* \param Channel Channel information structure containing the destination channel's information, NULL to send
* to the remote device's signalling channel
* \param
[in]
Data Pointer to a buffer where the data is to be sourced from
* \param
[in]
DataLen Length of the data to send
* \param
[in]
Channel Channel information structure containing the destination channel's information, NULL to send
*
to the remote device's signalling channel
*
* \return A value from the \ref BT_SendPacket_ErrorCodes_t enum
*/
...
...
@@ -247,7 +247,7 @@ uint8_t Bluetooth_SendPacket(void* Data, uint16_t DataLen, Bluetooth_Channel_t*
* repeatedly called. The returned channel is unusable by the user application until its State
* element has progressed to the Open state.
*
* \param PSM PSM of the service that the channel is to be opened for
* \param
[in]
PSM PSM of the service that the channel is to be opened for
*
* \return Pointer to the channel information structure of the opened channel, or NULL if no free channels
*/
...
...
@@ -311,7 +311,7 @@ Bluetooth_Channel_t* Bluetooth_OpenChannel(uint16_t PSM)
* returned channel is unusable by the user application upon return however the channel is not completely
* closed until its State element has progressed to the Closed state.
*
* \param Channel Channel information structure of the channel to close
* \param
[in,out]
Channel Channel information structure of the channel to close
*/
void
Bluetooth_CloseChannel
(
Bluetooth_Channel_t
*
Channel
)
{
...
...
@@ -346,7 +346,7 @@ void Bluetooth_CloseChannel(Bluetooth_Channel_t* Channel)
/** Internal Bluetooth stack Signal Command processing routine for a Connection Request command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_ConnectionReq
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -419,7 +419,7 @@ static inline void Bluetooth_Signal_ConnectionReq(BT_Signal_Header_t* SignalComm
/** Internal Bluetooth stack Signal Command processing routine for a Connection Response command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_ConnectionResp
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -450,7 +450,7 @@ static inline void Bluetooth_Signal_ConnectionResp(BT_Signal_Header_t* SignalCom
/** Internal Bluetooth stack Signal Command processing routine for a Configuration Request command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_ConfigurationReq
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -537,7 +537,7 @@ static inline void Bluetooth_Signal_ConfigurationReq(BT_Signal_Header_t* SignalC
/** Internal Bluetooth stack Signal Command processing routine for a Configuration Response command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_ConfigurationResp
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -581,7 +581,7 @@ static inline void Bluetooth_Signal_ConfigurationResp(BT_Signal_Header_t* Signal
/** Internal Bluetooth stack Signal Command processing routine for a Disconnection Request command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_DisconnectionReq
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -627,7 +627,7 @@ static inline void Bluetooth_Signal_DisconnectionReq(BT_Signal_Header_t* SignalC
/** Internal Bluetooth stack Signal Command processing routine for a Disconnection Response command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_DisconnectionResp
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -652,7 +652,7 @@ static inline void Bluetooth_Signal_DisconnectionResp(BT_Signal_Header_t* Signal
/** Internal Bluetooth stack Signal Command processing routine for an Echo Request command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_EchoReq
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
@@ -678,7 +678,7 @@ static inline void Bluetooth_Signal_EchoReq(BT_Signal_Header_t* SignalCommandHea
/** Internal Bluetooth stack Signal Command processing routine for an Information Request command.
*
* \param SignalCommandHeader Pointer to the start of the received packet's Signal Command header
* \param
[in]
SignalCommandHeader Pointer to the start of the received packet's Signal Command header
*/
static
inline
void
Bluetooth_Signal_InformationReq
(
BT_Signal_Header_t
*
SignalCommandHeader
)
{
...
...
Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothHCICommands.c
View file @
1f682ca2
...
...
@@ -311,9 +311,9 @@ void Bluetooth_HCITask(void)
/** Sends a Bluetooth HCI control command to the attached Bluetooth device.
*
* \param HCICommandHeader HCI command header to send to the attached device
* \param Parameters Pointer to the source of the control parameters (if any)
* \param ParameterLength Length of the parameters to send in bytes
* \param
[in]
HCICommandHeader HCI command header to send to the attached device
* \param
[in]
Parameters Pointer to the source of the control parameters (if any)
* \param
[in]
ParameterLength Length of the parameters to send in bytes
*
* \return A value from the USB_Host_SendControlErrorCodes_t enum.
*/
...
...
Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.c
View file @
1f682ca2
...
...
@@ -67,9 +67,9 @@ void Bluetooth_Stack_USBTask(void)
/** Retrieves the channel information structure with the given local or remote channel number from the channel list.
*
* \param ChannelNumber Channel number to search for in the channel list
* \param SearchByRemoteChannel Indicated whether to search for a channel information structure by the given remote channel
* or local channel number
* \param
[in]
ChannelNumber Channel number to search for in the channel list
* \param
[in]
SearchByRemoteChannel Indicated whether to search for a channel information structure by the given remote channel
*
or local channel number
*
* \return Pointer to the matching channel information structure in the channel table if found, NULL otherwise
*/
...
...
LUFA/Common/Attributes.h
View file @
1f682ca2
...
...
@@ -122,12 +122,16 @@
#endif
/** Places the function in one of the initialization sections, which execute before the main function
* of the application. The init function number can be specified as "x", as an integer. Refer to the
* avr-libc manual for more information on the initialization sections.
* of the application. Refer to the avr-libc manual for more information on the initialization sections.
*
* \param[in] x Initialization section number where the function should be placed
*/
#define ATTR_INIT_SECTION(x) __attribute__ ((naked, section (".init" #x )))
/** Marks a function as an alias for another function of name "x". */
/** Marks a function as an alias for another function.
*
* \param[in] x Name of the function which the given function name should alias
*/
#define ATTR_ALIAS(x) __attribute__ ((alias( #x )))
#endif
...
...
LUFA/Doxygen.conf
View file @
1f682ca2
...
...
@@ -296,7 +296,7 @@ TYPEDEF_HIDES_STRUCT = YES
# 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0,
# corresponding to a cache size of 2^16 = 65536 symbols
SYMBOL_CACHE_SIZE
=
0
SYMBOL_CACHE_SIZE
=
1
#---------------------------------------------------------------------------
# Build related configuration options
...
...
@@ -642,7 +642,7 @@ EXCLUDE_SYMBOLS = __*
# directories that contain example code fragments that are included (see
# the \include command).
EXAMPLE_PATH
=
EXAMPLE_PATH
=
../
# If the value of the EXAMPLE_PATH tag contains directories, you can use the
# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
...
...
LUFA/License.txt
0 → 100644
View file @
1f682ca2
Permission to use, copy, modify, and distribute this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all
copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness. In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
LUFA/ManPages/Donating.txt
View file @
1f682ca2
...
...
@@ -15,7 +15,7 @@
* donations are <i>greatly</i> appreciated.
*
* Note that commercial entities can remove the attribution portion of the LUFA licence by a one-time fee - see
* \ref Page_Licence for more details (<b>Note: Please do NOT pay this in advance through the donation link below -
* \ref Page_Licence
Info
for more details (<b>Note: Please do NOT pay this in advance through the donation link below -
* contact author for payment details.</b>).
*
* \image html "http://www.pledgie.com/campaigns/6927.png?skin_name=chrome"
...
...
LUFA/ManPages/LUFAvsAtmelStack.txt
View file @
1f682ca2
...
...
@@ -12,7 +12,7 @@
* official Atmel USB stack. Below are just some of the advantages to choosing LUFA over the official stack.
*
* - <b>Licensing:</b>
* LUFA is released under a very permissive MIT license (see \ref Page_Licence), while the Atmel stack carries several
* LUFA is released under a very permissive MIT license (see \ref Page_Licence
Info
), while the Atmel stack carries several
* restrictions as to how and where it can be used. LUFA's licensing should be suitable for both Commercial and Non-Commercial
* entities alike.
*
...
...
LUFA/ManPages/Licence.txt
→
LUFA/ManPages/Licence
Info
.txt
View file @
1f682ca2
...
...
@@ -5,7 +5,7 @@
*/
/**
* \page Page_Licence Source Code Licence
* \page Page_Licence
Info
Source Code Licence
*
* The LUFA library is currently released under the MIT licence, included below.
*
...
...
@@ -16,23 +16,5 @@
* addition to three free hours of consultation with the library author, and priority support.
* Please contact the author for more information via the address shown on on \ref Page_Resources.
*
* \verbatim
* Permission to use, copy, modify, and distribute this software
* and its documentation for any purpose is hereby granted without
* fee, provided that the above copyright notice appear in all
* copies and that both that the copyright notice and this
* permission notice and warranty disclaimer appear in supporting
* documentation, and that the name of the author not be used in
* advertising or publicity pertaining to distribution of the
* software without specific, written prior permission.
*
* The author disclaim all warranties with regard to this
* software, including all implied warranties of merchantability
* and fitness. In no event shall the author be liable for any
* special, indirect or consequential damages or any damages
* whatsoever resulting from loss of use, data or profits, whether
* in an action of contract, negligence or other tortious action,
* arising out of or in connection with the use or performance of
* this software.
* \endverbatim
* \verbinclude License.txt
*/
LUFA/ManPages/MainPage.txt
View file @
1f682ca2
...
...
@@ -13,7 +13,7 @@
*
* <b>LUFA is donationware. For author and donation information, see \ref Page_Donating.</b>
*
* LUFA is an open-source USB library for the USB-enabled AVR microcontrollers, released under the MIT license (see \ref Page_Licence).
* LUFA is an open-source USB library for the USB-enabled AVR microcontrollers, released under the MIT license (see \ref Page_Licence
Info
).
* It supports a large number of USB AVR models and boards (see \ref Page_DeviceSupport). It is designed to provide an easy to use,
* feature rich framework for the development of USB peripherals and hosts.
*
...
...
@@ -37,7 +37,7 @@
* - \subpage Page_WhyUseLUFA What are the advantages of using LUFA?
* - \subpage Page_LUFAvsAtmelStack How does LUFA compare to the Atmel USB AVR stack?
* - \subpage Page_AlternativeStacks Alternative USB AVR Stacks
* - \subpage Page_Licence Project source licence and commercial use information
* - \subpage Page_Licence
Info
Project source licence and commercial use information
* - \subpage Page_Donating Donating to support this project
* - \subpage Page_LibraryApps Overview of included Demos, Bootloaders and Projects
*/
LUFA/ManPages/SoftwareBootloaderJump.txt
View file @
1f682ca2
...
...
@@ -31,8 +31,8 @@
* #define MAGIC_BOOT_KEY 0xDC42ACCA
* #define BOOTLOADER_START_ADDRESS ({FLASH_SIZE_BYTES} - {BOOTLOADER_SEC_SIZE_BYTES})
*
*
int
Bootloader_Jump_Check(void) ATTR_INIT_SECTION(3);
*
int
Bootloader_Jump_Check(void)
*
void
Bootloader_Jump_Check(void) ATTR_INIT_SECTION(3);
*
void
Bootloader_Jump_Check(void)
* {
* // If the bootloader key is correct, clear it and jump to the bootloader
* if (Boot_Key == MAGIC_BOOT_KEY)
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment