PlatoButton

Implements the missing pieces of the platoworks headset:

• Buttons to select mode, time, power, start and stop

• Offline mode (no internet access, mobile phone, gps location, identity required)

• Bluetooth-LE gattlib access is done with: https://github.com/labapart/gattlib.git

Todo/FIXME

• implement terminal_input_available by looking at
  • https://github.com/pallets/click/blob/97fde8bf50058c19a77d4de46b9c54b1731b1750/src/click/_termui_impl.py#L642
• implement to shutdown headset if program is aborted (CTRL-C)

Build

# clone this source with submodules
git clone --recurse-submodules https://github.com/wuxxin/platobutton.git
# install build requirements
sudo apt install build-essential cmake libbluetooth-dev libreadline-dev
# generate makefile
mkdir platobutton/vendor/gattlib/build
cd platobutton/vendor/gattlib/build
cmake -DGATTLIB_BUILD_DOCS=OFF ..
# build
make
# install binary libraries
sudo make install
cd ../../..
# create virtual python environment, install click and gattlib
python3 -m venv ./venv
. ./venv/bin/activate
pip install click ./vendor/gattlib/gattlib-py

Usage

./venv/bin/activate
./platobutton.py [-d <device>] [-m <mode>] [-t <minutes>] [-p <mikroampere>]

Bluetooth Protocol

• Presetup / Discovery

  • plato_service = "e8f22220-9796-42a1-92ef-f65a7f9d6d79"

• Loop

  • Write Command
    • plato_write_uuid = "e8f20002-9796-42a1-92ef-f65a7f9d6d79"
    • (G)ATT Write Request (0x12), Handle: 0x0014
    • (G)ATT Write Response (0x13), Handle: 0x0014
  • Read Command Response
    • plato_read_uuid = "e8f20001-9796-42a1-92ef-f65a7f9d6d79"
    • (G)ATT Read Request (0x0a), Handle: 0x0011
    • (G)ATT Read Response (0x0b), Handle: 0x0011

Commands

• "0/0": Get Status (usually called once per second while active session)

  • Write "0/0"
  • read "F1:1-7,F2:0000-1800,F3:400-408,F4:000-140,F5:0000-1300" eg. "1,0000,408,000,0000"
    • F1: Activity State (1-7)
      • 1: Idle
      • 2: Acknowledge Programstart
      • 3: ? Unseen ?
      • 4: Measuring Conectivity ?
      • 5: Active
      • 6: Stopping
      • 7: Stopped
    • F2: seconds of Device or Mode usage
    • F3: Battery status (040 ~ near full, less = less full)
    • F4: Output Powerlevel (1 unit = 10 mikroampere)
    • F5: Measured Something (1 unit = 1 mikroampere ?)

• "4,[RLB],[RLB],[0-9]{3},[0-9]{4}/0": Start Programm

  • Write "4,R,L,040,1800/0"
    • F1: 4=Start Program
    • F2: R,L,B = Kathode/Donator Operating Mode
    • F3: R,L,B = Anode/Akzeptor Operating Mode
    • Operating modes (F2,F3)
      • Create: R -> L
      • Rethink: B -> L
      • Learn: L -> R
      • Concentrate: L -> B
    • F4: Always "040" ?
    • F5: Duration of program in seconds, 1800s=30minutes
    • F6: Always "/0" = Send Status Back ?

• "5,(080|120|160)": Change Powerlevel (1 unit= 10 Mikroampere)

  • Write "5,080" = 0.8 Milliampere = 800 Mikroampere
  • Write "5,120" = 1.2 Milliampere = 1200 Mikroampere
  • Write "5,160" = 1.6 Milliampere = 1600 Mikroampere

• "6/0": Stop Programm

  • Write "6/0"

• "F": Get Firmware Version

  • Write "F"
  • Read "1,v31"+ Binarybyte (00) ?
  • or sometimes after usage and stop Read "7,v31"

• "#": Get Headset Serial

  • Write "#"
  • Read "#,01234567 89ABCDEF"
    • F1: 4 Bytes Hexadecimal: another Device Serial ?
    • F2: 4 Bytes Hexadecimal: Last 4 Bytes of BLE Adress

Unknown Commands

• seen, unsure: Write "A": Abort /Suspend ? Program
• unseen, missing: Write "1"
• seen, unknown: Write "2"
• unseen, missing: Write "3"

Observed Values

• Write
  • plato_write_uuid = "e8f20002-9796-42a1-92ef-f65a7f9d6d79"
  • (G)ATT Write Request (0x12), Handle: 0x0014
  • (G)ATT Write Response (0x13), Handle: 0x0014
  • Format: Command:[AF#02456][,+][<"/0">]
  • Observed Value List

"F"
"#"
"0/0"
"4,R,L,040,1800/0"
"4,R,L,040,1763/0"
"5,120"
"5,160"
"5,080"
"6/0"
"A"
"2"

• Read
  • plato_read_uuid = "e8f20001-9796-42a1-92ef-f65a7f9d6d79"
  • (G)ATT Read Request (0x0a), Handle: 0x0011
  • (G)ATT Read Response (0x0b), Handle: 0x0011
  • Format: [,+]
  • Observed Example Value List

"1,v31"+ 00
"#,01234567 89ABCDEF"
"1,0000,408,000,0000"
"2,0000,408,001,0015"
"4,0008,406,042,0455"
"5,0004,406,042,0463"
"6,0040,405,017,0276"
"6,0036,406,002,0190"
"7,0037,407,000,0000"
"7,0008,408,000,0000"

• Example Session

+ W: "4,L,B,040,1800/0"
+ R: 2,000,406,001,0007
+ Loop
  + W: "0/0"
  + R: 4,000,403,001,0046
  + R: 4,001,403,016,0420
  + R: 4,002,403,030,0697
  + R: 5,003,403,042,0849
  + R: 5,004,403,042,0822
  + R: 5,005,403,042,0814
+ Loop
  + W: "0/0"
  + R: 5,Increase of 1, ~403, ~042, ~ 700-850
+ W: "5,060"
+ R: "4,0012,403,042,0701"
+ W: "0/0"
+ R: "4,0012,404,042,0693"
+ W: "5,060"
+ R: "4,0013,404,057,0830"
+ W: "0/0"
+ R: "4,0013,404,057,0826"
+ Loop
  + W: "0/0"
  + R: "4,0013-0017,402-404,057-115,0826 - 1251
+ Loop
  + W: "0/0"
  + R: "5,0018-0030,402,122-142,1024-1227"
+ W: "6/0"
+ R: "6,0042,402,142,1114"
+ W: "0/0"
+ R: "6,0043,402,142,1118"
+ R: "6,time,402,decreasing in steps of ~20,decreasing in steps of ~100"
+ 113,958 99,884 84,802 70,720 55,627 41,537 26,432 11,315
+ R: "7, 0053, 405, 000,0000"