btdrv: label relevant firmware ranges for definitions that have changed over time

This commit is contained in:
ndeadly 2021-04-16 23:57:53 +02:00 committed by Dave Murphy
parent 93c20f3a45
commit 106cadfd3b
2 changed files with 18 additions and 18 deletions

View File

@ -34,14 +34,14 @@ typedef struct {
u8 rssi[0x4]; ///< s32 RSSI
u8 name3[0x4]; ///< Two bytes which are the same as name[11-12].
u8 reserved_x36D[0x10]; ///< Reserved
} v1;
} v1; ///< [1.0.0-11.0.1]
struct {
BtdrvAddress addr; ///< Device address.
char name[0xF9]; ///< Device name, NUL-terminated string.
BtdrvClassOfDevice class_of_device; ///< Class of Device.
u8 reserved[0x6]; ///< Reserved
} v12;
} v12; ///< [12.0.0+]
};
} inquiry_device; ///< ::BtdrvEventType_InquiryDevice
@ -49,13 +49,13 @@ typedef struct {
union {
struct {
BtdrvInquiryStatus status; ///< Status: 0 = stopped, 1 = started.
} v1;
} v1; ///< [1.0.0-11.0.1]
struct {
BtdrvInquiryStatus status; ///< Status: 0 = stopped, 1 = started.
u8 pad[3]; ///< Padding
u32 service_mask; ///< Services value from /ref btdrvStartInquiry when starting, otherwise this is value 0
} v12;
} v12; ///< [12.0.0+]
};
} inquiry_status; ///< ::BtdrvEventType_InquiryStatus
@ -74,7 +74,7 @@ typedef struct {
u8 pad[2]; ///< Padding
u32 type; ///< 0 = SSP confirm request, 3 = SSP passkey notification.
s32 passkey; ///< Passkey, only set when the above field is value 3.
} v1;
} v1; ///< [1.0.0-11.0.1]
struct {
BtdrvAddress addr; ///< Device address.
@ -83,8 +83,8 @@ typedef struct {
u32 type; ///< 0 = SSP confirm request, 3 = SSP passkey notification.
u8 pad; ///< Padding
s32 passkey; ///< Passkey, only set when the above field is value 3.
} v12;
};
} v12; ///< [12.0.0+]
};
} ssp_request; ///< ::BtdrvEventType_SspRequest
@ -95,13 +95,13 @@ typedef struct {
BtdrvAddress addr; ///< Device address.
u8 pad[2]; ///< Padding
u32 type; ///< \ref BtdrvConnectionEventType
} v1;
} v1; ///< [1.0.0-11.0.1]
struct {
u32 type; ///< \ref BtdrvConnectionEventType
BtdrvAddress addr; ///< Device address.
u8 reserved[0xfe]; ///< Reserved
} v12;
} v12; ///< [12.0.0+]
};
} connection; ///< ::BtdrvEventType_Connection
@ -151,12 +151,12 @@ typedef struct {
BtdrvAddress addr; ///< Device address.
u8 pad[2]; ///< Padding
BtdrvHidConnectionStatus status; ///< Status: 0 = hid connection opened, 2 = hid connection closed, 8 = failed to open hid connection.
} v1;
} v1; ///< [1.0.0-11.0.1]
struct {
BtdrvHidConnectionStatus status; ///< Status: 1 = hid connection opened, 0 = hid connection closed
BtdrvAddress addr; ///< Device address.
} v12;
} v12; ///< [12.0.0+]
};
} connection; ///< ::BtdrvHidEventType_Connection
@ -225,14 +225,14 @@ typedef struct {
BtdrvAddress addr; ///< \ref BtdrvAddress
u8 unused2[0x3]; ///< Unused
BtdrvHidData report;
} v1; ///< Pre-7.0.0
} v1; ///< [1.0.0-6.2.0]
struct {
u8 unused[0x3]; ///< Unused
BtdrvAddress addr; ///< \ref BtdrvAddress
u8 unused2[0x3]; ///< Unused
BtdrvHidData report;
} v7; ///< Pre-9.0.0
} v7; ///< [7.0.0-8.1.1]
struct {
u32 res; ///< Always 0.
@ -268,7 +268,7 @@ typedef struct {
BtdrvHidData report; ///< \ref BtdrvHidData
u8 pad2[2]; ///< Padding
};
} v1; ///< Pre-9.0.0
} v1; ///< [1.0.0-8.1.1]
union {
u8 rawdata[0x2C8]; ///< Raw data.

View File

@ -91,7 +91,7 @@ typedef enum {
BtdrvHidEventTypeOld_GetReport = 9, ///< Response to GET_REPORT.
} BtdrvHidEventType;
/// HidConnectionStatus [12.0.0]
/// HidConnectionStatus [12.0.0+]
typedef enum {
///< BtdrvHidConnectionStatus_* should be used on [12.0.0+]
BtdrvHidConnectionStatus_Disconnected = 0,
@ -148,7 +148,7 @@ typedef struct {
u8 feature_set; ///< Set to hard-coded value 0x68 (same as the data for ::BtdrvBluetoothPropertyType_FeatureSet).
} BtdrvAdapterProperty;
/// BluetoothPinCode
/// BluetoothPinCode [1.0.0-11.0.1]
typedef struct {
char code[0x10]; ///< PinCode
} BtdrvBluetoothPinCode;
@ -159,13 +159,13 @@ typedef struct {
u8 length; ///< Length
} BtdrvPinCode;
/// HidData, for pre-9.0.0.
/// HidData [1.0.0-8.1.1]
typedef struct {
u16 size; ///< Size of data.
u8 data[0x280]; ///< Data
} BtdrvHidData;
/// HidReport, for [9.0.0+].
/// HidReport [9.0.0+].
typedef struct {
u16 size; ///< Size of data.
u8 data[0x2BC]; ///< Data