Skip to content

Commit 6a7270c

Browse files
deadprogramdeadprogram
committed
docs: update boards for v0.13.0 release
Signed-off-by: Ron Evans <[email protected]>
1 parent 1238e78 commit 6a7270c

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

41 files changed

+5051
-233
lines changed

‎content/microcontrollers/_index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ weight: 3
88

99
TinyGo lets you run Go directly on microcontrollers.
1010

11-
TinyGo has support for 27 different boards such as the Arduino Nano33 IoT, Adafruit Circuit Playground Express, BBC micro:bit and more. Click on a board name found in the left menu to see the what features are supported for the given hardware.
11+
TinyGo has support for 32 different boards such as the Arduino Nano33 IoT, Adafruit Circuit Playground Express, BBC micro:bit and more. Click on a board name found in the left menu to see the what features are supported for the given hardware.
1212

1313
We also give you the ability to add new boards. If your target isn't listed here, please raise an issue in the [issue tracker](https://github.com/tinygo-org/tinygo/issues).
1414

‎content/microcontrollers/arduino-mega2560.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: "Arduino Mega 2560"
3+
weight: 3
4+
---
5+
6+
The [Arduino Mega 2560](https://store.arduino.cc/arduino-mega-2560-rev3) is based on the AVR [ATmega2560](https://www.microchip.com/wwwproducts/en/ATmega2560) microcontroller.
7+
8+
Note: the AVR backend of LLVM is still experimental so you may encounter bugs.
9+
10+
## Interfaces
11+
12+
| Interface | Hardware Supported | TinyGo Support |
13+
| --------- | ------------- | ----- |
14+
| GPIO | YES | YES |
15+
| UART | YES | YES |
16+
| SPI | YES | Not yet |
17+
| I2C | YES | YES |
18+
| ADC | YES | YES |
19+
| PWM | YES | YES |
20+
21+
## Machine Package Docs
22+
23+
[Documentation for the machine package for the Arduino Mega 2560](../machine/arduino-mega2560)
24+
25+
## Installing dependencies
26+
27+
The Arduino Mega 2560 needs a few extra dependencies to work, for example, if you get an error like this:
28+
29+
```text
30+
/usr/lib/gcc/avr/5.4.0/../../../avr/bin/ld: cannot find -lm
31+
/usr/lib/gcc/avr/5.4.0/../../../avr/bin/ld: cannot find -lc
32+
collect2: error: ld returned 1 exit status
33+
```
34+
35+
Or like this:
36+
37+
```text
38+
/bin/sh: 1: avrdude: not found
39+
```
40+
41+
To fix this, see the installation guide for [Linux](../../getting-started/linux/#avr-arduino) and for [macOS](../../getting-started/macos/#avr-arduino).
42+
43+
## Flashing
44+
45+
### AVRDude
46+
47+
Programs are loaded onto the Arduino Mega 2560 using the `avrdude` command line utility program. You must install this program before you will be able to flash the Arduino Uno board with your TinyGo code.
48+
49+
- Plug your Arduino Uno into your computer's USB port.
50+
- Build and flash your TinyGo program using `tinygo flash -target arduino-mega2560 /path/to/code`

‎content/microcontrollers/circuit-playground-bluefruit.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The [Adafruit Circuit Playground Bluefruit](https://www.adafruit.com/product/433
1818

1919
## Machine Package Docs
2020

21-
[Documentation for the machine package for the Circuit Playground Express](../machine/circuitplay-bluefruit)
21+
[Documentation for the machine package for the Circuit Playground Bluefruit](../machine/circuitplay-bluefruit)
2222

2323
## Flashing
2424

@@ -77,7 +77,7 @@ Once you have updated your Circuit Playground Bluefruit board the first time, af
7777

7878
## Notes
7979

80-
The USB port to the Circuit Playground Bluefruit cannot yet be used as a serial port. Eventually `UART0` will refer to this connection.
80+
You can use the USB port to the Circuit Playground Bluefruit as a serial port. `UART0` refers to this connection.
8181

8282
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/master/examples](https://github.com/tinygo-org/drivers)
8383

‎content/microcontrollers/clue-alpha.md‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: "Adafruit CLUE"
3+
weight: 3
4+
---
5+
6+
The [Adafruit CLUE](https://www.adafruit.com/product/4500) is small ARM development board based on the Nordic Semiconductor [nrf52840](https://www.nordicsemi.com/eng/Products/nRF52840) processor. It has several built-in devices such as WS2812 "NeoPixel" LEDs, buttons, an accelerometer, and some other sensors.
7+
8+
## Interfaces
9+
10+
| Interface | Hardware Supported | TinyGo Support |
11+
| --------- | ------------- | ----- |
12+
| GPIO | YES | YES |
13+
| UART | YES | YES |
14+
| SPI | YES | YES |
15+
| I2C | YES | YES |
16+
| ADC | YES | YES |
17+
| PWM | YES | YES |
18+
19+
## Machine Package Docs
20+
21+
[Documentation for the machine package for the Adafruit CLUE](../machine/clue-alpha)
22+
23+
## Flashing
24+
25+
### UF2
26+
27+
The CLUE comes with the [UF2 bootloader](https://github.com/Microsoft/uf2) already installed.
28+
29+
### CLI Flashing on Linux
30+
31+
- Plug your CLUE into your computer's USB port.
32+
- Flash your TinyGo program to the board using this command:
33+
34+
```shell
35+
tinygo flash -target=clue-alpha [PATH TO YOUR PROGRAM]
36+
```
37+
38+
- The CLUE board should restart and then begin running your program.
39+
40+
### CLI Flashing on macOS
41+
42+
- Plug your CLUE into your computer's USB port.
43+
- Flash your TinyGo program to the board using this command:
44+
45+
```shell
46+
tinygo flash -target=clue-alpha [PATH TO YOUR PROGRAM]
47+
```
48+
49+
- The CLUE board should restart and then begin running your program.
50+
51+
### CLI Flashing on Windows
52+
53+
- Plug your CLUE into your computer's USB port.
54+
- Double tap the "RESET" button on the board.
55+
- Wait until the CLUE board appears as a flash drive.
56+
- Flash your TinyGo program to the board using this command:
57+
58+
```shell
59+
tinygo flash -target=clue-alpha [PATH TO YOUR PROGRAM]
60+
```
61+
62+
- The CLUE board should restart and then begin running your program.
63+
64+
### Troubleshooting
65+
66+
If you have troubles getting your CLUE board to receive code, try this:
67+
68+
- Press the "RESET" button on the board two times to get the CLUE board ready to receive code.
69+
- The CLUE board will appear to your computer like a USB drive.
70+
- Now try running the command:
71+
72+
```shell
73+
tinygo flash -target=clue-alpha [PATH TO YOUR PROGRAM]
74+
```
75+
76+
Once you have updated your CLUE board the first time, after that you should be able to flash it entirely from the command line.
77+
78+
## Notes
79+
80+
You can use the USB port to the CLUE as a serial port. `UART0` refers to this connection.
81+
82+
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/master/examples](https://github.com/tinygo-org/drivers)
83+
84+
Bluetooth support is in development but not yet completed.

‎content/microcontrollers/hifive1b.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The [HiFive1 Rev B](https://www.sifive.com/boards/hifive1-rev-b) is low-cost, Ar
1212
| GPIO | YES | YES |
1313
| UART | YES | YES |
1414
| SPI | YES | Write only |
15-
| I2C | YES | Not yet |
15+
| I2C | YES | YES |
1616
| ADC | NO | NO |
1717
| PWM | YES | Not yet |
1818

0 commit comments

Comments
 (0)