Added new \ref SPI_GetCurrentMode() function to the SPI peripheral driver.
[pub/USBasp.git] / Demos / Host / Incomplete / BluetoothHost / BluetoothEvents.c
index 82e347f..f5a9eec 100644 (file)
@@ -1,13 +1,13 @@
 /*\r
              LUFA Library\r
-     Copyright (C) Dean Camera, 2010.\r
+     Copyright (C) Dean Camera, 2011.\r
               \r
   dean [at] fourwalledcubicle [dot] com\r
-      www.fourwalledcubicle.com\r
+           www.lufa-lib.org\r
 */\r
 \r
 /*\r
-  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
+  Copyright 2011  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
@@ -122,7 +122,7 @@ bool Bluetooth_ChannelConnectionRequest(const uint16_t PSM)
 /** Bluetooth stack callback event for when a Bluetooth ACL channel has been fully created and configured,\r
  *  either at the request of the local device, or the remote device.\r
  *\r
- *  \param[in] Channel  Bluetooth ACL data channel information structure for the channel that can now be used\r
+ *  \param[in] ACLChannel  Bluetooth ACL data channel information structure for the channel that can now be used\r
  */\r
 void Bluetooth_ChannelOpened(Bluetooth_Channel_t* const ACLChannel)\r
 {\r
@@ -132,11 +132,11 @@ void Bluetooth_ChannelOpened(Bluetooth_Channel_t* const ACLChannel)
 }\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
+ *  to a remote Bluetooth device has been made, and the remote device has sent a non-signaling 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
+ *  \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] ACLChannel  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 ACLChannel)\r
 {\r
@@ -154,17 +154,23 @@ void Bluetooth_PacketReceived(void* Data, uint16_t DataLen, Bluetooth_Channel_t*
        }\r
 }\r
 \r
+/** RFCOMM layer callback for event for when a RFCOMM logical channel has been fully opened and configured between\r
+ *  the local and remote device. Once open, this RFCOMM channel can be read from and written to freely until is it\r
+ *  closed by either end.\r
+ *\r
+ *  \param[in] RFCOMMChannel  RFCOMM channel that was opened\r
+ */ \r
 void RFCOMM_ChannelOpened(RFCOMM_Channel_t* const RFCOMMChannel)\r
 {\r
        /* Save the serial port RFCOMM logical channel for later use */\r
        SerialChannel_RFCOMM = RFCOMMChannel;\r
 }\r
 \r
-/** RFCOMM layer callback for when a packet is received on an open RFCOMM channel.\r
+/** RFCOMM layer callback event for when a packet is received on an open RFCOMM channel.\r
  *\r
- *  \param[in] Channel  RFCOMM channel that the data was directed to\r
- *  \param[in] DataLen  Length of the received data, in bytes\r
- *  \param[in] Data     Pointer to a buffer where the received data is stored\r
+ *  \param[in] ACLChannel  RFCOMM ACL channel that the data was directed to\r
+ *  \param[in] DataLen     Length of the received data, in bytes\r
+ *  \param[in] Data        Pointer to a buffer where the received data is stored\r
  */\r
 void RFCOMM_DataReceived(RFCOMM_Channel_t* const ACLChannel, uint16_t DataLen, const uint8_t* Data)\r
 {\r
@@ -176,7 +182,13 @@ void RFCOMM_DataReceived(RFCOMM_Channel_t* const ACLChannel, uint16_t DataLen, c
        RFCOMM_SendData(DataLen, Data, SerialChannel_RFCOMM, SerialChannel_ACL);\r
 }\r
 \r
+/** RFCOMM layer callback event for when the remote device has updated the channel terminal control signals\r
+ *  for a particular RFCOMM channel.\r
+ *\r
+ *  \param[in] RFCOMMChannel  RFCOMM logical channel whose signals were altered\r
+ */ \r
 void RFCOMM_ChannelSignalsReceived(RFCOMM_Channel_t* const RFCOMMChannel)\r
 {\r
        // Currently do nothing in response to the remote device sending new terminal control signals\r
 }\r
+