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                 if (Bluetooth_Connection.IsConnected)
  62                 {
  63                         Bluetooth_Channel_t* RFCOMMChannel = Bluetooth_GetChannelData(CHANNEL_PSM_RFCOMM, CHANNEL_SEARCH_PSM);
  64
  65                         /* If an RFCOMM channel is open, service the RFCOMM logical channels */
  66                         if (RFCOMMChannel)
  67                           RFCOMM_ServiceChannels(RFCOMMChannel);
  68                 }
  69
  70                 Bluetooth_Stack_USBTask();
  71                 Bluetooth_Host_Task();
  72                 USB_USBTask();
  73         }
  74 }
  75
  76 /** Configures the board hardware and chip peripherals for the demo's functionality. */
  77 void SetupHardware(void)
  78 {
  79         /* Disable watchdog if enabled by bootloader/fuses */
  80         MCUSR &= ~(1 << WDRF);
  81         wdt_disable();
  82
  83         /* Disable clock division */
  84         clock_prescale_set(clock_div_1);
  85
  86         /* Hardware Initialization */
  87         SerialStream_Init(9600, false);
  88         LEDs_Init();
  89         USB_Init();
  90 }
  91
  92 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
  93  *  starts the library USB task to begin the enumeration and USB management process.
  94  */
  95 void EVENT_USB_Host_DeviceAttached(void)
  96 {
  97         puts_P(PSTR(ESC_FG_GREEN "Device Attached.\r\n" ESC_FG_WHITE));
  98         LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
  99 }
 100
 101 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
 102  *  stops the library USB task management process.
 103  */
 104 void EVENT_USB_Host_DeviceUnattached(void)
 105 {
 106         puts_P(PSTR(ESC_FG_GREEN "\r\nDevice Unattached.\r\n" ESC_FG_WHITE));
 107         LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
 108 }
 109
 110 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
 111  *  enumerated by the host and is now ready to be used by the application.
 112  */
 113 void EVENT_USB_Host_DeviceEnumerationComplete(void)
 114 {
 115         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 116 }
 117
 118 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
 119 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
 120 {
 121         USB_ShutDown();
 122
 123         printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
 124                                  " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
 125
 126         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 127         for(;;);
 128 }
 129
 130 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
 131  *  enumerating an attached USB device.
 132  */
 133 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode, const uint8_t SubErrorCode)
 134 {
 135         printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
 136                                  " -- Error Code %d\r\n"
 137                                  " -- Sub Error Code %d\r\n"
 138                                  " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
 139
 140         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 141 }
 142
 143 /** Task to set the configuration of the attached device after it has been enumerated. */
 144 void Bluetooth_Host_Task(void)
 145 {
 146         uint8_t ErrorCode;
 147
 148         switch (USB_HostState)
 149         {
 150                 case HOST_STATE_Addressed:
 151                         puts_P(PSTR("Getting Device Data.\r\n"));
 152
 153                         /* Get and process the configuration descriptor data */
 154                         if ((ErrorCode = ProcessDeviceDescriptor()) != SuccessfulDeviceRead)
 155                         {
 156                                 if (ErrorCode == DevControlError)
 157                                   puts_P(PSTR(ESC_FG_RED "Control Error (Get Device).\r\n"));
 158                                 else
 159                                   puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));
 160
 161                                 printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
 162
 163                                 /* Indicate error via status LEDs */
 164                                 LEDs_SetAllLEDs(LEDS_LED1);
 165
 166                                 /* Wait until USB device disconnected */
 167                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 168                                 break;
 169                         }
 170
 171                         puts_P(PSTR("Bluetooth Dongle Detected.\r\n"));
 172
 173                         /* Set the device configuration to the first configuration (rarely do devices use multiple configurations) */
 174                         if ((ErrorCode = USB_Host_SetDeviceConfiguration(1)) != HOST_SENDCONTROL_Successful)
 175                         {
 176                                 printf_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"
 177                                                          " -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
 178
 179                                 /* Indicate error via status LEDs */
 180                                 LEDs_SetAllLEDs(LEDS_LED1);
 181
 182                                 /* Wait until USB device disconnected */
 183                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 184                                 break;
 185                         }
 186
 187                         puts_P(PSTR("Getting Config Data.\r\n"));
 188
 189                         /* Get and process the configuration descriptor data */
 190                         if ((ErrorCode = ProcessConfigurationDescriptor()) != SuccessfulConfigRead)
 191                         {
 192                                 if (ErrorCode == ControlError)
 193                                   puts_P(PSTR(ESC_FG_RED "Control Error (Get Configuration).\r\n"));
 194                                 else
 195                                   puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));
 196
 197                                 printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
 198
 199                                 /* Indicate error via status LEDs */
 200                                 LEDs_SetAllLEDs(LEDS_LED1);
 201
 202                                 /* Wait until USB device disconnected */
 203                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 204                                 break;
 205                         }
 206
 207                         puts_P(PSTR("Bluetooth Dongle Enumerated.\r\n"));
 208
 209                         /* Initialize the Bluetooth stack */
 210                         Bluetooth_Stack_Init();
 211
 212                         USB_HostState = HOST_STATE_Configured;
 213                         break;
 214         }
 215 }
 216
 217 /** Bluetooth stack callback event for when the Bluetooth stack has fully initialized using the attached
 218  *  Bluetooth dongle.
 219  */
 220 void Bluetooth_StackInitialized(void)
 221 {
 222         printf_P(PSTR("Stack initialized with local address %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 223                  Bluetooth_State.LocalBDADDR[5], Bluetooth_State.LocalBDADDR[4], Bluetooth_State.LocalBDADDR[3],
 224                  Bluetooth_State.LocalBDADDR[2], Bluetooth_State.LocalBDADDR[1], Bluetooth_State.LocalBDADDR[0]);
 225
 226         /* Reinitialize the services placed on top of the Bluetooth stack ready for new connections */
 227         RFCOMM_Initialize();
 228 }
 229
 230 /** Bluetooth stack callback event for a Bluetooth connection request. When this callback fires, the
 231  *  user application must indicate if the connection is to be allowed or rejected.
 232  *
 233  *  \param[in] RemoteAddress  Bluetooth address of the remote device attempting the connection
 234  *
 235  *  \return Boolean true to accept the connection, false to reject it
 236  */
 237 bool Bluetooth_ConnectionRequest(const uint8_t* RemoteAddress)
 238 {
 239         printf_P(PSTR("Connection Request from Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 240                  RemoteAddress[5], RemoteAddress[4], RemoteAddress[3], RemoteAddress[2],
 241                  RemoteAddress[1], RemoteAddress[0]);
 242
 243         /* Always accept connections from remote devices */
 244         return true;
 245 }
 246
 247 /** Bluetooth stack callback event for a completed Bluetooth connection. When this callback is made,
 248  *  the connection information can be accessed through the global \ref Bluetooth_Connection structure.
 249  */
 250 void Bluetooth_ConnectionComplete(void)
 251 {
 252         printf_P(PSTR("Connection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 253                  Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],
 254                  Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],
 255                  Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0]);
 256
 257         LEDs_SetAllLEDs(LEDMASK_USB_BUSY);
 258 }
 259
 260 /** Bluetooth stack callback event for a completed Bluetooth disconnection. When this callback is made,
 261  *  the connection information in the global \ref Bluetooth_Connection structure is invalidated with the
 262  *  exception of the RemoteAddress element, which can be used to determine the address of the device that
 263  *  was disconnected.
 264  */
 265 void Bluetooth_DisconnectionComplete(void)
 266 {
 267         printf_P(PSTR("Disconnection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X.\r\n"),
 268                  Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],
 269                  Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],
 270                  Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0]);
 271
 272         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 273 }
 274
 275 /** Bluetooth stack callback event for a Bluetooth ACL Channel connection request. When is callback fires,
 276  *  the user application must indicate if the channel connection should be rejected or not, based on the
 277  *  protocol (PSM) value of the requested channel.
 278  *
 279  *  \param[in] PSM  Protocol PSM value for the requested channel
 280  *
 281  *  \return Boolean true to accept the channel connection request, false to reject it
 282  */
 283 bool Bluetooth_ChannelConnectionRequest(const uint16_t PSM)
 284 {
 285         /* Always accept channel connection requests regardless of PSM */
 286         return true;
 287 }
 288
 289 /** Bluetooth stack callback event for a non-signal ACL packet reception. This callback fires once a connection
 290  *  to a remote Bluetooth device has been made, and the remote device has sent a non-signalling ACL packet.
 291  *
 292  *  \param[in] Data     Pointer to a buffer where the received data is stored
 293  *  \param[in] DataLen  Length of the packet data, in bytes
 294  *  \param[in] Channel  Bluetooth ACL data channel information structure for the packet's destination channel
 295  */
 296 void Bluetooth_PacketReceived(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel)
 297 {
 298         /* Run the correct packet handler based on the received packet's PSM, which indicates the service being carried */
 299         switch (Channel->PSM)
 300         {
 301                 case CHANNEL_PSM_SDP:
 302                         /* Service Discovery Protocol packet */
 303                         SDP_ProcessPacket(Data, Channel);
 304                         break;
 305                 case CHANNEL_PSM_RFCOMM:
 306                         /* RFCOMM (Serial Port) Protocol packet */
 307                         RFCOMM_ProcessPacket(Data, Channel);
 308                         break;
 309                 default:
 310                         /* Unknown Protocol packet */
 311                         printf_P(PSTR("Unknown Packet Received (Channel 0x%04X, PSM: 0x%02X, Len: 0x%04X):\r\n"),
 312                                       Channel->LocalNumber, Channel->PSM, DataLen);
 313                         break;
 314         }
 315 }