/*\r
LUFA Library\r
- Copyright (C) Dean Camera, 2009.\r
+ Copyright (C) Dean Camera, 2010.\r
\r
dean [at] fourwalledcubicle [dot] com\r
www.fourwalledcubicle.com\r
*/\r
\r
/*\r
- Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
- Permission to use, copy, modify, and distribute this software\r
- and its documentation for any purpose and without fee is hereby\r
- granted, provided that the above copyright notice appear in all\r
- copies and that both that the copyright notice and this\r
- permission notice and warranty disclaimer appear in supporting\r
- documentation, and that the name of the author not be used in\r
- advertising or publicity pertaining to distribution of the\r
+ Copyright 2010 Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
+\r
+ Permission to use, copy, modify, distribute, and sell this \r
+ software and its documentation for any purpose is hereby granted\r
+ without fee, provided that the above copyright notice appear in \r
+ all copies and that both that the copyright notice and this\r
+ permission notice and warranty disclaimer appear in supporting \r
+ documentation, and that the name of the author not be used in \r
+ advertising or publicity pertaining to distribution of the \r
software without specific, written prior permission.\r
\r
The author disclaim all warranties with regard to this\r
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
-void EVENT_USB_DeviceAttached(void)\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
-void EVENT_USB_DeviceUnattached(void)\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
-void EVENT_USB_DeviceEnumerationComplete(void)\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_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
- puts_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"));\r
- printf_P(PSTR(" -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);\r
+ printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"\r
+ " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);\r
\r
LEDs_SetAllLEDs(LEDMASK_USB_ERROR);\r
for(;;);\r
}\r
\r
-void EVENT_USB_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
- puts_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"));\r
- printf_P(PSTR(" -- Error Code %d\r\n"), ErrorCode);\r
- printf_P(PSTR(" -- Sub Error Code %d\r\n"), SubErrorCode);\r
- printf_P(PSTR(" -- In State %d\r\n" ESC_FG_WHITE), USB_HostState);\r
+ printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"\r
+ " -- Error Code %d\r\n"\r
+ " -- Sub Error Code %d\r\n"\r
+ " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);\r
\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
/* Set the device configuration to the first configuration (rarely do devices use multiple configurations) */\r
if ((ErrorCode = USB_Host_SetDeviceConfiguration(1)) != HOST_SENDCONTROL_Successful)\r
{\r
- puts_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"));\r
- printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);\r
+ printf_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"\r
+ " -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);\r
\r
/* Indicate error via status LEDs */\r
LEDs_SetAllLEDs(LEDS_LED1);\r
break;\r
}\r
\r
- USB_HostState = HOST_STATE_Configured;\r
- break;\r
- case HOST_STATE_Configured:\r
puts_P(PSTR("Getting Config Data.\r\n"));\r
\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
}\r
\r
puts_P(PSTR("Bluetooth Dongle Enumerated.\r\n"));\r
+ \r
+ /* Initialize the Bluetooth stack */\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
- USB_HostState = HOST_STATE_Ready;\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