Commit 34e95e41 authored by Inaky Perez-Gonzalez's avatar Inaky Perez-Gonzalez Committed by David Vrabel

uwb: add the uwb include files

Signed-off-by: default avatarDavid Vrabel <david.vrabel@csr.com>
parent 99d368bc
This diff is collapsed.
/*
* Ultra Wide Band
* Debug interface commands
*
* Copyright (C) 2008 Cambridge Silicon Radio Ltd.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License version
* 2 as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __LINUX__UWB__DEBUG_CMD_H__
#define __LINUX__UWB__DEBUG_CMD_H__
#include <linux/types.h>
/*
* Debug interface commands
*
* UWB_DBG_CMD_RSV_ESTABLISH: Establish a new unicast reservation.
*
* UWB_DBG_CMD_RSV_TERMINATE: Terminate the Nth reservation.
*/
enum uwb_dbg_cmd_type {
UWB_DBG_CMD_RSV_ESTABLISH = 1,
UWB_DBG_CMD_RSV_TERMINATE = 2,
};
struct uwb_dbg_cmd_rsv_establish {
__u8 target[6];
__u8 type;
__u16 max_mas;
__u16 min_mas;
__u8 sparsity;
};
struct uwb_dbg_cmd_rsv_terminate {
int index;
};
struct uwb_dbg_cmd {
__u32 type;
union {
struct uwb_dbg_cmd_rsv_establish rsv_establish;
struct uwb_dbg_cmd_rsv_terminate rsv_terminate;
};
};
#endif /* #ifndef __LINUX__UWB__DEBUG_CMD_H__ */
/*
* Ultra Wide Band
* Debug Support
*
* Copyright (C) 2005-2006 Intel Corporation
* Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License version
* 2 as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301, USA.
*
*
* FIXME: doc
* Invoke like:
*
* #define D_LOCAL 4
* #include <linux/uwb/debug.h>
*
* At the end of your include files.
*/
#include <linux/types.h>
struct device;
extern void dump_bytes(struct device *dev, const void *_buf, size_t rsize);
/* Master debug switch; !0 enables, 0 disables */
#define D_MASTER (!0)
/* Local (per-file) debug switch; #define before #including */
#ifndef D_LOCAL
#define D_LOCAL 0
#endif
#undef __d_printf
#undef d_fnstart
#undef d_fnend
#undef d_printf
#undef d_dump
#define __d_printf(l, _tag, _dev, f, a...) \
do { \
struct device *__dev = (_dev); \
if (D_MASTER && D_LOCAL >= (l)) { \
char __head[64] = ""; \
if (_dev != NULL) { \
if ((unsigned long)__dev < 4096) \
printk(KERN_ERR "E: Corrupt dev %p\n", \
__dev); \
else \
snprintf(__head, sizeof(__head), \
"%s %s: ", \
dev_driver_string(__dev), \
__dev->bus_id); \
} \
printk(KERN_ERR "%s%s" _tag ": " f, __head, \
__func__, ## a); \
} \
} while (0 && _dev)
#define d_fnstart(l, _dev, f, a...) \
__d_printf(l, " FNSTART", _dev, f, ## a)
#define d_fnend(l, _dev, f, a...) \
__d_printf(l, " FNEND", _dev, f, ## a)
#define d_printf(l, _dev, f, a...) \
__d_printf(l, "", _dev, f, ## a)
#define d_dump(l, _dev, ptr, size) \
do { \
struct device *__dev = _dev; \
if (D_MASTER && D_LOCAL >= (l)) \
dump_bytes(__dev, ptr, size); \
} while (0 && _dev)
#define d_test(l) (D_MASTER && D_LOCAL >= (l))
/*
* Ultra Wide Band
* UWB Standard definitions
*
* Copyright (C) 2005-2006 Intel Corporation
* Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License version
* 2 as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301, USA.
*
*
* All these definitions are based on the ECMA-368 standard.
*
* Note all definitions are Little Endian in the wire, and we will
* convert them to host order before operating on the bitfields (that
* yes, we use extensively).
*/
#ifndef __LINUX__UWB_SPEC_H__
#define __LINUX__UWB_SPEC_H__
#include <linux/types.h>
#include <linux/bitmap.h>
#define i1480_FW 0x00000303
/* #define i1480_FW 0x00000302 */
/**
* Number of Medium Access Slots in a superframe.
*
* UWB divides time in SuperFrames, each one divided in 256 pieces, or
* Medium Access Slots. See MBOA MAC[5.4.5] for details. The MAS is the
* basic bandwidth allocation unit in UWB.
*/
enum { UWB_NUM_MAS = 256 };
/**
* Number of Zones in superframe.
*
* UWB divides the superframe into zones with numbering starting from BPST.
* See MBOA MAC[16.8.6]
*/
enum { UWB_NUM_ZONES = 16 };
/*
* Number of MAS in a zone.
*/
#define UWB_MAS_PER_ZONE (UWB_NUM_MAS / UWB_NUM_ZONES)
/*
* Number of streams per DRP reservation between a pair of devices.
*
* [ECMA-368] section 16.8.6.
*/
enum { UWB_NUM_STREAMS = 8 };
/*
* mMasLength
*
* The length of a MAS in microseconds.
*
* [ECMA-368] section 17.16.
*/
enum { UWB_MAS_LENGTH_US = 256 };
/*
* mBeaconSlotLength
*
* The length of the beacon slot in microseconds.
*
* [ECMA-368] section 17.16
*/
enum { UWB_BEACON_SLOT_LENGTH_US = 85 };
/*
* mMaxLostBeacons
*
* The number beacons missing in consecutive superframes before a
* device can be considered as unreachable.
*
* [ECMA-368] section 17.16
*/
enum { UWB_MAX_LOST_BEACONS = 3 };
/*
* Length of a superframe in microseconds.
*/
#define UWB_SUPERFRAME_LENGTH_US (UWB_MAS_LENGTH_US * UWB_NUM_MAS)
/**
* UWB MAC address
*
* It is *imperative* that this struct is exactly 6 packed bytes (as
* it is also used to define headers sent down and up the wire/radio).
*/
struct uwb_mac_addr {
u8 data[6];
} __attribute__((packed));
/**
* UWB device address
*
* It is *imperative* that this struct is exactly 6 packed bytes (as
* it is also used to define headers sent down and up the wire/radio).
*/
struct uwb_dev_addr {
u8 data[2];
} __attribute__((packed));
/**
* Types of UWB addresses
*
* Order matters (by size).
*/
enum uwb_addr_type {
UWB_ADDR_DEV = 0,
UWB_ADDR_MAC = 1,
};
/** Size of a char buffer for printing a MAC/device address */
enum { UWB_ADDR_STRSIZE = 32 };
/** UWB WiMedia protocol IDs. */
enum uwb_prid {
UWB_PRID_WLP_RESERVED = 0x0000,
UWB_PRID_WLP = 0x0001,
UWB_PRID_WUSB_BOT = 0x0010,
UWB_PRID_WUSB = 0x0010,
UWB_PRID_WUSB_TOP = 0x001F,
};
/** PHY Rate (MBOA MAC[7.8.12, Table 61]) */
enum uwb_phy_rate {
UWB_PHY_RATE_53 = 0,
UWB_PHY_RATE_80,
UWB_PHY_RATE_106,
UWB_PHY_RATE_160,
UWB_PHY_RATE_200,
UWB_PHY_RATE_320,
UWB_PHY_RATE_400,
UWB_PHY_RATE_480,
UWB_PHY_RATE_INVALID
};
/**
* Different ways to scan (MBOA MAC[6.2.2, Table 8], WUSB[Table 8-78])
*/
enum uwb_scan_type {
UWB_SCAN_ONLY = 0,
UWB_SCAN_OUTSIDE_BP,
UWB_SCAN_WHILE_INACTIVE,
UWB_SCAN_DISABLED,
UWB_SCAN_ONLY_STARTTIME,
UWB_SCAN_TOP
};
/** ACK Policy types (MBOA MAC[7.2.1.3]) */
enum uwb_ack_pol {
UWB_ACK_NO = 0,
UWB_ACK_INM = 1,
UWB_ACK_B = 2,
UWB_ACK_B_REQ = 3,
};
/** DRP reservation types ([ECMA-368 table 106) */
enum uwb_drp_type {
UWB_DRP_TYPE_ALIEN_BP = 0,
UWB_DRP_TYPE_HARD,
UWB_DRP_TYPE_SOFT,
UWB_DRP_TYPE_PRIVATE,
UWB_DRP_TYPE_PCA,
};
/** DRP Reason Codes ([ECMA-368] table 107) */
enum uwb_drp_reason {
UWB_DRP_REASON_ACCEPTED = 0,
UWB_DRP_REASON_CONFLICT,
UWB_DRP_REASON_PENDING,
UWB_DRP_REASON_DENIED,
UWB_DRP_REASON_MODIFIED,
};
/**
* DRP Notification Reason Codes (WHCI 0.95 [3.1.4.9])
*/
enum uwb_drp_notif_reason {
UWB_DRP_NOTIF_DRP_IE_RCVD = 0,
UWB_DRP_NOTIF_CONFLICT,
UWB_DRP_NOTIF_TERMINATE,
};
/** Allocation of MAS slots in a DRP request MBOA MAC[7.8.7] */
struct uwb_drp_alloc {
__le16 zone_bm;
__le16 mas_bm;
} __attribute__((packed));
/** General MAC Header format (ECMA-368[16.2]) */
struct uwb_mac_frame_hdr {
__le16 Frame_Control;
struct uwb_dev_addr DestAddr;
struct uwb_dev_addr SrcAddr;
__le16 Sequence_Control;
__le16 Access_Information;
} __attribute__((packed));
/**
* uwb_beacon_frame - a beacon frame including MAC headers
*
* [ECMA] section 16.3.
*/
struct uwb_beacon_frame {
struct uwb_mac_frame_hdr hdr;
struct uwb_mac_addr Device_Identifier; /* may be a NULL EUI-48 */
u8 Beacon_Slot_Number;
u8 Device_Control;
u8 IEData[];
} __attribute__((packed));
/** Information Element codes (MBOA MAC[T54]) */
enum uwb_ie {
UWB_PCA_AVAILABILITY = 2,
UWB_IE_DRP_AVAILABILITY = 8,
UWB_IE_DRP = 9,
UWB_BP_SWITCH_IE = 11,
UWB_MAC_CAPABILITIES_IE = 12,
UWB_PHY_CAPABILITIES_IE = 13,
UWB_APP_SPEC_PROBE_IE = 15,
UWB_IDENTIFICATION_IE = 19,
UWB_MASTER_KEY_ID_IE = 20,
UWB_IE_WLP = 250, /* WiMedia Logical Link Control Protocol WLP 0.99 */
UWB_APP_SPEC_IE = 255,
};
/**
* Header common to all Information Elements (IEs)
*/
struct uwb_ie_hdr {
u8 element_id; /* enum uwb_ie */
u8 length;
} __attribute__((packed));
/** Dynamic Reservation Protocol IE (MBOA MAC[7.8.6]) */
struct uwb_ie_drp {
struct uwb_ie_hdr hdr;
__le16 drp_control;
struct uwb_dev_addr dev_addr;
struct uwb_drp_alloc allocs[];
} __attribute__((packed));
static inline int uwb_ie_drp_type(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 0) & 0x7;
}
static inline int uwb_ie_drp_stream_index(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 3) & 0x7;
}
static inline int uwb_ie_drp_reason_code(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 6) & 0x7;
}
static inline int uwb_ie_drp_status(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 9) & 0x1;
}
static inline int uwb_ie_drp_owner(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 10) & 0x1;
}
static inline int uwb_ie_drp_tiebreaker(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 11) & 0x1;
}
static inline int uwb_ie_drp_unsafe(struct uwb_ie_drp *ie)
{
return (le16_to_cpu(ie->drp_control) >> 12) & 0x1;
}
static inline void uwb_ie_drp_set_type(struct uwb_ie_drp *ie, enum uwb_drp_type type)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (drp_control & ~(0x7 << 0)) | (type << 0);
ie->drp_control = cpu_to_le16(drp_control);
}
static inline void uwb_ie_drp_set_stream_index(struct uwb_ie_drp *ie, int stream_index)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (drp_control & ~(0x7 << 3)) | (stream_index << 3);
ie->drp_control = cpu_to_le16(drp_control);
}
static inline void uwb_ie_drp_set_reason_code(struct uwb_ie_drp *ie,
enum uwb_drp_reason reason_code)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (ie->drp_control & ~(0x7 << 6)) | (reason_code << 6);
ie->drp_control = cpu_to_le16(drp_control);
}
static inline void uwb_ie_drp_set_status(struct uwb_ie_drp *ie, int status)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (drp_control & ~(0x1 << 9)) | (status << 9);
ie->drp_control = cpu_to_le16(drp_control);
}
static inline void uwb_ie_drp_set_owner(struct uwb_ie_drp *ie, int owner)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (drp_control & ~(0x1 << 10)) | (owner << 10);
ie->drp_control = cpu_to_le16(drp_control);
}
static inline void uwb_ie_drp_set_tiebreaker(struct uwb_ie_drp *ie, int tiebreaker)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (drp_control & ~(0x1 << 11)) | (tiebreaker << 11);
ie->drp_control = cpu_to_le16(drp_control);
}
static inline void uwb_ie_drp_set_unsafe(struct uwb_ie_drp *ie, int unsafe)
{
u16 drp_control = le16_to_cpu(ie->drp_control);
drp_control = (drp_control & ~(0x1 << 12)) | (unsafe << 12);
ie->drp_control = cpu_to_le16(drp_control);
}
/** Dynamic Reservation Protocol IE (MBOA MAC[7.8.7]) */
struct uwb_ie_drp_avail {
struct uwb_ie_hdr hdr;
DECLARE_BITMAP(bmp, UWB_NUM_MAS);
} __attribute__((packed));
/**
* The Vendor ID is set to an OUI that indicates the vendor of the device.
* ECMA-368 [16.8.10]
*/
struct uwb_vendor_id {
u8 data[3];
} __attribute__((packed));
/**
* The device type ID
* FIXME: clarify what this means
* ECMA-368 [16.8.10]
*/
struct uwb_device_type_id {
u8 data[3];
} __attribute__((packed));
/**
* UWB device information types
* ECMA-368 [16.8.10]
*/
enum uwb_dev_info_type {
UWB_DEV_INFO_VENDOR_ID = 0,
UWB_DEV_INFO_VENDOR_TYPE,
UWB_DEV_INFO_NAME,
};
/**
* UWB device information found in Identification IE
* ECMA-368 [16.8.10]
*/
struct uwb_dev_info {
u8 type; /* enum uwb_dev_info_type */
u8 length;
u8 data[];
} __attribute__((packed));
/**
* UWB Identification IE
* ECMA-368 [16.8.10]
*/
struct uwb_identification_ie {
struct uwb_ie_hdr hdr;
struct uwb_dev_info info[];
} __attribute__((packed));
/*
* UWB Radio Controller
*
* These definitions are common to the Radio Control layers as
* exported by the WUSB1.0 HWA and WHCI interfaces.
*/
/** Radio Control Command Block (WUSB1.0[Table 8-65] and WHCI 0.95) */
struct uwb_rccb {
u8 bCommandType; /* enum hwa_cet */
__le16 wCommand; /* Command code */
u8 bCommandContext; /* Context ID */
} __attribute__((packed));
/** Radio Control Event Block (WUSB[table 8-66], WHCI 0.95) */
struct uwb_rceb {
u8 bEventType; /* enum hwa_cet */
__le16 wEvent; /* Event code */
u8 bEventContext; /* Context ID */
} __attribute__((packed));
enum {
UWB_RC_CET_GENERAL = 0, /* General Command/Event type */
UWB_RC_CET_EX_TYPE_1 = 1, /* Extended Type 1 Command/Event type */
};
/* Commands to the radio controller */
enum uwb_rc_cmd {
UWB_RC_CMD_CHANNEL_CHANGE = 16,
UWB_RC_CMD_DEV_ADDR_MGMT = 17, /* Device Address Management */
UWB_RC_CMD_GET_IE = 18, /* GET Information Elements */
UWB_RC_CMD_RESET = 19,
UWB_RC_CMD_SCAN = 20, /* Scan management */
UWB_RC_CMD_SET_BEACON_FILTER = 21,
UWB_RC_CMD_SET_DRP_IE = 22, /* Dynamic Reservation Protocol IEs */
UWB_RC_CMD_SET_IE = 23, /* Information Element management */
UWB_RC_CMD_SET_NOTIFICATION_FILTER = 24,
UWB_RC_CMD_SET_TX_POWER = 25,
UWB_RC_CMD_SLEEP = 26,
UWB_RC_CMD_START_BEACON = 27,
UWB_RC_CMD_STOP_BEACON = 28,
UWB_RC_CMD_BP_MERGE = 29,
UWB_RC_CMD_SEND_COMMAND_FRAME = 30,
UWB_RC_CMD_SET_ASIE_NOTIF = 31,
};
/* Notifications from the radio controller */
enum uwb_rc_evt {
UWB_RC_EVT_IE_RCV = 0,
UWB_RC_EVT_BEACON = 1,
UWB_RC_EVT_BEACON_SIZE = 2,
UWB_RC_EVT_BPOIE_CHANGE = 3,
UWB_RC_EVT_BP_SLOT_CHANGE = 4,
UWB_RC_EVT_BP_SWITCH_IE_RCV = 5,
UWB_RC_EVT_DEV_ADDR_CONFLICT = 6,
UWB_RC_EVT_DRP_AVAIL = 7,
UWB_RC_EVT_DRP = 8,
UWB_RC_EVT_BP_SWITCH_STATUS = 9,
UWB_RC_EVT_CMD_FRAME_RCV = 10,
UWB_RC_EVT_CHANNEL_CHANGE_IE_RCV = 11,
/* Events (command responses) use the same code as the command */
UWB_RC_EVT_UNKNOWN_CMD_RCV = 65535,
};
enum uwb_rc_extended_type_1_cmd {
UWB_RC_SET_DAA_ENERGY_MASK = 32,
UWB_RC_SET_NOTIFICATION_FILTER_EX = 33,
};
enum uwb_rc_extended_type_1_evt {
UWB_RC_DAA_ENERGY_DETECTED = 0,
};
/* Radio Control Result Code. [WHCI] table 3-3. */
enum {
UWB_RC_RES_SUCCESS = 0,
UWB_RC_RES_FAIL,
UWB_RC_RES_FAIL_HARDWARE,
UWB_RC_RES_FAIL_NO_SLOTS,
UWB_RC_RES_FAIL_BEACON_TOO_LARGE,