This repository holds files of metadata about Bluetooth entities. The Web Bluetooth specification refers to this repository for information that may change after it's published and defines the file formats here.
gatt_blocklist.txt holds a list of 128-bit GATT UUIDs that websites using the Web Bluetooth API are forbidden from accessing. This includes all of Services, Characteristics, and Descriptors.
manufacturer_data_blocklist.txt holds a list of manufacturer data that websites using the Web Bluetooth API are forbidden from accessing. Each entry of the list consists of a company identifier and data prefix that should be blocked.
These files contain comments in lines starting with #.
Non-comment lines contain one of these:
- A valid UUID
followed optionally by a space and one of the tokens "
exclude-reads" or "exclude-writes". - The word
manufacturerfollowed by a space and a group of hexadecimal digits (at most four hexadecimal digits) that represents a company identifier, which can be found on the Bluetooth Assigned Numbers website. A space after that is an advertising data prefix in the formatadvdata-<data>/<mask>, wheredataandmaskare strings of hexadecimal digits of the same length.datais a sequence of bytes. A data prefix matches an advertising data if each byte of the prefix is equal to the corresponding byte of the advertising data after both are ANDed with the corresponding byte of the mask. For example,advdata-001100/00FF00would match advertising data such as111111, or001122, etc.
gatt_assigned_services.txt, gatt_assigned_characteristics.txt, and gatt_assigned_descriptors.txt hold respectively a list of human-readable names for standardized GATT services, characteristics, and descriptors, and their 128-bit GATT UUIDs to use with the Web Bluetooth API.
These files contain comments in lines starting with #. Non-comment lines
contain a valid
name followed by a
space and a valid
UUID.