Demos/Host/Incomplete/BluetoothHost/BluetoothHost.c

   1 /*
   2              LUFA Library
   3      Copyright (C) Dean Camera, 2010.
   4
   5   dean [at] fourwalledcubicle [dot] com
   6       www.fourwalledcubicle.com
   7 */
   8
   9 /*
  10   Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)
  11
  12   Permission to use, copy, modify, distribute, and sell this
  13   software and its documentation for any purpose is hereby granted
  14   without fee, provided that the above copyright notice appear in
  15   all copies and that both that the copyright notice and this
  16   permission notice and warranty disclaimer appear in supporting
  17   documentation, and that the name of the author not be used in
  18   advertising or publicity pertaining to distribution of the
  19   software without specific, written prior permission.
  20
  21   The author disclaim all warranties with regard to this
  22   software, including all implied warranties of merchantability
  23   and fitness.  In no event shall the author be liable for any
  24   special, indirect or consequential damages or any damages
  25   whatsoever resulting from loss of use, data or profits, whether
  26   in an action of contract, negligence or other tortious action,
  27   arising out of or in connection with the use or performance of
  28   this software.
  29 */
  30
  31 /** \file
  32  *
  33  *  Main source file for the BluetoothHost demo. This file contains the main tasks of
  34  *  the demo and is responsible for the initial application hardware configuration.
  35  */
  36
  37 #include "BluetoothHost.h"
  38
  39 /** Bluetooth configuration structure. This structure configures the Bluetooth stack's user alterable settings. */
  40 Bluetooth_Device_t Bluetooth_DeviceConfiguration =
  41         {
  42                 Class:   (DEVICE_CLASS_SERVICE_CAPTURING | DEVICE_CLASS_MAJOR_COMPUTER | DEVICE_CLASS_MINOR_COMPUTER_PALM),
  43                 PINCode: "0000",
  44                 Name:    "LUFA Bluetooth Demo"
  45         };
  46
  47 /** Main program entry point. This routine configures the hardware required by the application, then
  48  *  enters a loop to run the application tasks in sequence.
  49  */
  50 int main(void)
  51 {
  52         SetupHardware();
  53
  54         puts_P(PSTR(ESC_FG_CYAN "Bluetooth Host Demo running.\r\n" ESC_FG_WHITE));
  55
  56         LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
  57         sei();
  58
  59         for (;;)
  60         {
  61                 Bluetooth_Channel_t* RFCOMMChannel = Bluetooth_GetChannelData(CHANNEL_PSM_RFCOMM, CHANNEL_SEARCH_PSM);
  62
  63                 /* If an RFCOMM channel is open, service the RFCOMM logical channels */
  64                 if (RFCOMMChannel)
  65                   RFCOMM_ServiceChannels(RFCOMMChannel);
  66
  67                 Bluetooth_Stack_USBTask();
  68                 Bluetooth_Host_Task();
  69                 USB_USBTask();
  70         }
  71 }
  72
  73 /** Configures the board hardware and chip peripherals for the demo's functionality. */
  74 void SetupHardware(void)
  75 {
  76         /* Disable watchdog if enabled by bootloader/fuses */
  77         MCUSR &= ~(1 << WDRF);
  78         wdt_disable();
  79
  80         /* Disable clock division */
  81         clock_prescale_set(clock_div_1);
  82
  83         /* Hardware Initialization */
  84         SerialStream_Init(9600, false);
  85         LEDs_Init();
  86         USB_Init();
  87 }
  88
  89 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
  90  *  starts the library USB task to begin the enumeration and USB management process.
  91  */
  92 void EVENT_USB_Host_DeviceAttached(void)
  93 {
  94         puts_P(PSTR(ESC_FG_GREEN "Device Attached.\r\n" ESC_FG_WHITE));
  95         LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
  96 }
  97
  98 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
  99  *  stops the library USB task management process.
 100  */
 101 void EVENT_USB_Host_DeviceUnattached(void)
 102 {
 103         puts_P(PSTR(ESC_FG_GREEN "\r\nDevice Unattached.\r\n" ESC_FG_WHITE));
 104         LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
 105 }
 106
 107 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
 108  *  enumerated by the host and is now ready to be used by the application.
 109  */
 110 void EVENT_USB_Host_DeviceEnumerationComplete(void)
 111 {
 112         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 113 }
 114
 115 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
 116 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
 117 {
 118         USB_ShutDown();
 119
 120         printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
 121                                  " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
 122
 123         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 124         for(;;);
 125 }
 126
 127 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
 128  *  enumerating an attached USB device.
 129  */
 130 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode, const uint8_t SubErrorCode)
 131 {
 132         printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
 133                                  " -- Error Code %d\r\n"
 134                                  " -- Sub Error Code %d\r\n"
 135                                  " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
 136
 137         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 138 }
 139
 140 /** Task to set the configuration of the attached device after it has been enumerated. */
 141 void Bluetooth_Host_Task(void)
 142 {
 143         uint8_t ErrorCode;
 144
 145         switch (USB_HostState)
 146         {
 147                 case HOST_STATE_Addressed:
 148                         puts_P(PSTR("Getting Device Data.\r\n"));
 149
 150                         /* Get and process the configuration descriptor data */
 151                         if ((ErrorCode = ProcessDeviceDescriptor()) != SuccessfulDeviceRead)
 152                         {
 153                                 if (ErrorCode == DevControlError)
 154                                   puts_P(PSTR(ESC_FG_RED "Control Error (Get Device).\r\n"));
 155                                 else
 156                                   puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));
 157
 158                                 printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
 159
 160                                 /* Indicate error via status LEDs */
 161                                 LEDs_SetAllLEDs(LEDS_LED1);
 162
 163                                 /* Wait until USB device disconnected */
 164                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 165                                 break;
 166                         }
 167
 168                         puts_P(PSTR("Bluetooth Dongle Detected.\r\n"));
 169
 170                         /* Set the device configuration to the first configuration (rarely do devices use multiple configurations) */
 171                         if ((ErrorCode = USB_Host_SetDeviceConfiguration(1)) != HOST_SENDCONTROL_Successful)
 172                         {
 173                                 printf_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"
 174                                                          " -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
 175
 176                                 /* Indicate error via status LEDs */
 177                                 LEDs_SetAllLEDs(LEDS_LED1);
 178
 179                                 /* Wait until USB device disconnected */
 180                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 181                                 break;
 182                         }
 183
 184                         puts_P(PSTR("Getting Config Data.\r\n"));
 185
 186                         /* Get and process the configuration descriptor data */
 187                         if ((ErrorCode = ProcessConfigurationDescriptor()) != SuccessfulConfigRead)
 188                         {
 189                                 if (ErrorCode == ControlError)
 190                                   puts_P(PSTR(ESC_FG_RED "Control Error (Get Configuration).\r\n"));
 191                                 else
 192                                   puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));
 193
 194                                 printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
 195
 196                                 /* Indicate error via status LEDs */
 197                                 LEDs_SetAllLEDs(LEDS_LED1);
 198
 199                                 /* Wait until USB device disconnected */
 200                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 201                                 break;
 202                         }
 203
 204                         puts_P(PSTR("Bluetooth Dongle Enumerated.\r\n"));
 205
 206                         /* Initialize the Bluetooth stack */
 207                         Bluetooth_Stack_Init();
 208
 209                         USB_HostState = HOST_STATE_Configured;
 210                         break;
 211         }
 212 }
 213
 214 /** Bluetooth stack callback event for when the Bluetooth stack has fully initialized using the attached
 215  *  Bluetooth dongle.
 216  */
 217 void Bluetooth_StackInitialized(void)
 218 {
 219         printf_P(PSTR("Stack initialized with local address %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 220                  Bluetooth_State.LocalBDADDR[5], Bluetooth_State.LocalBDADDR[4], Bluetooth_State.LocalBDADDR[3],
 221                  Bluetooth_State.LocalBDADDR[2], Bluetooth_State.LocalBDADDR[1], Bluetooth_State.LocalBDADDR[0]);
 222
 223         /* Reinitialize the services placed on top of the Bluetooth stack ready for new connections */
 224         RFCOMM_Initialize();
 225 }
 226
 227 /** Bluetooth stack callback event for a Bluetooth connection request. When this callback fires, the
 228  *  user application must indicate if the connection is to be allowed or rejected.
 229  *
 230  *  \param[in] RemoteAddress  Bluetooth address of the remote device attempting the connection
 231  *
 232  *  \return Boolean true to accept the connection, false to reject it
 233  */
 234 bool Bluetooth_ConnectionRequest(const uint8_t* RemoteAddress)
 235 {
 236         printf_P(PSTR("Connection Request from Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 237                  RemoteAddress[5], RemoteAddress[4], RemoteAddress[3], RemoteAddress[2],
 238                  RemoteAddress[1], RemoteAddress[0]);
 239
 240         /* Always accept connections from remote devices */
 241         return true;
 242 }
 243
 244 /** Bluetooth stack callback event for a completed Bluetooth connection. When this callback is made,
 245  *  the connection information can be accessed through the global \ref Bluetooth_Connection structure.
 246  */
 247 void Bluetooth_ConnectionComplete(void)
 248 {
 249         printf_P(PSTR("Connection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 250                  Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],
 251                  Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],
 252                  Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0]);
 253
 254         LEDs_SetAllLEDs(LEDMASK_USB_BUSY);
 255 }
 256
 257 /** Bluetooth stack callback event for a completed Bluetooth disconnection. When this callback is made,
 258  *  the connection information in the global \ref Bluetooth_Connection structure is invalidated with the
 259  *  exception of the RemoteAddress element, which can be used to determine the address of the device that
 260  *  was disconnected.
 261  */
 262 void Bluetooth_DisconnectionComplete(void)
 263 {
 264         printf_P(PSTR("Disconnection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 265                  Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],
 266                  Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],
 267                  Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0]);
 268
 269         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 270 }
 271
 272 /** Bluetooth stack callback event for a Bluetooth ACL Channel connection request. When is callback fires,
 273  *  the user application must indicate if the channel connection should be rejected or not, based on the
 274  *  protocol (PSM) value of the requested channel.
 275  *
 276  *  \param[in] PSM  Protocol PSM value for the requested channel
 277  *
 278  *  \return Boolean true to accept the channel connection request, false to reject it
 279  */
 280 bool Bluetooth_ChannelConnectionRequest(const uint16_t PSM)
 281 {
 282         /* Always accept channel connection requests regardless of PSM */
 283         return true;
 284 }
 285
 286 /** Bluetooth stack callback event for a non-signal ACL packet reception. This callback fires once a connection
 287  *  to a remote Bluetooth device has been made, and the remote device has sent a non-signalling ACL packet.
 288  *
 289  *  \param[in] Data     Pointer to a buffer where the received data is stored
 290  *  \param[in] DataLen  Length of the packet data, in bytes
 291  *  \param[in] Channel  Bluetooth ACL data channel information structure for the packet's destination channel
 292  */
 293 void Bluetooth_PacketReceived(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel)
 294 {
 295         /* Run the correct packet handler based on the received packet's PSM, which indicates the service being carried */
 296         switch (Channel->PSM)
 297         {
 298                 case CHANNEL_PSM_SDP:
 299                         /* Service Discovery Protocol packet */
 300                         SDP_ProcessPacket(Data, Channel);
 301                         break;
 302                 case CHANNEL_PSM_RFCOMM:
 303                         /* RFCOMM (Serial Port) Protocol packet */
 304                         RFCOMM_ProcessPacket(Data, Channel);
 305                         break;
 306                 default:
 307                         /* Unknown Protocol packet */
 308                         printf_P(PSTR("Unknown Packet Received (Channel 0x%04X, PSM: 0x%02X, Len: 0x%04X):\r\n"),
 309                                       Channel->LocalNumber, Channel->PSM, DataLen);
 310                         break;
 311         }
 312 }