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)