Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMMControl.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  *  RFCOMM multiplexer control layer module. This module handles multiplexer
  34  *  channel commands to the control DLCI in the RFCOMM layer, to open, configure,
  35  *  test and close logical RFCOMM channels.
  36  */
  37
  38 #define  INCLUDE_FROM_RFCOMM_CONTROL_C
  39 #include "RFCOMMControl.h"
  40
  41 void RFCOMM_ProcessControlCommand(const uint8_t* Command, Bluetooth_Channel_t* const ACLChannel)
  42 {
  43         const RFCOMM_Command_t* CommandHeader  = (const RFCOMM_Command_t*)Command;
  44         const uint8_t*          CommandData    = (const uint8_t*)Command + sizeof(RFCOMM_Command_t);
  45         uint8_t                 CommandDataLen = RFCOMM_GetVariableFieldValue(&CommandData);
  46
  47         switch (CommandHeader->Command)
  48         {
  49                 case RFCOMM_Control_Test:
  50                         RFCOMM_ProcessTestCommand(CommandHeader, CommandDataLen, CommandData, ACLChannel);
  51                         break;
  52                 case RFCOMM_Control_FlowControlEnable:
  53                         RFCOMM_ProcessFCECommand(CommandHeader, CommandData, ACLChannel);
  54                         break;
  55                 case RFCOMM_Control_FlowControlDisable:
  56                         RFCOMM_ProcessFCDCommand(CommandHeader, CommandData, ACLChannel);
  57                         break;
  58                 case RFCOMM_Control_ModemStatus:
  59                         RFCOMM_ProcessMSCCommand(CommandHeader, CommandDataLen, CommandData, ACLChannel);
  60                         break;
  61                 case RFCOMM_Control_RemotePortNegotiation:
  62                         RFCOMM_ProcessRPNCommand(CommandHeader, CommandData, ACLChannel);
  63                         break;
  64                 case RFCOMM_Control_RemoteLineStatus:
  65                         RFCOMM_ProcessRLSCommand(CommandHeader, CommandData, ACLChannel);
  66                         break;
  67                 case RFCOMM_Control_DLCParameterNegotiation:
  68                         RFCOMM_ProcessDPNCommand(CommandHeader, CommandData, ACLChannel);
  69                         break;
  70                 default:
  71                         BT_RFCOMM_DEBUG(1, "<< Unknown Command");
  72                         break;
  73         }
  74 }
  75
  76 static void RFCOMM_ProcessTestCommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t CommandDataLen,
  77                                       const uint8_t* CommandData, Bluetooth_Channel_t* const ACLChannel)
  78 {
  79         const uint8_t* Params = (const uint8_t*)CommandData;
  80
  81         BT_RFCOMM_DEBUG(1, "<< TEST Command");
  82
  83         struct
  84         {
  85                 RFCOMM_Command_t CommandHeader;
  86                 uint8_t          Length;
  87                 uint8_t          TestData[CommandDataLen];
  88         } TestResponse;
  89
  90         /* Fill out the Test response data */
  91         TestResponse.CommandHeader = (RFCOMM_Command_t){.Command = RFCOMM_Control_Test, .EA = true, .CR = false};
  92         TestResponse.Length        = (CommandDataLen << 1) | 0x01;
  93         memcpy(TestResponse.TestData, Params, CommandDataLen);
  94
  95         BT_RFCOMM_DEBUG(1, ">> TEST Response");
  96
  97         /* Send the PDN response to acknowledge the command */
  98         RFCOMM_SendFrame(RFCOMM_CONTROL_DLCI, false, RFCOMM_Frame_UIH, sizeof(TestResponse), &TestResponse, ACLChannel);
  99 }
 100
 101 static void RFCOMM_ProcessFCECommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t* CommandData,
 102                                                  Bluetooth_Channel_t* const ACLChannel)
 103 {
 104         BT_RFCOMM_DEBUG(1, "<< FCE Command");
 105 }
 106
 107 static void RFCOMM_ProcessFCDCommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t* CommandData,
 108                                                  Bluetooth_Channel_t* const ACLChannel)
 109 {
 110         BT_RFCOMM_DEBUG(1, "<< FCD Command");
 111 }
 112
 113 static void RFCOMM_ProcessMSCCommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t CommandDataLen,
 114                                      const uint8_t* CommandData, Bluetooth_Channel_t* const ACLChannel)
 115 {
 116         const RFCOMM_MSC_Parameters_t* Params = (const RFCOMM_MSC_Parameters_t*)CommandData;
 117
 118         BT_RFCOMM_DEBUG(1, "<< MSC %s", (CommandHeader->CR) ? "Command" : "Response");
 119         BT_RFCOMM_DEBUG(2, "-- DLCI: 0x%02X", Params->Channel.DLCI);
 120
 121         /* Ignore status flags sent to the control channel */
 122         if (Params->Channel.DLCI == RFCOMM_CONTROL_DLCI)
 123           return;
 124
 125         /* Retrieve existing channel configuration data, if already opened */
 126         RFCOMM_Channel_t* RFCOMMChannel = RFCOMM_GetChannelData(Params->Channel.DLCI);
 127
 128         /* If the channel does not exist, abort */
 129         if (RFCOMMChannel == NULL)
 130           return;
 131
 132         /* Check if the MSC packet is a command or a response */
 133         if (CommandHeader->CR)
 134         {
 135                 /* Save the new channel signals to the channel state structure */
 136                 RFCOMMChannel->Remote.Signals  = Params->Signals;
 137                 RFCOMMChannel->ConfigFlags    |= RFCOMM_CONFIG_REMOTESIGNALS;
 138
 139                 /* If the command contains the optional break signals field, store the value */
 140                 if (CommandDataLen == sizeof(RFCOMM_MSC_Parameters_t))
 141                   RFCOMMChannel->Remote.BreakSignal = Params->BreakSignal;
 142
 143                 /* Notify the user application that the signals have been received */
 144                 RFCOMM_ChannelSignalsReceived(RFCOMMChannel);
 145
 146                 struct
 147                 {
 148                         RFCOMM_Command_t        CommandHeader;
 149                         uint8_t                 Length;
 150                         RFCOMM_MSC_Parameters_t Params;
 151                 } MSResponse;
 152
 153                 /* Fill out the MS response data */
 154                 MSResponse.CommandHeader  = (RFCOMM_Command_t){.Command = RFCOMM_Control_ModemStatus, .EA = true, .CR = false};
 155                 MSResponse.Length         = (CommandDataLen << 1) | 0x01;
 156                 memcpy(&MSResponse.Params, Params, sizeof(RFCOMM_MSC_Parameters_t));
 157
 158                 BT_RFCOMM_DEBUG(1, ">> MSC Response");
 159
 160                 /* Send the MSC response to acknowledge the command */
 161                 RFCOMM_SendFrame(RFCOMM_CONTROL_DLCI, false, RFCOMM_Frame_UIH,
 162                                                  (sizeof(MSResponse) - sizeof(MSResponse.Params) + CommandDataLen), &MSResponse, ACLChannel);
 163         }
 164         else
 165         {
 166                 /* Indicate that the remote device has acknowledged the sent signals */
 167                 RFCOMMChannel->ConfigFlags |= RFCOMM_CONFIG_LOCALSIGNALS;
 168         }
 169 }
 170
 171 static void RFCOMM_ProcessRPNCommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t* CommandData,
 172                                                  Bluetooth_Channel_t* const ACLChannel)
 173 {
 174         BT_RFCOMM_DEBUG(1, "<< RPN Command");
 175 }
 176
 177 static void RFCOMM_ProcessRLSCommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t* CommandData,
 178                                                  Bluetooth_Channel_t* const ACLChannel)
 179 {
 180         BT_RFCOMM_DEBUG(1, "<< RLS Command");
 181 }
 182
 183 static void RFCOMM_ProcessDPNCommand(const RFCOMM_Command_t* const CommandHeader, const uint8_t* CommandData,
 184                                                  Bluetooth_Channel_t* const ACLChannel)
 185 {
 186         const RFCOMM_DPN_Parameters_t* Params = (const RFCOMM_DPN_Parameters_t*)CommandData;
 187
 188         BT_RFCOMM_DEBUG(1, "<< DPN Command");
 189         BT_RFCOMM_DEBUG(2, "-- DLCI: 0x%02X", Params->DLCI);
 190
 191         /* Ignore parameter negotiations to the control channel */
 192         if (Params->DLCI == RFCOMM_CONTROL_DLCI)
 193           return;
 194
 195         /* Retrieve existing channel configuration data, if already opened */
 196         RFCOMM_Channel_t* RFCOMMChannel = RFCOMM_GetChannelData(Params->DLCI);
 197
 198         /* Check if the channel has no corresponding entry - remote did not open it first */
 199         if (RFCOMMChannel == NULL)
 200         {
 201                 /* Create a new entry in the channel table for the new channel */
 202                 RFCOMMChannel = RFCOMM_GetFreeChannelEntry(Params->DLCI);
 203
 204                 /* No free entry was found, discard the request */
 205                 if (RFCOMMChannel == NULL)
 206                 {
 207                         BT_RFCOMM_DEBUG(2, "-- No Free Channel");
 208                         return;
 209                 }
 210         }
 211
 212         /* Save the new channel configuration */
 213         RFCOMMChannel->State       = RFCOMM_Channel_Configure;
 214         RFCOMMChannel->Priority    = Params->Priority;
 215         RFCOMMChannel->MTU         = Params->MaximumFrameSize;
 216
 217         struct
 218         {
 219                 RFCOMM_Command_t        CommandHeader;
 220                 uint8_t                 Length;
 221                 RFCOMM_DPN_Parameters_t Params;
 222         } DPNResponse;
 223
 224         /* Fill out the DPN response data */
 225         DPNResponse.CommandHeader = (RFCOMM_Command_t){.Command = RFCOMM_Control_DLCParameterNegotiation, .EA = true, .CR = false};
 226         DPNResponse.Length                  = (sizeof(DPNResponse.Params) << 1) | 0x01;
 227         memcpy(&DPNResponse.Params, Params, sizeof(RFCOMM_DPN_Parameters_t));
 228         DPNResponse.Params.ConvergenceLayer = 0x00; // TODO: Enable credit based transaction support
 229
 230         BT_RFCOMM_DEBUG(1, ">> DPN Response");
 231
 232         /* Send the DPN response to acknowledge the command */
 233         RFCOMM_SendFrame(RFCOMM_CONTROL_DLCI, false, RFCOMM_Frame_UIH, sizeof(DPNResponse), &DPNResponse, ACLChannel);
 234 }