firmwareSandsara
playlistCallbacks_pathName Class Reference

[BLE Command] This class is used to create an object to be called when you write or read the pathName characteristic. More...

Inheritance diagram for playlistCallbacks_pathName:
Collaboration diagram for playlistCallbacks_pathName:

Detailed Description

[BLE Command] This class is used to create an object to be called when you write or read the pathName characteristic.

all the paths have a unique name and the sandsara tracks are named starting with "Sandsara-trackNumber-", for example, "Sandsara-trackNumber-0001.thr". you can change or know the current path with this characteristic.

Properties:

  • Write
  • Read

UUID: 9b12a534-2c6e-11eb-adc1-0242ac120002

Usage: you can write to this characteristic to change the current path, or in the same way, you can read it to know it.

Range: accepted values are any name, for example "my track.thr", "path x.txt", etc.

**responses: **

  • "ok" means the path was changed successfully.
  • "-1" means the playlist you try to change does not exist.

This characteristic is used to "test" a path, this is the behavior when you change a path using this characteristic.

  1. Sandsara is playing the Geometries playlist and it is playing the 15 position track.
  2. you change to "my track.txt" using this characteristic.
  3. sandara will play "my track.txt"
  4. when it finishes, sandsara will go back to the 15 position track of the Geometries playlist.
Note
when you write to this characteristic you will be notified by the playlistCharacteristic_errorMsg characteristic for a response.
Warning
we recommend using playlistCallbacks_pathPosition to change a path.
See also
How to send a file? –> FilesCallbacks_receive, How to read the response of a characteristic

The documentation for this class was generated from the following file: