tinygo-org/drivers
1
0
Fork 0
mirror of https://github.com/tinygo-org/drivers.git synced 2026-07-26 10:38:41 +00:00
Code Issues Packages Projects Releases 10 Wiki Activity

wifinina: update docs and info on how to install WiFiNINA driver

Browse Source 
Signed-off-by: Ron Evans <ron@hybridgroup.com>
This commit is contained in:
Ron Evans
2019-12-26 16:34:35 +01:00
parent 1d0f04af6b
commit 086415605e
2 changed files with 36 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
wifinina/README.md
+29
View File
@@ -0,0 +1,29 @@
# WifiNINA Driver
This package provides a driver to use a separate connected WiFi processor ESP32 for TCP/UDP communication.
The way this driver works is by using the SPI interface of your microcontroller to communicate with the WiFi chip using the Arduino SPI command set.
## WiFiNINA Firmware Installation
In order to use this driver, you must have the WiFiNINA firmware installed on the ESP32 chip.
### Installing on Arduino Nano33 IoT
In order to install the needed firmware on the Arduino Nano33 IoT board's built-in NINA W102 chip, you will need to use this firmware:
https://github.com/arduino/nina-fw
To flash this firmware on the Arduino Nano33 IoT you will need to follow the following procedure:
- Install _Arduino SAMD Boards_ from the Boards Manager.
- Install _WiFiNINA_ from the Library Manager.
- Using the normal Arduino software, load the `SerialNINAPassthrough` sketch on to the board (in File -> Examples -> WiFiNINA-> Tools).
- Build the NINA 102 firmware using the `make firmware` command in the https://github.com/arduino/nina-fwt repo.
- Flash the WifiNINA firmware using the `esptool` script:
```shell
python esptool.py --chip esp32 --port /dev/ttyACM0 --baud 115200 --before no_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size detect 0x1000 /home/ron/Development/nina-fw/build/bootloader/bootloader.bin 0xf000 /home/ron/Development/nina-fw/build/phy_init_data.bin 0x30000 /home/ron/Development/nina-fw/build/nina-fw.bin 0x8000 /home/ron/Development/nina-fw/build/partitions.bin
```
You only need to do this one time, and then the correct WiFiNINA firmware will be on the NINA chip, and you can just flash the Arduino Nano33 IoT board using TinyGo. We should be able to remove some of these steps in a future release of this software.
wifinina/wifinina.go
+7 -1
View File
@@ -1,4 +1,10 @@
package wifinina
// Package wifinina implements TCP wireless communication over SPI
// with an attached separate ESP32 board using the Arduino WiFiNINA protocol.
//
// In order to use this driver, the ESP32 must be flashed with specific firmware from Arduino.
// For more information: https://github.com/arduino/nina-fw
//
package wifinina // import "tinygo.org/x/drivers/wifinina"
import (
"encoding/binary"