Update README.md

README.md

@@ -18,19 +18,50 @@ In order to program the buds from inside of the docker container; privileged mod
 ./build.sh # This will run make and build the output program. If you have weird build errors try running clean.sh or rm -rf'ing the out folder first
 
 # Now that the firmware has finished building; if there are no errors you can load it to your buds
+# You may need to take the buds out of the case, wait three seconds, place them back. This wakes them up and the programmer needs to catch this reboot.
+
+# You can try the helper script by running 
+./download.sh
+
+# Or do it manually by :
+
 # Assuming that your serial ports are 0 and 1, run the following to commands to program each bud in series.
-# You may need to take the buds out of the case, wait three seconds, place them back. This wakes them up.
 bestool write-image out/open_source/open_source.bin --port /dev/ttyACM0
 bestool write-image out/open_source/open_source.bin --port /dev/ttyACM1
 ```
 
-
 ## Changelist from stock opeen source SDK
 
-+ Long hold (5 ish seconds) the button on the back when buds are in the case to force a device reboot (so it can be programmed)
+- Long hold (5 ish seconds) the button on the back when buds are in the case to force a device reboot (so it can be programmed)
-+ Use the resistor in the buds to pick Left/Right rather than TWS master/slave pairing
+- Use the resistor in the buds to pick Left/Right rather than TWS master/slave pairing
-+ Pressing the button on the back while in the case no longer triggers DFU mode
+- Pressing the button on the back while in the case no longer triggers DFU mode
-+ Debugging baud rate raised to 200000 to match stock firmware
+- Debugging baud rate raised to 200000 to match stock firmware
-+ Fixed TWS operation such that putting either bud into the case correctly switches to the other bud
+- Fixed TWS operation such that putting either bud into the case correctly switches to the other bud
-+ Working (mostly) audio controls using the touch button on the buds
+- Working (mostly) audio controls using the touch button on the buds
-+ Turned off showing up as a HID keyboard, as not sure _why_ you would; but it stops android nagging me about a new keyboard
+- Turned off showing up as a HID keyboard, as not sure _why_ you would; but it stops android nagging me about a new keyboard
+
+## Current bud tap codes
+
+### Both pods active
+
+#### Right Ear:
+
+- Single tap : Play/Pause
+- Double tap : Next track
+- Hold : Fast-Forward (Currently non functional, WIP)
+- Triple tap : Volume Up
+
+#### Left Ear:
+
+- Single tap : Play/Pause
+- Double tap : Previous track
+- Hold : Rewind (Currently non functional, WIP)
+- Triple tap : Volume Down
+
+### Single pod active
+
+- Single tap : Play/Pause
+- Double tap : Next track
+- Hold : Previous track
+- Triple tap : Volume Up
+- Quad tap : Volume Down

download.sh

@@ -1,7 +1,15 @@
 #! /bin/bash
 
-num=$(ls -l /dev/ttyUSB* | rev | cut -c 1)
+num=$(ls -l /dev/ttyACM* | rev | cut -c 1)
-#num=3
 echo com is:$num
-sudo -S dldtool -c $num -f out/open_source/open_source.bin
+splitPorts=($num)
-sudo minicom port$num
+echo "This tool assumes your buds are the only thing connected and are enumerated {right,left} order. YMMV"
+echo "Right bud is at ${splitPorts[0]}"
+echo "Left bud is at ${splitPorts[1]}"
+
+echo "Please disconnect and reconnect the bud on the right"
+
+bestool write-image out/open_source/open_source.bin --port /dev/ttyACM${splitPorts[0]}
+
+echo "Please disconnect and reconnect the bud on the left"
+bestool write-image out/open_source/open_source.bin --port /dev/ttyACM${splitPorts[1]}