this software.\r
*/\r
\r
-/*\r
- Bluetooth Dongle host demo application.\r
- \r
- ** NOT CURRENTLY FUNCTIONAL - DO NOT USE **\r
-*/\r
+/** \file\r
+ *\r
+ * Main source file for the BluetoothHost demo. This file contains the main tasks of\r
+ * the demo and is responsible for the initial application hardware configuration.\r
+ */\r
\r
#include "BluetoothHost.h"\r
\r
+/** Bluetooth configuration structure. This structure configures the bluetooth stack's user alterable settings. */\r
Bluetooth_Device_t Bluetooth_DeviceConfiguration =\r
{\r
Class: (DEVICE_CLASS_SERVICE_CAPTURING | DEVICE_CLASS_MAJOR_COMPUTER | DEVICE_CLASS_MINOR_COMPUTER_PALM),\r
Name: "LUFA Bluetooth Demo"\r
};\r
\r
-\r
+/** Main program entry point. This routine configures the hardware required by the application, then\r
+ * enters a loop to run the application tasks in sequence.\r
+ */\r
int main(void)\r
{\r
SetupHardware();\r
+\r
+ puts_P(PSTR(ESC_FG_CYAN "Bluetooth Host Demo running.\r\n" ESC_FG_WHITE));\r
\r
LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);\r
+ sei();\r
\r
- puts_P(PSTR(ESC_FG_CYAN "Bluetooth Host Demo running.\r\n" ESC_FG_WHITE));\r
- \r
for (;;)\r
{\r
- Bluetooth_Stack_Task();\r
- Bluetooth_Management_Task();\r
+ Bluetooth_Stack_USBTask();\r
+ Bluetooth_Host_Task();\r
USB_USBTask();\r
}\r
}\r
\r
+/** Configures the board hardware and chip peripherals for the demo's functionality. */\r
void SetupHardware(void)\r
{\r
/* Disable watchdog if enabled by bootloader/fuses */\r
USB_Init();\r
}\r
\r
+/** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and\r
+ * starts the library USB task to begin the enumeration and USB management process.\r
+ */\r
void EVENT_USB_Host_DeviceAttached(void)\r
{\r
puts_P(PSTR(ESC_FG_GREEN "Device Attached.\r\n" ESC_FG_WHITE));\r
-\r
LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);\r
}\r
\r
+/** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and\r
+ * stops the library USB task management process.\r
+ */\r
void EVENT_USB_Host_DeviceUnattached(void)\r
{\r
puts_P(PSTR(ESC_FG_GREEN "\r\nDevice Unattached.\r\n" ESC_FG_WHITE));\r
-\r
LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);\r
}\r
\r
+/** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully\r
+ * enumerated by the host and is now ready to be used by the application.\r
+ */\r
void EVENT_USB_Host_DeviceEnumerationComplete(void)\r
{\r
LEDs_SetAllLEDs(LEDMASK_USB_READY);\r
}\r
\r
-void EVENT_USB_Host_HostError(uint8_t ErrorCode)\r
+/** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */\r
+void EVENT_USB_Host_HostError(const uint8_t ErrorCode)\r
{\r
USB_ShutDown();\r
\r
for(;;);\r
}\r
\r
-void EVENT_USB_Host_DeviceEnumerationFailed(uint8_t ErrorCode, uint8_t SubErrorCode)\r
+/** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while\r
+ * enumerating an attached USB device.\r
+ */\r
+void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode, const uint8_t SubErrorCode)\r
{\r
printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"\r
" -- Error Code %d\r\n"\r
LEDs_SetAllLEDs(LEDMASK_USB_ERROR);\r
}\r
\r
-void Bluetooth_Management_Task(void)\r
+/** Task to set the configuration of the attached device after it has been enumerated. */\r
+void Bluetooth_Host_Task(void)\r
{\r
uint8_t ErrorCode;\r
\r
/* Get and process the configuration descriptor data */\r
if ((ErrorCode = ProcessDeviceDescriptor()) != SuccessfulDeviceRead)\r
{\r
- if (ErrorCode == ControlErrorDuringDeviceRead)\r
+ if (ErrorCode == DevControlError)\r
puts_P(PSTR(ESC_FG_RED "Control Error (Get Device).\r\n"));\r
else\r
puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));\r
/* Get and process the configuration descriptor data */\r
if ((ErrorCode = ProcessConfigurationDescriptor()) != SuccessfulConfigRead)\r
{\r
- if (ErrorCode == ControlErrorDuringConfigRead)\r
+ if (ErrorCode == ControlError)\r
puts_P(PSTR(ESC_FG_RED "Control Error (Get Configuration).\r\n"));\r
else\r
puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));\r
puts_P(PSTR("Bluetooth Dongle Enumerated.\r\n"));\r
\r
/* Initialize the Bluetooth stack */\r
- Bluetooth_State_Init();\r
+ Bluetooth_Stack_Init();\r
\r
USB_HostState = HOST_STATE_Configured;\r
break;\r
}\r
}\r
+\r
+/** Bluetooth stack callback event for when the Bluetooth stack has fully initialized using the attached\r
+ * Bluetooth dongle.\r
+ */\r
+void Bluetooth_StackInitialized(void)\r
+{\r
+ printf_P(PSTR("Stack initialized with local address %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),\r
+ Bluetooth_State.LocalBDADDR[5], Bluetooth_State.LocalBDADDR[4], Bluetooth_State.LocalBDADDR[3],\r
+ Bluetooth_State.LocalBDADDR[2], Bluetooth_State.LocalBDADDR[1], Bluetooth_State.LocalBDADDR[0]);\r
+}\r
+\r
+/** Bluetooth stack callback event for a Bluetooth connection request. When this callback fires, the\r
+ * user application must indicate if the connection is to be allowed or rejected.\r
+ *\r
+ * \param[in] RemoteAddress Bluetooth address of the remote device attempting the connection\r
+ *\r
+ * \return Boolean true to accept the connection, false to reject it\r
+ */\r
+bool Bluetooth_ConnectionRequest(const uint8_t* RemoteAddress)\r
+{\r
+ printf_P(PSTR("Connection Request from Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),\r
+ RemoteAddress[5], RemoteAddress[4], RemoteAddress[3], RemoteAddress[2],\r
+ RemoteAddress[1], RemoteAddress[0]);\r
+\r
+ /* Always accept connections from remote devices */\r
+ return true;\r
+}\r
+\r
+/** Bluetooth stack callback event for a completed Bluetooth connection. When this callback is made,\r
+ * the connection information can be accessed through the global \ref Bluetooth_Connection structure.\r
+ */\r
+void Bluetooth_ConnectionComplete(void)\r
+{\r
+ printf_P(PSTR("Connection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"), \r
+ Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],\r
+ Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],\r
+ Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0]);\r
+}\r
+\r
+/** Bluetooth stack callback event for a completed Bluetooth disconnection. When this callback is made,\r
+ * the connection information in the global \ref Bluetooth_Connection structure is invalidated with the\r
+ * exception of the RemoteAddress element, which can be used to determine the address of the device that\r
+ * was disconnected.\r
+ */\r
+void Bluetooth_DisconnectionComplete(void)\r
+{\r
+ printf_P(PSTR("Disconnection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"), \r
+ Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],\r
+ Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],\r
+ Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0]);\r
+}\r
+\r
+/** Bluetooth stack callback event for a Bluetooth ACL Channel connection request. When is callback fires,\r
+ * the user application must indicate if the channel connection should be rejected or not, based on the \r
+ * protocol (PSM) value of the requested channel.\r
+ *\r
+ * \param PSM Protocol PSM value for the requested channel\r
+ *\r
+ * \return Boolean true to accept the channel connection request, false to reject it\r
+ */\r
+bool Bluetooth_ChannelConnectionRequest(const uint16_t PSM)\r
+{\r
+ /* Always accept channel connection requests regardless of PSM */\r
+ return true;\r
+}\r
+\r
+/** Bluetooth stack callback event for a non-signal ACL packet reception. This callback fires once a connection\r
+ * to a remote Bluetooth device has been made, and the remote device has sent a non-signalling ACL packet.\r
+ *\r
+ * \param[in] Data Pointer to a buffer where the received data is stored\r
+ * \param[in] DataLen Length of the packet data, in bytes\r
+ * \param[in] Channel Bluetooth ACL data channel information structure for the packet's destination channel\r
+ */\r
+void Bluetooth_PacketReceived(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel)\r
+{\r
+ switch (Channel->PSM)\r
+ {\r
+ case CHANNEL_PSM_SDP:\r
+ /* Service Discovery Protocol packet */\r
+ ServiceDiscovery_ProcessPacket(Data, Channel);\r
+ break;\r
+ default:\r
+ /* Unknown Protocol packet */\r
+ printf_P(PSTR("Packet Received (Channel 0x%04X, PSM: 0x%02x):\r\n"), Channel->LocalNumber, Channel->PSM);\r
+ for (uint16_t Byte = 0; Byte < DataLen; Byte++)\r
+ printf_P(PSTR("0x%02X "), ((uint8_t*)Data)[Byte]);\r
+ puts_P(PSTR("\r\n"));\r
+ \r
+ break;\r
+ }\r
+}\r
projects / pub / USBasp.git / blobdiff