microcontrollers: more details on new boards and also bluetooth support

deadprogram · conejoninja · commit 5c2c358f5752 · 2020-09-17T12:02:51.000+02:00
Signed-off-by: deadprogram &lt;ron@hybridgroup.com&gt;
diff --git a/content/microcontrollers/bbc-microbit.md b/content/microcontrollers/bbc-microbit.md
@@ -15,6 +15,7 @@ The BBC [micro:bit](https://microbit.org) is a tiny programmable computer design
 | I2C      | YES | YES |
 | ADC      | YES | Not yet |
 | PWM      | Software support | Not yet |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
@@ -68,3 +69,5 @@ machine.SPI1.Configure(machine.SPIConfig{
 // use I2C0 as normally do
 machine.I2C0.Configure(machine.I2CConfig{})
 ```
+
+Bluetooth support is now available for the BBC micro:bit board. See https://github.com/tinygo-org/bluetooth for more information.
diff --git a/content/microcontrollers/clue-alpha.md b/content/microcontrollers/clue-alpha.md
@@ -15,6 +15,7 @@ The [Adafruit CLUE](https://www.adafruit.com/product/4500) is small ARM developm
 | I2C      | YES | YES |
 | ADC      | YES | YES |
 | PWM      | YES | YES |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
@@ -79,4 +80,4 @@ You can use the USB port to the CLUE as a serial port. `UART0` refers to this co
 
 For an example that uses the built-in Neopixel LEDs, take a look at the TinyGo drivers repository located at [https://github.com/tinygo-org/drivers/tree/release/examples](https://github.com/tinygo-org/drivers)
 
-Bluetooth support is in development but not yet completed.
+Bluetooth support is now available for the Adafruit CLUE board. See https://github.com/tinygo-org/bluetooth for more information.
diff --git a/content/microcontrollers/esp32.md b/content/microcontrollers/esp32.md
@@ -24,15 +24,66 @@ The [Espressif ESP32]() is a tiny development board based on the Xtensa [ESP32](
 
 ### CLI Flashing on Linux
 
-Goes here
+You need to install the Espressif toolchain for Linux to use TinyGo with the ESP32: 
+
+https://docs.espressif.com/projects/esp-idf/en/release-v3.0/get-started/linux-setup.html#standard-setup-of-toolchain-for-linux
+
+In addition, you must install the `esptool` flashing tool:
+
+https://github.com/espressif/esptool#easy-installation
+
+Now you should be able to flash your board as follows:
+
+- Plug your ESP32 board into your computer's USB port.
+- Build and flash your TinyGo code using the `tinygo flash` command. This command flashes the ESP32 with the blinky1 example:
+
+    ```
+    tinygo flash -target=esp32-wroom-32 examples/blinky1
+    ```
+
+- The ESP32 board should restart and then begin running your program.
 
 ### CLI Flashing on macOS
 
-Goes here
+You need to install the Espressif toolchain for macOS to use TinyGo with the ESP32: 
+
+https://docs.espressif.com/projects/esp-idf/en/release-v3.0/get-started/macos-setup.html
+
+In addition, you must install the `esptool` flashing tool:
+
+https://github.com/espressif/esptool#easy-installation
+
+Now you should be able to flash your board as follows:
+
+- Plug your ESP32 board into your computer's USB port.
+- Build and flash your TinyGo code using the `tinygo flash` command. This command flashes the ESP32 with the blinky1 example:
+
+    ```
+    tinygo flash -target=esp32-wroom-32 examples/blinky1
+    ```
+
+- The ESP32 board should restart and then begin running your program.
 
 ### CLI Flashing on Windows
 
-Goes here
+You need to install the Espressif toolchain for Windows to use TinyGo with the ESP32: 
+
+https://docs.espressif.com/projects/esp-idf/en/release-v3.0/get-started/windows-setup.html
+
+In addition, you must install the `esptool` flashing tool:
+
+https://github.com/espressif/esptool#easy-installation
+
+Now you should be able to flash your board as follows:
+
+- Plug your ESP32 board into your computer's USB port.
+- Build and flash your TinyGo code using the `tinygo flash` command. This command flashes the ESP32 with the blinky1 example:
+
+    ```
+    tinygo flash -target=esp32-wroom-32 examples/blinky1
+    ```
+
+- The ESP32 board should restart and then begin running your program.
 
 ### Troubleshooting
 
diff --git a/content/microcontrollers/esp8266.md b/content/microcontrollers/esp8266.md
@@ -24,15 +24,66 @@ The [Espressif ESP8266]() is a tiny development board based on the Xtensa [ESP82
 
 ### CLI Flashing on Linux
 
-Goes here
+You need to install the Espressif toolchain for Linux to use TinyGo with the ESP8266. Note that it is the same download as for the ESP32: 
+
+https://docs.espressif.com/projects/esp-idf/en/release-v3.0/get-started/linux-setup.html#standard-setup-of-toolchain-for-linux
+
+In addition, you must install the `esptool` flashing tool:
+
+https://github.com/espressif/esptool#easy-installation
+
+Now you should be able to flash your board as follows:
+
+- Plug your ESP8266 board into your computer's USB port.
+- Build and flash your TinyGo code using the `tinygo flash` command. This command flashes the ESP8266 with the blinky1 example:
+
+    ```
+    tinygo flash -target=esp8266 examples/blinky1
+    ```
+
+- The ESP8266 board should restart and then begin running your program.
 
 ### CLI Flashing on macOS
 
-Goes here
+You need to install the Espressif toolchain for macOS to use TinyGo with the ESP8266. Note that it is the same download as for the ESP32: 
+
+https://docs.espressif.com/projects/esp-idf/en/release-v3.0/get-started/macos-setup.html
+
+In addition, you must install the `esptool` flashing tool:
+
+https://github.com/espressif/esptool#easy-installation
+
+Now you should be able to flash your board as follows:
+
+- Plug your ESP8266 board into your computer's USB port.
+- Build and flash your TinyGo code using the `tinygo flash` command. This command flashes the ESP8266 with the blinky1 example:
+
+    ```
+    tinygo flash -target=esp8266 examples/blinky1
+    ```
+
+- The ESP826 board should restart and then begin running your program.
 
 ### CLI Flashing on Windows
 
-Goes here
+You need to install the Espressif toolchain for Windows to use TinyGo with the ESP826. Note that it is the same download as for the ESP32: 
+
+https://docs.espressif.com/projects/esp-idf/en/release-v3.0/get-started/windows-setup.html
+
+In addition, you must install the `esptool` flashing tool:
+
+https://github.com/espressif/esptool#easy-installation
+
+Now you should be able to flash your board as follows:
+
+- Plug your ESP826 board into your computer's USB port.
+- Build and flash your TinyGo code using the `tinygo flash` command. This command flashes the ESP826 with the blinky1 example:
+
+    ```
+    tinygo flash -target=esp8266 examples/blinky1
+    ```
+
+- The ESP826 board should restart and then begin running your program.
 
 ### Troubleshooting
 
diff --git a/content/microcontrollers/nrf52840-mdk.md b/content/microcontrollers/nrf52840-mdk.md
@@ -15,6 +15,7 @@ The [nRF52840-MDK](https://wiki.makerdiary.com/nrf52840-mdk/) is an open-source,
 | I2C      | YES | YES |
 | ADC      | YES | Not yet |
 | PWM      | YES | Not yet |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
@@ -28,3 +29,7 @@ Programs are loaded onto the nRF52840-MDK board using the `openocd` command line
 
 - Plug your nRF52840-MDK into your computer's USB port.
 - Build and flash your TinyGo program using `tinygo flash -target=nrf52840-mdk`
+
+## Notes
+
+Bluetooth support is now available for nRF52840 boards. See https://github.com/tinygo-org/bluetooth for more information.
diff --git a/content/microcontrollers/particle-argon.md b/content/microcontrollers/particle-argon.md
@@ -15,6 +15,7 @@ weight: 3
 | I2C      | YES | YES |
 | ADC      | YES | YES |
 | PWM      | YES | YES |
+| Bluetooth      | YES | Not yet |
 
 ## Machine Package Docs
 
diff --git a/content/microcontrollers/particle-boron.md b/content/microcontrollers/particle-boron.md
@@ -15,6 +15,7 @@ weight: 3
 | I2C      | YES | YES |
 | ADC      | YES | YES |
 | PWM      | YES | YES |
+| Bluetooth      | YES | Not yet |
 
 ## Machine Package Docs
 
diff --git a/content/microcontrollers/particle-xenon.md b/content/microcontrollers/particle-xenon.md
@@ -15,6 +15,7 @@ weight: 3
 | I2C      | YES | YES |
 | ADC      | YES | YES |
 | PWM      | YES | YES |
+| Bluetooth      | YES | Not yet |
 
 ## Machine Package Docs
 
diff --git a/content/microcontrollers/pca10031.md b/content/microcontrollers/pca10031.md
@@ -15,6 +15,7 @@ The [Nordic Semiconductor PCA10031](https://www.nordicsemi.com/eng/Products/nRF5
 | I2C      | YES | Not yet |
 | ADC      | YES | Not yet |
 | PWM      | YES | Not yet |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
diff --git a/content/microcontrollers/pca10040.md b/content/microcontrollers/pca10040.md
@@ -15,6 +15,7 @@ The [Nordic Semiconductor PCA10040](https://www.nordicsemi.com/eng/Products/Blue
 | I2C      | YES | YES |
 | ADC      | YES | YES |
 | PWM      | YES | YES |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
diff --git a/content/microcontrollers/pca10056.md b/content/microcontrollers/pca10056.md
@@ -15,6 +15,7 @@ The [Nordic Semiconductor PCA10056](https://www.nordicsemi.com/Software-and-Tool
 | I2C      | YES | YES |
 | ADC      | YES | Not yet |
 | PWM      | YES | Not yet |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
diff --git a/content/microcontrollers/reelboard.md b/content/microcontrollers/reelboard.md
@@ -17,6 +17,7 @@ It is equipped with an Electrophoretic (electronic ink) Display (EPD), along wit
 | I2C      | YES | YES |
 | ADC      | YES | Not yet |
 | PWM      | YES | Not yet |
+| Bluetooth      | YES | YES |
 
 ## Machine Package Docs
 
@@ -44,3 +45,5 @@ Programs can also be loaded onto the reelboard using the `openocd` command line
 
 - Plug your reelboard into your computer's USB port.
 - Build and flash your TinyGo program using `tinygo flash -target=reelboard`
+
+Bluetooth support is now available for reelboard. See https://github.com/tinygo-org/bluetooth for more information.
