fermentord/vendor/github.com/JuulLabs-OSS/ble/uuid.go

216 lines
12 KiB
Go
Raw Normal View History

package ble
import (
"bytes"
"encoding/binary"
"encoding/hex"
"fmt"
"strings"
)
// A UUID is a BLE UUID.
type UUID []byte
// UUID16 converts a uint16 (such as 0x1800) to a UUID.
func UUID16(i uint16) UUID {
b := make([]byte, 2)
binary.LittleEndian.PutUint16(b, i)
return UUID(b)
}
// Parse parses a standard-format UUID string, such
// as "1800" or "34DA3AD1-7110-41A1-B1EF-4430F509CDE7".
func Parse(s string) (UUID, error) {
s = strings.Replace(s, "-", "", -1)
b, err := hex.DecodeString(s)
if err != nil {
return nil, err
}
if err := lenErr(len(b)); err != nil {
return nil, err
}
return UUID(Reverse(b)), nil
}
// MustParse parses a standard-format UUID string,
// like Parse, but panics in case of error.
func MustParse(s string) UUID {
u, err := Parse(s)
if err != nil {
panic(err)
}
return u
}
// lenErr returns an error if n is an invalid UUID length.
func lenErr(n int) error {
switch n {
case 2, 16:
return nil
}
return fmt.Errorf("UUIDs must have length 2 or 16, got %d", n)
}
// Len returns the length of the UUID, in bytes.
// BLE UUIDs are either 2 or 16 bytes.
func (u UUID) Len() int {
return len(u)
}
// String hex-encodes a UUID.
func (u UUID) String() string {
return fmt.Sprintf("%x", Reverse(u))
}
// Equal returns a boolean reporting whether v represent the same UUID as u.
func (u UUID) Equal(v UUID) bool {
return bytes.Equal(u, v)
}
// Contains returns a boolean reporting whether u is in the slice s.
func Contains(s []UUID, u UUID) bool {
if s == nil {
return true
}
for _, a := range s {
if a.Equal(u) {
return true
}
}
return false
}
// Reverse returns a reversed copy of u.
func Reverse(u []byte) []byte {
l := len(u)
b := make([]byte, l)
for i := 0; i < l; i++ {
b[l-i-1] = u[i]
}
return b
}
// Name returns name of know services, characteristics, or descriptors.
func Name(u UUID) string {
return knownUUID[u.String()].Name
}
// A dictionary of known service names and type (keyed by service uuid)
var knownUUID = map[string]struct{ Name, Type string }{
"1800": {Name: "Generic Access", Type: "org.bluetooth.service.generic_access"},
"1801": {Name: "Generic Attribute", Type: "org.bluetooth.service.generic_attribute"},
"1802": {Name: "Immediate Alert", Type: "org.bluetooth.service.immediate_alert"},
"1803": {Name: "Link Loss", Type: "org.bluetooth.service.link_loss"},
"1804": {Name: "Tx Power", Type: "org.bluetooth.service.tx_power"},
"1805": {Name: "Current Time Service", Type: "org.bluetooth.service.current_time"},
"1806": {Name: "Reference Time Update Service", Type: "org.bluetooth.service.reference_time_update"},
"1807": {Name: "Next DST Change Service", Type: "org.bluetooth.service.next_dst_change"},
"1808": {Name: "Glucose", Type: "org.bluetooth.service.glucose"},
"1809": {Name: "Health Thermometer", Type: "org.bluetooth.service.health_thermometer"},
"180a": {Name: "Device Information", Type: "org.bluetooth.service.device_information"},
"180d": {Name: "Heart Rate", Type: "org.bluetooth.service.heart_rate"},
"180e": {Name: "Phone Alert Status Service", Type: "org.bluetooth.service.phone_alert_service"},
"180f": {Name: "Battery Service", Type: "org.bluetooth.service.battery_service"},
"1810": {Name: "Blood Pressure", Type: "org.bluetooth.service.blood_pressuer"},
"1811": {Name: "Alert Notification Service", Type: "org.bluetooth.service.alert_notification"},
"1812": {Name: "Human Interface Device", Type: "org.bluetooth.service.human_interface_device"},
"1813": {Name: "Scan Parameters", Type: "org.bluetooth.service.scan_parameters"},
"1814": {Name: "Running Speed and Cadence", Type: "org.bluetooth.service.running_speed_and_cadence"},
"1815": {Name: "Cycling Speed and Cadence", Type: "org.bluetooth.service.cycling_speed_and_cadence"},
// A dictionary of known descriptor names and type (keyed by attribute uuid)
"2800": {Name: "Primary Service", Type: "org.bluetooth.attribute.gatt.primary_service_declaration"},
"2801": {Name: "Secondary Service", Type: "org.bluetooth.attribute.gatt.secondary_service_declaration"},
"2802": {Name: "Include", Type: "org.bluetooth.attribute.gatt.include_declaration"},
"2803": {Name: "Characteristic", Type: "org.bluetooth.attribute.gatt.characteristic_declaration"},
// A dictionary of known descriptor names and type (keyed by descriptor uuid)
"2900": {Name: "Characteristic Extended Properties", Type: "org.bluetooth.descriptor.gatt.characteristic_extended_properties"},
"2901": {Name: "Characteristic User Description", Type: "org.bluetooth.descriptor.gatt.characteristic_user_description"},
"2902": {Name: "Client Characteristic Configuration", Type: "org.bluetooth.descriptor.gatt.client_characteristic_configuration"},
"2903": {Name: "Server Characteristic Configuration", Type: "org.bluetooth.descriptor.gatt.server_characteristic_configuration"},
"2904": {Name: "Characteristic Presentation Format", Type: "org.bluetooth.descriptor.gatt.characteristic_presentation_format"},
"2905": {Name: "Characteristic Aggregate Format", Type: "org.bluetooth.descriptor.gatt.characteristic_aggregate_format"},
"2906": {Name: "Valid Range", Type: "org.bluetooth.descriptor.valid_range"},
"2907": {Name: "External Report Reference", Type: "org.bluetooth.descriptor.external_report_reference"},
"2908": {Name: "Report Reference", Type: "org.bluetooth.descriptor.report_reference"},
// A dictionary of known characteristic names and type (keyed by characteristic uuid)
"2a00": {Name: "Device Name", Type: "org.bluetooth.characteristic.ble.device_name"},
"2a01": {Name: "Appearance", Type: "org.bluetooth.characteristic.ble.appearance"},
"2a02": {Name: "Peripheral Privacy Flag", Type: "org.bluetooth.characteristic.ble.peripheral_privacy_flag"},
"2a03": {Name: "Reconnection Address", Type: "org.bluetooth.characteristic.ble.reconnection_address"},
"2a04": {Name: "Peripheral Preferred Connection Parameters", Type: "org.bluetooth.characteristic.ble.peripheral_preferred_connection_parameters"},
"2a05": {Name: "Service Changed", Type: "org.bluetooth.characteristic.gatt.service_changed"},
"2a06": {Name: "Alert Level", Type: "org.bluetooth.characteristic.alert_level"},
"2a07": {Name: "Tx Power Level", Type: "org.bluetooth.characteristic.tx_power_level"},
"2a08": {Name: "Date Time", Type: "org.bluetooth.characteristic.date_time"},
"2a09": {Name: "Day of Week", Type: "org.bluetooth.characteristic.day_of_week"},
"2a0a": {Name: "Day Date Time", Type: "org.bluetooth.characteristic.day_date_time"},
"2a0c": {Name: "Exact Time 256", Type: "org.bluetooth.characteristic.exact_time_256"},
"2a0d": {Name: "DST Offset", Type: "org.bluetooth.characteristic.dst_offset"},
"2a0e": {Name: "Time Zone", Type: "org.bluetooth.characteristic.time_zone"},
"2a0f": {Name: "Local Time Information", Type: "org.bluetooth.characteristic.local_time_information"},
"2a11": {Name: "Time with DST", Type: "org.bluetooth.characteristic.time_with_dst"},
"2a12": {Name: "Time Accuracy", Type: "org.bluetooth.characteristic.time_accuracy"},
"2a13": {Name: "Time Source", Type: "org.bluetooth.characteristic.time_source"},
"2a14": {Name: "Reference Time Information", Type: "org.bluetooth.characteristic.reference_time_information"},
"2a16": {Name: "Time Update Control Point", Type: "org.bluetooth.characteristic.time_update_control_point"},
"2a17": {Name: "Time Update State", Type: "org.bluetooth.characteristic.time_update_state"},
"2a18": {Name: "Glucose Measurement", Type: "org.bluetooth.characteristic.glucose_measurement"},
"2a19": {Name: "Battery Level", Type: "org.bluetooth.characteristic.battery_level"},
"2a1c": {Name: "Temperature Measurement", Type: "org.bluetooth.characteristic.temperature_measurement"},
"2a1d": {Name: "Temperature Type", Type: "org.bluetooth.characteristic.temperature_type"},
"2a1e": {Name: "Intermediate Temperature", Type: "org.bluetooth.characteristic.intermediate_temperature"},
"2a21": {Name: "Measurement Interval", Type: "org.bluetooth.characteristic.measurement_interval"},
"2a22": {Name: "Boot Keyboard Input Report", Type: "org.bluetooth.characteristic.boot_keyboard_input_report"},
"2a23": {Name: "System ID", Type: "org.bluetooth.characteristic.system_id"},
"2a24": {Name: "Model Number String", Type: "org.bluetooth.characteristic.model_number_string"},
"2a25": {Name: "Serial Number String", Type: "org.bluetooth.characteristic.serial_number_string"},
"2a26": {Name: "Firmware Revision String", Type: "org.bluetooth.characteristic.firmware_revision_string"},
"2a27": {Name: "Hardware Revision String", Type: "org.bluetooth.characteristic.hardware_revision_string"},
"2a28": {Name: "Software Revision String", Type: "org.bluetooth.characteristic.software_revision_string"},
"2a29": {Name: "Manufacturer Name String", Type: "org.bluetooth.characteristic.manufacturer_name_string"},
"2a2a": {Name: "IEEE 11073-20601 Regulatory Certification Data List", Type: "org.bluetooth.characteristic.ieee_11073-20601_regulatory_certification_data_list"},
"2a2b": {Name: "Current Time", Type: "org.bluetooth.characteristic.current_time"},
"2a31": {Name: "Scan Refresh", Type: "org.bluetooth.characteristic.scan_refresh"},
"2a32": {Name: "Boot Keyboard Output Report", Type: "org.bluetooth.characteristic.boot_keyboard_output_report"},
"2a33": {Name: "Boot Mouse Input Report", Type: "org.bluetooth.characteristic.boot_mouse_input_report"},
"2a34": {Name: "Glucose Measurement Context", Type: "org.bluetooth.characteristic.glucose_measurement_context"},
"2a35": {Name: "Blood Pressure Measurement", Type: "org.bluetooth.characteristic.blood_pressure_measurement"},
"2a36": {Name: "Intermediate Cuff Pressure", Type: "org.bluetooth.characteristic.intermediate_blood_pressure"},
"2a37": {Name: "Heart Rate Measurement", Type: "org.bluetooth.characteristic.heart_rate_measurement"},
"2a38": {Name: "Body Sensor Location", Type: "org.bluetooth.characteristic.body_sensor_location"},
"2a39": {Name: "Heart Rate Control Point", Type: "org.bluetooth.characteristic.heart_rate_control_point"},
"2a3f": {Name: "Alert Status", Type: "org.bluetooth.characteristic.alert_status"},
"2a40": {Name: "Ringer Control Point", Type: "org.bluetooth.characteristic.ringer_control_point"},
"2a41": {Name: "Ringer Setting", Type: "org.bluetooth.characteristic.ringer_setting"},
"2a42": {Name: "Alert Category ID Bit Mask", Type: "org.bluetooth.characteristic.alert_category_id_bit_mask"},
"2a43": {Name: "Alert Category ID", Type: "org.bluetooth.characteristic.alert_category_id"},
"2a44": {Name: "Alert Notification Control Point", Type: "org.bluetooth.characteristic.alert_notification_control_point"},
"2a45": {Name: "Unread Alert Status", Type: "org.bluetooth.characteristic.unread_alert_status"},
"2a46": {Name: "New Alert", Type: "org.bluetooth.characteristic.new_alert"},
"2a47": {Name: "Supported New Alert Category", Type: "org.bluetooth.characteristic.supported_new_alert_category"},
"2a48": {Name: "Supported Unread Alert Category", Type: "org.bluetooth.characteristic.supported_unread_alert_category"},
"2a49": {Name: "Blood Pressure Feature", Type: "org.bluetooth.characteristic.blood_pressure_feature"},
"2a4a": {Name: "HID Information", Type: "org.bluetooth.characteristic.hid_information"},
"2a4b": {Name: "Report Map", Type: "org.bluetooth.characteristic.report_map"},
"2a4c": {Name: "HID Control Point", Type: "org.bluetooth.characteristic.hid_control_point"},
"2a4d": {Name: "Report", Type: "org.bluetooth.characteristic.report"},
"2a4e": {Name: "Protocol Mode", Type: "org.bluetooth.characteristic.protocol_mode"},
"2a4f": {Name: "Scan Interval Window", Type: "org.bluetooth.characteristic.scan_interval_window"},
"2a50": {Name: "PnP ID", Type: "org.bluetooth.characteristic.pnp_id"},
"2a51": {Name: "Glucose Feature", Type: "org.bluetooth.characteristic.glucose_feature"},
"2a52": {Name: "Record Access Control Point", Type: "org.bluetooth.characteristic.record_access_control_point"},
"2a53": {Name: "RSC Measurement", Type: "org.bluetooth.characteristic.rsc_measurement"},
"2a54": {Name: "RSC Feature", Type: "org.bluetooth.characteristic.rsc_feature"},
"2a55": {Name: "SC Control Point", Type: "org.bluetooth.characteristic.sc_control_point"},
"2a5b": {Name: "CSC Measurement", Type: "org.bluetooth.characteristic.csc_measurement"},
"2a5c": {Name: "CSC Feature", Type: "org.bluetooth.characteristic.csc_feature"},
"2a5d": {Name: "Sensor Location", Type: "org.bluetooth.characteristic.sensor_location"},
}