| /**************************************************************************** |
| * include/netpacket/bluetooth.h |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. The |
| * ASF licenses this file to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance with the |
| * License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |
| * License for the specific language governing permissions and limitations |
| * under the License. |
| * |
| ****************************************************************************/ |
| |
| #ifndef __INCLUDE_NETPACKET_BLUETOOTH_H |
| #define __INCLUDE_NETPACKET_BLUETOOTH_H |
| |
| /**************************************************************************** |
| * Included Files |
| ****************************************************************************/ |
| |
| #include <sys/types.h> |
| #include <stdint.h> |
| |
| #include <nuttx/wireless/bluetooth/bt_hci.h> |
| |
| /**************************************************************************** |
| * Pre-processor Definitions |
| ****************************************************************************/ |
| |
| /* Well known addresses: */ |
| |
| #define BT_ADDR_ANY {0, 0, 0, 0, 0, 0} |
| #define BT_ADDR_LOCAL {0, 0, 0, 0xff, 0xff, 0xff} |
| |
| /* Any channel, any PSM */ |
| |
| #define BT_CHANNEL_ANY 0 |
| #define BT_PSM_ANY 0 |
| |
| /* Socket protocols. |
| * |
| * All Bluetooth sockets should select address family = AF_BLUETOOTH and |
| * type = SOCK_RAW. Protocol options are listed here (from NetBSD): |
| * |
| * BTPROTO_HCI |
| * This gives raw access to the Host Controller Interface of local devices |
| * using the HCI protocol as described in the Bluetooth Core Specification. |
| * The local address specified by bind() may be used to select the device |
| * that the socket will receive packets from. If BDADDR_ANY is specified |
| * then the socket will receive packets from all devices on the system. |
| * connect() may be used to create connections such that packets sent with |
| * send() will be delivered to the specified device, otherwise sendto() |
| * should be used. |
| * BTPROTO_L2CAP |
| * L2CAP sockets give sequential packet access over channels to other |
| * Bluetooth devices and make use of the bt_psm field in the sockaddr_l2 |
| * structure to select the Protocol/Service Multiplexer to specify when |
| * making connections. If the special value of L2CAP_PSM_ANY is bound |
| * when the listen() call is made, the next available PSM from the |
| * dynamic range above 0x1001 will be selected and may be discovered |
| * using the getsockname() call. |
| * BTPROTO_RFCOMM |
| * RFCOMM sockets provide streamed data over Bluetooth connection and |
| * make use of the l2_cid field in the sockaddr_rc structure. |
| * The channel number must be between 1 and 30 inclusive except that if |
| * the special value RFCOMM_CHANNEL_ANY is bound, when the listen() call |
| * is made, the first unused channel for the relevant bdaddr will be |
| * allocated and may be discovered using the getsockname(2) call. |
| * |
| * BTPROTO_NONE |
| * This is to be used internally to indicate unconfigured protocol. Not |
| * to be used on sockets by user. |
| */ |
| |
| #define BTPROTO_L2CAP 0 |
| #define BTPROTO_HCI 1 |
| #define BTPROTO_SCO 2 |
| #define BTPROTO_RFCOMM 3 |
| #define BTPROTO_BNEP 4 |
| #define BTPROTO_CMTP 5 |
| #define BTPROTO_HIDP 6 |
| #define BTPROTO_AVDTP 7 |
| #define BTPROTO_NONE 255 |
| |
| /* HCI socket options (SOL_HCI, see include/sys/socket.h): |
| * |
| * SO_HCI_EVT_FILTER |
| * Controls which events will be received at the socket. By default, |
| * Command_Complete and Command_Status events only are enabled. |
| * SO_HCI_PKT_FILTER [struct hci_filter] |
| * This filter controls the type of packets that will be received at |
| * the socket. By default, Event packets only are enabled. |
| * SO_HCI_DIRECTION [int] |
| * When set, this enables control messages on packets received at the |
| * socket indicating the direction of travel of the packet. |
| */ |
| |
| #define SO_HCI_EVT_FILTER (__SO_PROTOCOL + 0) |
| #define SO_HCI_PKT_FILTER (__SO_PROTOCOL + 1) |
| #define SO_HCI_DIRECTION (__SO_PROTOCOL + 2) |
| |
| /* L2CAP socket options (SOL_L2CAP, see include/sys/socket.h): |
| |
| * SO_L2CAP_IMTU [uint16_t] |
| * Incoming MTU |
| * SO_L2CAP_OMTU [uint16_t] |
| * Outgoing MTU (read-only) |
| * SO_L2CAP_LM [int] |
| * Link Mode. The following bits may be set: |
| * |
| * L2CAP_LM_AUTH Request authentication (pairing). |
| * L2CAP_LM_ENCRYPT Request encryption (includes authentication). |
| * L2CAP_LM_SECURE Request secured link (encryption, plus |
| * change link key). |
| * |
| * Link mode settings will be applied to the baseband link during L2CAP |
| * connection establishment. If the L2CAP connection is already |
| * established, EINPROGRESS may be returned, and it is not possible to |
| * guarantee that data already queued (from either end) will not be |
| * delivered. If the mode change fails, the L2CAP connection will be |
| * aborted. |
| */ |
| |
| #define SO_L2CAP_IMTU (__SO_PROTOCOL + 3) |
| #define SO_L2CAP_OMTU (__SO_PROTOCOL + 4) |
| #define SO_L2CAP_LM (__SO_PROTOCOL + 5) |
| # define L2CAP_LM_AUTH (1 << 0) |
| # define L2CAP_LM_ENCRYPT (1 << 1) |
| # define L2CAP_LM_SECURE (1 << 2) |
| |
| /* RFCOMM socket options (SOL_RFCOMM, see include/sys/socket.h): |
| * |
| * SO_RFCOMM_MTU [uint16_t] |
| * Maximum Frame Size to use for this link. |
| * SO_RFCOMM_LM [int] |
| * Link Mode. The following bits may be set at any time: |
| * |
| * RFCOMM_LM_AUTH Request authentication (pairing). |
| * RFCOMM_LM_ENCRYPT Request encryption (includes authentication). |
| * RFCOMM_LM_SECURE Request secured link (encryption, plus |
| * change link key). |
| * |
| * Link mode settings will be applied to the baseband link during RFCOMM |
| * connection establishment. If the RFCOMM connection is already |
| * established, EINPROGRESS may be returned, and it is not possible to |
| * guarantee that data already queued (from either end) will not be |
| * delivered. If the mode change fails, the RFCOMM connection will be |
| * aborted. |
| */ |
| |
| #define SO_RFCOMM_MTU (__SO_PROTOCOL + 6) |
| #define SO_RFCOMM_LM (__SO_PROTOCOL + 7) |
| # define RFCOMM_LM_AUTH (1 << 0) |
| # define RFCOMM_LM_ENCRYPT (1 << 1) |
| # define RFCOMM_LM_SECURE (1 << 2) |
| |
| /* SCO socket options (SOL_SCO, see include/sys/socket.h): |
| * |
| * SO_SCO_MTU [uint16_t] |
| * Maximum packet size for use on this link. This is read-only and will |
| * be set by the protocol code when a connection is made. |
| * SO_SCO_HANDLE [uint16_t] |
| * Connection handle for this link. This is read-only and provided for |
| * informational purposes only. |
| */ |
| |
| #define SO_SCO_MTU (__SO_PROTOCOL + 8) |
| #define SO_SCO_HANDLE (__SO_PROTOCOL + 9) |
| |
| /* The CID name space for the ACL-U, ASB-C, and AMP-U logical links is as |
| * follows: |
| */ |
| |
| #define BT_CID_NULL 0x0000 /* Null identifier */ |
| #define BT_CID_L2CAP 0x0001 /* L2CAP Signaling channel */ |
| #define BT_CID_CONNECTIONLESS 0x0002 /* Connectionless channel */ |
| #define BT_CID_AMP 0x0003 /* AMP Manager Protocol */ |
| /* 0x0004-0x0006 Reserved for future |
| * use */ |
| #define BT_CID_BREDR 0x0007 /* BR/EDR Security Manager */ |
| /* 0x0008-0x003e Reserved for future |
| * use */ |
| #define BT_CID_AMPTEST 0x003f /* AMP Test Manager */ |
| /* 0x0040-0xffff Dynamically |
| * allocated */ |
| |
| /* The CID name space for the LE-U logical link is as follows: |
| * |
| * NOTE: 0x0004, 0x0005, and 0x0006 are used internally by ATT, L2CAP, and |
| * and SMP. These are unavailable for use use in socket connection. |
| */ |
| |
| #define BT_LE_CID_NULL 0x0000 /* Null identifier */ |
| /* 0x0001-0x0003 Reserved for future |
| * use */ |
| #define BT_LE_CID_ATT 0x0004 /* Attribute Protocol */ |
| #define BT_LE_CID_L2CAP 0x0005 /* Low Energy L2CAP Signaling channel */ |
| #define BT_LE_CID_SMP 0x0006 /* Security Manager Protocol */ |
| /* 0x0007-0x001f Reserved for future */ |
| /* 0x0020-0x003e Assigned Numbers */ |
| /* 0x003f Reserved for future use */ |
| /* 0x0040-0x007f Dynamically allocated |
| * using the L2CAP LE credit based |
| * connection mechanism */ |
| /* Others reserved for future use */ |
| |
| /* Protocol and Service Multiplexers (PSMs) */ |
| |
| #define BT_PSM_SDP 0x0001 /* Bluetooth Service Discovery |
| * Protocol (SDP), Bluetooth SIG */ |
| #define BT_PSM_RFCOMM 0x0003 /* RFCOMM with TS 07.10, Bluetooth |
| * SIG */ |
| #define BT_PSM_TCS_BIN 0x0005 /* Bluetooth Telephony Control |
| * Specification / TCS Binary, |
| * Bluetooth SIG */ |
| #define BT_PSM_TCS_BIN_CORDLESS 0x0007 /* Bluetooth Telephony Control |
| * Specification / TCS Binary, |
| * Bluetooth SIG */ |
| #define BT_PSM_BNEP 0x000f /* Bluetooth Network Encapsulation |
| * Protocol, Bluetooth SIG */ |
| #define BT_PSM_HID_CTRL 0x0011 /* Human Interface Device, Bluetooth |
| * SIG */ |
| #define BT_PSM_HID_INT 0x0013 /* Human Interface Device, Bluetooth |
| * SIG */ |
| #define BT_PSM_UPnP 0x0015 /* [ESDP] , Bluetooth SIG */ |
| #define BT_PSM_AVCTP 0x0017 /* Audio/Video Control Transport |
| * Protocol, Bluetooth SIG */ |
| #define BT_PSM_AVDTP 0x0019 /* Audio/Video Distribution Transport |
| * Protocol, Bluetooth SIG */ |
| #define BT_PSM_AVCTP_BROWSING 0x001b /* Audio/Video Remote Control |
| * Profile, Bluetooth SIG */ |
| #define BT_PSM_UDI_CPLANE 0x001d /* Unrestricted Digital Information |
| * Profile [UDI], Bluetooth SIG */ |
| #define BT_PSM_ATT 0x001f /* Bluetooth Core Specification */ |
| #define BT_PSM_3DSP 0x0021 /* 3D Synchronization Profile, |
| * Bluetooth SIG. */ |
| #define BT_PSM_LE_PSM_IPSP 0x0023 /* Internet Protocol Support Profile |
| * (IPSP), Bluetooth SIG */ |
| #define BT_PSM_OTS 0x0025 /* Object Transfer Service (OTS), |
| * Bluetooth SIG */ |
| |
| /* Channels for a BTPROTO_HCI socket */ |
| |
| #define HCI_CHANNEL_RAW 0x0 |
| #define HCI_CHANNEL_USER 0x1 |
| |
| /* Packets types send over the network layer for BTPROTO_HCI */ |
| |
| #define HCI_COMMAND_PKT 0x01 |
| #define HCI_ACLDATA_PKT 0x02 |
| #define HCI_SCODATA_PKT 0x03 |
| #define HCI_EVENT_PKT 0x04 |
| #define HCI_VENDOR_PKT 0xff |
| |
| /**************************************************************************** |
| * Public Type Definitions |
| ****************************************************************************/ |
| |
| /* See include/nuttx/wireless/bluetooth/bt_hci.h for address definitions. In |
| * particular, type bt_addr_t |
| */ |
| |
| /* Socket address used with: |
| * |
| * bind() - Associates local address with socket |
| * connect() - Associates a remote address with the socket (for send()) |
| * sendto() - Send to specified remote address |
| * recvfrom()- Receive from indicated remote address. |
| * |
| */ |
| |
| struct sockaddr_l2 |
| { |
| sa_family_t l2_family; /* Must be AF_BLUETOOTH */ |
| uint16_t l2_psm; /* Protocol Service Multiplexer (PSM) */ |
| bt_addr_t l2_bdaddr; /* 6-byte Bluetooth address */ |
| uint16_t l2_cid; /* Channel identifier (CID) */ |
| uint8_t l2_bdaddr_type; /* Bluetooth address type */ |
| }; |
| |
| struct sockaddr_hci |
| { |
| sa_family_t hci_family; /* Must be AF_BLUETOOTH */ |
| uint16_t hci_dev; /* Network Device ID */ |
| uint16_t hci_channel; /* Channel: USER, MONITOR, CONTROL, etc... */ |
| }; |
| |
| struct sockaddr_rc |
| { |
| sa_family_t rc_family; /* Must be AF_BLUETOOTH */ |
| bt_addr_t rc_bdaddr; /* 6-byte Bluetooth address */ |
| uint8_t rc_channel; /* Channel number */ |
| }; |
| |
| /**************************************************************************** |
| * Public Function Prototypes |
| ****************************************************************************/ |
| |
| #endif /* __INCLUDE_NETPACKET_BLUETOOTH_H */ |
