BangleApps/apps/espruinoprog/README.md

# Espruino Programmer

Finds Bluetooth devices with a specific name (eg `Puck.js`), connects and uploads code. Great for programming many devices at once!

**WARNING:** This will reprogram **any matching Espruino device within range** while
the app is running. Unless you are careful to remove other devices from the area or
turn them off, you could find some of your devices unexpectedly get programmed!

## Customising

Click on the Customise button in the app loader to set up the programmer.

* First you need to choose the kind of devices you want to upload to. This is
the text that should match the Bluetooth advertising name. So `Puck.js` for Puck.js
devices, or `Bangle.js` for Bangles.
* In the next box, you have code to run before the upload of the main code. By default
the code `require("Storage").list().forEach(f=>require("Storage").erase(f));reset();` will
erase all files on the device and reset it.
* Now paste in the code you want to write to the device. This is automatically
written to flash (`.bootcde`). See https://www.espruino.com/Saving#save-on-send-to-flash-
for more information.
* Now enter the code that should be sent **after** programming. This code
should make the device so it doesn't advertise on Bluetooth with the Bluetooth
name you entered for the first item. It may also help if it indicates to you that
the device is programmed properly.
  * You could turn advertising off with `NRF.sleep()`
  * You could change the advertising name with `NRF.setAdvertising({},{name:"Ok"});`
  * On a Bangle, you could turn it off with `Bangle.off()`
* Finally scroll down and click `Upload`
* Now you can run the new `Programmer` app on the Bangle.

## Usage

Just run the app, and as soon as it starts it'll start scanning for
devices to upload to!

To stop scanning, long-press the button to return to the clock.

## Notes

* This assumes the device being written to is at least version 2v00 of Espruino
* Currently, code is not minified before upload (so you need to supply pre-minified
  code if you want that)