Bluetooth Reference
The Bluetooth GATT service provides functionality that enables the Velovision App to establish a Wi-Fi connection to Velovision Rearview.
Therefore, Bluetooth is only active in the unpaired state.
When Bluetooth is active, it provides the following abilities:
- Reading the current Wi-Fi SSID and password.
- Reading the device’s serial number and model ID.
- Writing a new Wi-Fi SSID and password in a single operation.
- Advertising the service for discoverability.
Service UUID
The service UUID uniquely identifies the Bluetooth GATT service.
| Name | UUID |
|---|---|
| Wi-Fi Service | 76656C6F-7669-7369-6F6E-000000000001 |
Characteristics
1. Wi-Fi SSID
This characteristic allows the client to read the current Wi-Fi SSID configured on the device.
| Property | Details |
|---|---|
| UUID | 76656C6F-7669-7369-6F6E-000000000002 |
| Access | Read |
| Description | Returns the current Wi-Fi SSID as a UTF-8 encoded string. |
| Error Handling | If the SSID cannot be loaded, an empty byte array is returned. |
2. Wi-Fi Password
This characteristic allows the client to read the current Wi-Fi password configured on the device.
| Property | Details |
|---|---|
| UUID | 76656C6F-7669-7369-6F6E-000000000003 |
| Access | Read |
| Description | Returns the current Wi-Fi password as a UTF-8 encoded string. |
| Error Handling | If the password cannot be loaded, an empty byte array is returned. |
3. Serial Number
This characteristic allows the client to read the device’s serial number.
| Property | Details |
|---|---|
| UUID | 76656C6F-7669-7369-6F6E-000000000004 |
| Access | Read |
| Description | Returns the device’s serial number as a UTF-8 encoded string. |
| Error Handling | If the serial number cannot be read, an empty byte array is returned. |
4. Model ID
This characteristic allows the client to read the device’s model ID.
| Property | Details |
|---|---|
| UUID | 76656C6F-7669-7369-6F6E-000000000006 |
| Access | Read |
| Description | Returns the device’s model ID as a UTF-8 encoded string. |
| Error Handling | If the model ID cannot be read, an empty byte array is returned. |
5. Set Wi-Fi SSID and Passphrase
This characteristic allows the client to write a new Wi-Fi SSID and password in a single operation. The SSID and password are concatenated into a single string, separated by a newline character (\n).
| Property | Details |
|---|---|
| UUID | 76656C6F-7669-7369-6F6E-000000000005 |
| Access | Write |
| Description | Accepts a UTF-8 encoded string containing the SSID and password. |
| Error Handling | If the input is invalid or cannot be processed, an error is logged. |
| Notes | The SSID and password must be separated by a newline character (\n). - This characteristic triggers the application of the new Wi-Fi settings. |
Manufacturer Data
The Bluetooth advertisement includes manufacturer-specific data. Velovision has been registered to Bluetooth SIG under “Tozoa LLC”, the parent company, and Tozoa LLC has received 0x0DDD as the identifying ID.
| Key | Value |
|---|---|
Manufacturer Data: [0x21, 0x22, 0x23, 0x24] | 0x0DDD |