blob: 08f073c959463488eaec2365ded2f4131624f4eb [file] [log] [blame]
// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "third_party/blink/renderer/modules/bluetooth/bluetooth_uuid.h"
#include "third_party/blink/renderer/platform/bindings/exception_state.h"
#include "third_party/blink/renderer/platform/uuid.h"
#include "third_party/blink/renderer/platform/wtf/hash_map.h"
#include "third_party/blink/renderer/platform/wtf/hex_number.h"
#include "third_party/blink/renderer/platform/wtf/text/string_builder.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
namespace blink {
namespace {
typedef WTF::HashMap<String, unsigned> NameToAssignedNumberMap;
enum class GATTAttribute { kService, kCharacteristic, kDescriptor };
NameToAssignedNumberMap* GetAssignedNumberToServiceNameMap() {
DEFINE_THREAD_SAFE_STATIC_LOCAL(
NameToAssignedNumberMap, services_map,
({
// https://www.bluetooth.com/specifications/gatt/services
{"generic_access", 0x1800},
{"generic_attribute", 0x1801},
{"immediate_alert", 0x1802},
{"link_loss", 0x1803},
{"tx_power", 0x1804},
{"current_time", 0x1805},
{"reference_time_update", 0x1806},
{"next_dst_change", 0x1807},
{"glucose", 0x1808},
{"health_thermometer", 0x1809},
{"device_information", 0x180A},
{"heart_rate", 0x180D},
{"phone_alert_status", 0x180E},
{"battery_service", 0x180F},
{"blood_pressure", 0x1810},
{"alert_notification", 0x1811},
{"human_interface_device", 0x1812},
{"scan_parameters", 0x1813},
{"running_speed_and_cadence", 0x1814},
{"automation_io", 0x1815},
{"cycling_speed_and_cadence", 0x1816},
{"cycling_power", 0x1818},
{"location_and_navigation", 0x1819},
{"environmental_sensing", 0x181A},
{"body_composition", 0x181B},
{"user_data", 0x181C},
{"weight_scale", 0x181D},
{"bond_management", 0x181E},
{"continuous_glucose_monitoring", 0x181F},
{"internet_protocol_support", 0x1820},
{"indoor_positioning", 0x1821},
{"pulse_oximeter", 0x1822},
{"http_proxy", 0x1823},
{"transport_discovery", 0x1824},
{"object_transfer", 0x1825},
{"fitness_machine", 0x1826},
{"mesh_provisioning", 0x1827},
{"mesh_proxy", 0x1828},
{"reconnection_configuration", 0x1829},
}));
return &services_map;
}
NameToAssignedNumberMap* GetAssignedNumberForCharacteristicNameMap() {
DEFINE_THREAD_SAFE_STATIC_LOCAL(
NameToAssignedNumberMap, characteristics_map,
({
// https://www.bluetooth.com/specifications/gatt/characteristics
{"gap.device_name", 0x2A00},
{"gap.appearance", 0x2A01},
{"gap.peripheral_privacy_flag", 0x2A02},
{"gap.reconnection_address", 0x2A03},
{"gap.peripheral_preferred_connection_parameters", 0x2A04},
{"gatt.service_changed", 0x2A05},
{"alert_level", 0x2A06},
{"tx_power_level", 0x2A07},
{"date_time", 0x2A08},
{"day_of_week", 0x2A09},
{"day_date_time", 0x2A0A},
{"exact_time_100", 0x2A0B},
{"exact_time_256", 0x2A0C},
{"dst_offset", 0x2A0D},
{"time_zone", 0x2A0E},
{"local_time_information", 0x2A0F},
{"secondary_time_zone", 0x2A10},
{"time_with_dst", 0x2A11},
{"time_accuracy", 0x2A12},
{"time_source", 0x2A13},
{"reference_time_information", 0x2A14},
{"time_broadcast", 0x2A15},
{"time_update_control_point", 0x2A16},
{"time_update_state", 0x2A17},
{"glucose_measurement", 0x2A18},
{"battery_level", 0x2A19},
{"battery_power_state", 0x2A1A},
{"battery_level_state", 0x2A1B},
{"temperature_measurement", 0x2A1C},
{"temperature_type", 0x2A1D},
{"intermediate_temperature", 0x2A1E},
{"temperature_celsius", 0x2A1F},
{"temperature_fahrenheit", 0x2A20},
{"measurement_interval", 0x2A21},
{"boot_keyboard_input_report", 0x2A22},
{"system_id", 0x2A23},
{"model_number_string", 0x2A24},
{"serial_number_string", 0x2A25},
{"firmware_revision_string", 0x2A26},
{"hardware_revision_string", 0x2A27},
{"software_revision_string", 0x2A28},
{"manufacturer_name_string", 0x2A29},
{"ieee_11073-20601_regulatory_certification_data_list", 0x2A2A},
{"current_time", 0x2A2B},
{"magnetic_declination", 0x2A2C},
{"position_2d", 0x2A2F},
{"position_3d", 0x2A30},
{"scan_refresh", 0x2A31},
{"boot_keyboard_output_report", 0x2A32},
{"boot_mouse_input_report", 0x2A33},
{"glucose_measurement_context", 0x2A34},
{"blood_pressure_measurement", 0x2A35},
{"intermediate_cuff_pressure", 0x2A36},
{"heart_rate_measurement", 0x2A37},
{"body_sensor_location", 0x2A38},
{"heart_rate_control_point", 0x2A39},
{"removable", 0x2A3A},
{"service_required", 0x2A3B},
{"scientific_temperature_celsius", 0x2A3C},
{"string", 0x2A3D},
{"network_availability", 0x2A3E},
{"alert_status", 0x2A3F},
{"ringer_control_point", 0x2A40},
{"ringer_setting", 0x2A41},
{"alert_category_id_bit_mask", 0x2A42},
{"alert_category_id", 0x2A43},
{"alert_notification_control_point", 0x2A44},
{"unread_alert_status", 0x2A45},
{"new_alert", 0x2A46},
{"supported_new_alert_category", 0x2A47},
{"supported_unread_alert_category", 0x2A48},
{"blood_pressure_feature", 0x2A49},
{"hid_information", 0x2A4A},
{"report_map", 0x2A4B},
{"hid_control_point", 0x2A4C},
{"report", 0x2A4D},
{"protocol_mode", 0x2A4E},
{"scan_interval_window", 0x2A4F},
{"pnp_id", 0x2A50},
{"glucose_feature", 0x2A51},
{"record_access_control_point", 0x2A52},
{"rsc_measurement", 0x2A53},
{"rsc_feature", 0x2A54},
{"sc_control_point", 0x2A55},
{"digital", 0x2A56},
{"digital_output", 0x2A57},
{"analog", 0x2A58},
{"analog_output", 0x2A59},
{"aggregate", 0x2A5A},
{"csc_measurement", 0x2A5B},
{"csc_feature", 0x2A5C},
{"sensor_location", 0x2A5D},
{"plx_spot_check_measurement", 0x2A5E},
{"plx_continuous_measurement", 0x2A5F},
{"plx_features", 0x2A60},
{"pulse_oximetry_control_point", 0x2A62},
{"cycling_power_measurement", 0x2A63},
{"cycling_power_vector", 0x2A64},
{"cycling_power_feature", 0x2A65},
{"cycling_power_control_point", 0x2A66},
{"location_and_speed", 0x2A67},
{"navigation", 0x2A68},
{"position_quality", 0x2A69},
{"ln_feature", 0x2A6A},
{"ln_control_point", 0x2A6B},
{"elevation", 0x2A6C},
{"pressure", 0x2A6D},
{"temperature", 0x2A6E},
{"humidity", 0x2A6F},
{"true_wind_speed", 0x2A70},
{"true_wind_direction", 0x2A71},
{"apparent_wind_speed", 0x2A72},
{"apparent_wind_direction", 0x2A73},
{"gust_factor", 0x2A74},
{"pollen_concentration", 0x2A75},
{"uv_index", 0x2A76},
{"irradiance", 0x2A77},
{"rainfall", 0x2A78},
{"wind_chill", 0x2A79},
{"heat_index", 0x2A7A},
{"dew_point", 0x2A7B},
{"descriptor_value_changed", 0x2A7D},
{"aerobic_heart_rate_lower_limit", 0x2A7E},
{"aerobic_threshold", 0x2A7F},
{"age", 0x2A80},
{"anaerobic_heart_rate_lower_limit", 0x2A81},
{"anaerobic_heart_rate_upper_limit", 0x2A82},
{"anaerobic_threshold", 0x2A83},
{"aerobic_heart_rate_upper_limit", 0x2A84},
{"date_of_birth", 0x2A85},
{"date_of_threshold_assessment", 0x2A86},
{"email_address", 0x2A87},
{"fat_burn_heart_rate_lower_limit", 0x2A88},
{"fat_burn_heart_rate_upper_limit", 0x2A89},
{"first_name", 0x2A8A},
{"five_zone_heart_rate_limits", 0x2A8B},
{"gender", 0x2A8C},
{"heart_rate_max", 0x2A8D},
{"height", 0x2A8E},
{"hip_circumference", 0x2A8F},
{"last_name", 0x2A90},
{"maximum_recommended_heart_rate", 0x2A91},
{"resting_heart_rate", 0x2A92},
{"sport_type_for_aerobic_and_anaerobic_thresholds", 0x2A93},
{"three_zone_heart_rate_limits", 0x2A94},
{"two_zone_heart_rate_limit", 0x2A95},
{"vo2_max", 0x2A96},
{"waist_circumference", 0x2A97},
{"weight", 0x2A98},
{"database_change_increment", 0x2A99},
{"user_index", 0x2A9A},
{"body_composition_feature", 0x2A9B},
{"body_composition_measurement", 0x2A9C},
{"weight_measurement", 0x2A9D},
{"weight_scale_feature", 0x2A9E},
{"user_control_point", 0x2A9F},
{"magnetic_flux_density_2D", 0x2AA0},
{"magnetic_flux_density_3D", 0x2AA1},
{"language", 0x2AA2},
{"barometric_pressure_trend", 0x2AA3},
{"bond_management_control_point", 0x2AA4},
{"bond_management_feature", 0x2AA5},
{"gap.central_address_resolution_support", 0x2AA6},
{"cgm_measurement", 0x2AA7},
{"cgm_feature", 0x2AA8},
{"cgm_status", 0x2AA9},
{"cgm_session_start_time", 0x2AAA},
{"cgm_session_run_time", 0x2AAB},
{"cgm_specific_ops_control_point", 0x2AAC},
{"indoor_positioning_configuration", 0x2AAD},
{"latitude", 0x2AAE},
{"longitude", 0x2AAF},
{"local_north_coordinate", 0x2AB0},
{"local_east_coordinate.xml", 0x2AB1},
{"floor_number", 0x2AB2},
{"altitude", 0x2AB3},
{"uncertainty", 0x2AB4},
{"location_name", 0x2AB5},
{"uri", 0x2AB6},
{"http_headers", 0x2AB7},
{"http_status_code", 0x2AB8},
{"http_entity_body", 0x2AB9},
{"http_control_point", 0x2ABA},
{"https_security", 0x2ABB},
{"tds_control_point", 0x2ABC},
{"ots_feature", 0x2ABD},
{"object_name", 0x2ABE},
{"object_type", 0x2ABF},
{"object_size", 0x2AC0},
{"object_first_created", 0x2AC1},
{"object_last_modified", 0x2AC2},
{"object_id", 0x2AC3},
{"object_properties", 0x2AC4},
{"object_action_control_point", 0x2AC5},
{"object_list_control_point", 0x2AC6},
{"object_list_filter", 0x2AC7},
{"object_changed", 0x2AC8},
{"resolvable_private_address_only", 0x2AC9},
{"fitness_machine_feature", 0x2ACC},
{"treadmill_data", 0x2ACD},
{"cross_trainer_data", 0x2ACE},
{"step_climber_data", 0x2ACF},
{"stair_climber_data", 0x2AD0},
{"rower_data", 0x2AD1},
{"indoor_bike_data", 0x2AD2},
{"training_status", 0x2AD3},
{"supported_speed_range", 0x2AD4},
{"supported_inclination_range", 0x2AD5},
{"supported_resistance_level_range", 0x2AD6},
{"supported_heart_rate_range", 0x2AD7},
{"supported_power_range", 0x2AD8},
{"fitness_machine_control_point", 0x2AD9},
{"fitness_machine_status", 0x2ADA},
{"date_utc", 0x2AED},
}));
return &characteristics_map;
}
NameToAssignedNumberMap* GetAssignedNumberForDescriptorNameMap() {
DEFINE_THREAD_SAFE_STATIC_LOCAL(
NameToAssignedNumberMap, descriptors_map,
({
// https://www.bluetooth.com/specifications/gatt/descriptors
{"gatt.characteristic_extended_properties", 0x2900},
{"gatt.characteristic_user_description", 0x2901},
{"gatt.client_characteristic_configuration", 0x2902},
{"gatt.server_characteristic_configuration", 0x2903},
{"gatt.characteristic_presentation_format", 0x2904},
{"gatt.characteristic_aggregate_format", 0x2905},
{"valid_range", 0x2906},
{"external_report_reference", 0x2907},
{"report_reference", 0x2908},
{"number_of_digitals", 0x2909},
{"value_trigger_setting", 0x290A},
{"es_configuration", 0x290B},
{"es_measurement", 0x290C},
{"es_trigger_setting", 0x290D},
{"time_trigger_setting", 0x290E},
}));
return &descriptors_map;
}
String GetUUIDForGATTAttribute(GATTAttribute attribute,
StringOrUnsignedLong name,
ExceptionState& exception_state) {
// Implementation of BluetoothUUID.getService, BluetoothUUID.getCharacteristic
// and BluetoothUUID.getDescriptor algorithms:
// https://webbluetoothcg.github.io/web-bluetooth/#dom-bluetoothuuid-getservice
// https://webbluetoothcg.github.io/web-bluetooth/#dom-bluetoothuuid-getcharacteristic
// https://webbluetoothcg.github.io/web-bluetooth/#dom-bluetoothuuid-getdescriptor
// If name is an unsigned long, return BluetoothUUID.cannonicalUUI(name) and
// abort this steps.
if (name.IsUnsignedLong())
return BluetoothUUID::canonicalUUID(name.GetAsUnsignedLong());
String name_str = name.GetAsString();
// If name is a valid UUID, return name and abort these steps.
if (IsValidUUID(name_str))
return name_str;
// If name is in the corresponding attribute map return
// BluetoothUUID.cannonicalUUID(alias).
NameToAssignedNumberMap* map = nullptr;
const char* attribute_type = nullptr;
switch (attribute) {
case GATTAttribute::kService:
map = GetAssignedNumberToServiceNameMap();
attribute_type = "Service";
break;
case GATTAttribute::kCharacteristic:
map = GetAssignedNumberForCharacteristicNameMap();
attribute_type = "Characteristic";
break;
case GATTAttribute::kDescriptor:
map = GetAssignedNumberForDescriptorNameMap();
attribute_type = "Descriptor";
break;
}
if (map->Contains(name_str))
return BluetoothUUID::canonicalUUID(map->at(name_str));
StringBuilder error_message;
error_message.Append("Invalid ");
error_message.Append(attribute_type);
error_message.Append(" name: '");
error_message.Append(name_str);
error_message.Append(
"'. It must be a valid UUID alias (e.g. 0x1234), "
"UUID (lowercase hex characters e.g. "
"'00001234-0000-1000-8000-00805f9b34fb'), "
"or recognized standard name from ");
switch (attribute) {
case GATTAttribute::kService:
error_message.Append(
"https://www.bluetooth.com/specifications/gatt/services"
" e.g. 'alert_notification'.");
break;
case GATTAttribute::kCharacteristic:
error_message.Append(
"https://www.bluetooth.com/specifications/gatt/characteristics"
" e.g. 'aerobic_heart_rate_lower_limit'.");
break;
case GATTAttribute::kDescriptor:
error_message.Append(
"https://www.bluetooth.com/specifications/gatt/descriptors"
" e.g. 'gatt.characteristic_presentation_format'.");
break;
}
// Otherwise, throw a TypeError.
exception_state.ThrowTypeError(error_message.ToString());
return String();
}
} // namespace
// static
String BluetoothUUID::getService(StringOrUnsignedLong name,
ExceptionState& exception_state) {
return GetUUIDForGATTAttribute(GATTAttribute::kService, name,
exception_state);
}
// static
String BluetoothUUID::getCharacteristic(StringOrUnsignedLong name,
ExceptionState& exception_state) {
return GetUUIDForGATTAttribute(GATTAttribute::kCharacteristic, name,
exception_state);
}
// static
String BluetoothUUID::getDescriptor(StringOrUnsignedLong name,
ExceptionState& exception_state) {
return GetUUIDForGATTAttribute(GATTAttribute::kDescriptor, name,
exception_state);
}
// static
String BluetoothUUID::canonicalUUID(unsigned alias) {
StringBuilder builder;
builder.ReserveCapacity(36 /* 36 chars or 128 bits, length of a UUID */);
HexNumber::AppendUnsignedAsHexFixedSize(
alias, builder, 8 /* 8 chars or 32 bits, prefix length */,
HexNumber::kLowercase);
builder.Append("-0000-1000-8000-00805f9b34fb");
return builder.ToString();
}
} // namespace blink