mirror of https://github.com/espruino/BangleApps
43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
|
# 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.
|
||
|
|
* 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
|
||
|
|
|
||
|
|
* Right now the Espruino Tools used here are unaware of the device they're writing to,
|
||
|
|
and as a result they don't use Storage and so the size of the files you can
|
||
|
|
write to the device are quite limited. You should be find with up to 4k of code.
|
||
|
|
* Currently, code is not minified before upload (so you need to supply pre-minified
|
||
|
|
code if you want that)
|