wifinina

package
v0.10.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 31, 2020 License: BSD-3-Clause Imports: 6 Imported by: 0

README

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.

Using the WiFiNINA Driver

For information on how to use this driver, please take a look at the examples located in the examples/wifinina directory.

WiFiNINA Firmware Installation

PLEASE NOTE: New Arduino Nano33 IoT boards already have the WiFiNINA firmware pre-installed, so you should not need to install the firmware yourself.

In order to use this driver, you must have the WiFiNINA firmware installed on the ESP32 chip. If it is already installed, you can just use it. You do not need to build and flash the firmware again.

Building the WifiNINA firmware

We have provided a Dockerfile that can build the needed firmware.

docker build -t wifinina ./wifinina/
docker run -v "$(pwd)/build:/src/build" wifinina

This will put the firmware files into the build directory. Now you can flash them to the ESP32 chip.

Installing esptool to flash WifiNINA firmware

In order to flash the firmware, you need to use Python to install the esptool package.

pip install esptool

Once you have installed esptool you can follow the correct procedure for flashing your board.

Installing on Arduino Nano33 IoT

The Arduino Nano33 IoT board has the WiFiNINA firmware flashed onto the onboard NINA-W102 chip out of the box.

Flashing the firmware is only necessary on the Arduino Nano33 IoT in order to upgrade or if other firmware was installed previously.

If you do want to install the firmware on the Arduino Nano33 IoT board's built-in NINA-W102 chip, you will need to first build the firmware as described above.

To flash this firmware on the Arduino Nano33 IoT you will need to follow the following procedure using the Arduino IDE software:

  • 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).

Now you can flash the WifiNINA firmware using the esptool script:

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 build/bootloader.bin 0xf000 build/phy_init_data.bin 0x30000 build/nina-fw.bin 0x8000 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.

Documentation

Overview

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

Index

Constants

View Source 
const (
	MaxSockets  = 4
	MaxNetworks = 10
	MaxAttempts = 10

	MaxLengthSSID   = 32
	MaxLengthWPAKey = 63
	MaxLengthWEPKey = 13

	LengthMacAddress = 6
	LengthIPV4       = 4

	WlFailure = -1
	WlSuccess = 1

	StatusNoShield       ConnectionStatus = 255
	StatusIdle           ConnectionStatus = 0
	StatusNoSSIDAvail    ConnectionStatus = 1
	StatusScanCompleted  ConnectionStatus = 2
	StatusConnected      ConnectionStatus = 3
	StatusConnectFailed  ConnectionStatus = 4
	StatusConnectionLost ConnectionStatus = 5
	StatusDisconnected   ConnectionStatus = 6

	EncTypeTKIP EncryptionType = 2
	EncTypeCCMP EncryptionType = 4
	EncTypeWEP  EncryptionType = 5
	EncTypeNone EncryptionType = 7
	EncTypeAuto EncryptionType = 8

	TCPStateClosed      = 0
	TCPStateListen      = 1
	TCPStateSynSent     = 2
	TCPStateSynRcvd     = 3
	TCPStateEstablished = 4
	TCPStateFinWait1    = 5
	TCPStateFinWait2    = 6
	TCPStateCloseWait   = 7
	TCPStateClosing     = 8
	TCPStateLastACK     = 9
	TCPStateTimeWait    = 10

	FlagCmd   = 0
	FlagReply = 1 << 7
	FlagData  = 0x40

	NinaCmdPos      = 1
	NinaParamLenPos = 2

	CmdStart = 0xE0
	CmdEnd   = 0xEE
	CmdErr   = 0xEF

	CmdSetNet          = 0x10
	CmdSetPassphrase   = 0x11
	CmdSetKey          = 0x12
	CmdSetIPConfig     = 0x14
	CmdSetDNSConfig    = 0x15
	CmdSetHostname     = 0x16
	CmdSetPowerMode    = 0x17
	CmdSetAPNet        = 0x18
	CmdSetAPPassphrase = 0x19
	CmdSetDebug        = 0x1A
	CmdGetTemperature  = 0x1B
	CmdGetReasonCode   = 0x1F

	CmdGetConnStatus     = 0x20
	CmdGetIPAddr         = 0x21
	CmdGetMACAddr        = 0x22
	CmdGetCurrSSID       = 0x23
	CmdGetCurrBSSID      = 0x24
	CmdGetCurrRSSI       = 0x25
	CmdGetCurrEncrType   = 0x26
	CmdScanNetworks      = 0x27
	CmdStartServerTCP    = 0x28
	CmdGetStateTCP       = 0x29
	CmdDataSentTCP       = 0x2A
	CmdAvailDataTCP      = 0x2B
	CmdGetDataTCP        = 0x2C
	CmdStartClientTCP    = 0x2D
	CmdStopClientTCP     = 0x2E
	CmdGetClientStateTCP = 0x2F
	CmdDisconnect        = 0x30
	CmdGetIdxRSSI        = 0x32
	CmdGetIdxEncrType    = 0x33
	CmdReqHostByName     = 0x34
	CmdGetHostByName     = 0x35
	CmdStartScanNetworks = 0x36
	CmdGetFwVersion      = 0x37
	CmdSendDataUDP       = 0x39
	CmdGetRemoteData     = 0x3A
	CmdGetTime           = 0x3B
	CmdGetIdxBSSID       = 0x3C
	CmdGetIdxChannel     = 0x3D
	CmdPing              = 0x3E
	CmdGetSocket         = 0x3F

	// All command with DATA_FLAG 0x40 send a 16bit Len
	CmdSendDataTCP   = 0x44
	CmdGetDatabufTCP = 0x45
	CmdInsertDataBuf = 0x46

	// regular format commands
	CmdSetPinMode      = 0x50
	CmdSetDigitalWrite = 0x51
	CmdSetAnalogWrite  = 0x52

	ErrTimeoutSlaveReady  Error = 0x01
	ErrTimeoutSlaveSelect Error = 0x02
	ErrCheckStartCmd      Error = 0x03
	ErrWaitRsp            Error = 0x04
	ErrUnexpectedLength   Error = 0xE0
	ErrNoParamsReturned   Error = 0xE1
	ErrIncorrectSentinel  Error = 0xE2
	ErrCmdErrorReceived   Error = 0xEF
	ErrNotImplemented     Error = 0xF0
	ErrUnknownHost        Error = 0xF1
	ErrSocketAlreadySet   Error = 0xF2
	ErrConnectionTimeout  Error = 0xF3
	ErrNoData             Error = 0xF4
	ErrDataNotWritten     Error = 0xF5
	ErrCheckDataError     Error = 0xF6
	ErrBufferTooSmall     Error = 0xF7
	ErrNoSocketAvail      Error = 0xFF

	NoSocketAvail uint8 = 0xFF
)
View Source 
const (
	ProtoModeTCP = iota
	ProtoModeUDP
	ProtoModeTLS
	ProtoModeMul
)
View Source 
const (
	ReadBufferSize = 128
)

Variables

This section is empty.

Functions

This section is empty.

Types

type ConnectionStatus 

type ConnectionStatus uint8

func (ConnectionStatus) String 

func (c ConnectionStatus) String() string

type Device 

type Device struct {
	SPI   machine.SPI
	CS    machine.Pin
	ACK   machine.Pin
	GPIO0 machine.Pin
	RESET machine.Pin
	// contains filtered or unexported fields
}

func (*Device) CheckDataSent 

func (d *Device) CheckDataSent(sock uint8) (bool, error)

func (*Device) Configure 

func (d *Device) Configure()

func (*Device) Disconnect 

func (d *Device) Disconnect() error

func (*Device) GetClientState 

func (d *Device) GetClientState(sock uint8) (uint8, error)

func (*Device) GetConnectionStatus 

func (d *Device) GetConnectionStatus() (ConnectionStatus, error)

func (*Device) GetCurrentBSSID 

func (d *Device) GetCurrentBSSID() (MACAddress, error)

func (*Device) GetCurrentEncryptionType 

func (d *Device) GetCurrentEncryptionType() (EncryptionType, error)

func (*Device) GetCurrentRSSI 

func (d *Device) GetCurrentRSSI() (int32, error)

func (*Device) GetCurrentSSID 

func (d *Device) GetCurrentSSID() (string, error)

func (*Device) GetDataBuf 

func (d *Device) GetDataBuf(sock uint8, buf []byte) (int, error)

func (*Device) GetFwVersion 

func (d *Device) GetFwVersion() (string, error)

func (*Device) GetHostByName 

func (d *Device) GetHostByName(hostname string) (IPAddress, error)

func (*Device) GetIP 

func (d *Device) GetIP() (ip, subnet, gateway IPAddress, err error)

func (*Device) GetMACAddress 

func (d *Device) GetMACAddress() (MACAddress, error)

func (*Device) GetNetworkBSSID 

func (d *Device) GetNetworkBSSID(idx int) (MACAddress, error)

func (*Device) GetNetworkChannel 

func (d *Device) GetNetworkChannel(idx int) (uint8, error)

func (*Device) GetNetworkEncrType 

func (d *Device) GetNetworkEncrType(idx int) (EncryptionType, error)

func (*Device) GetNetworkRSSI 

func (d *Device) GetNetworkRSSI(idx int) (int32, error)

func (*Device) GetNetworkSSID 

func (d *Device) GetNetworkSSID(idx int) string

func (*Device) GetReasonCode 

func (d *Device) GetReasonCode() (uint8, error)

func (*Device) GetSocket 

func (d *Device) GetSocket() (uint8, error)

func (*Device) GetTemperature 

func (d *Device) GetTemperature() (float32, error)

func (*Device) GetTime 

func (d *Device) GetTime() (string, error)

func (*Device) NewDriver 

func (d *Device) NewDriver() net.DeviceDriver

func (*Device) Ping 

func (d *Device) Ping(ip IPAddress, ttl uint8) int16

func (*Device) ScanNetworks 

func (d *Device) ScanNetworks() (uint8, error)

func (*Device) SendData 

func (d *Device) SendData(buf []byte, sock uint8) (uint16, error)

func (*Device) SetDNS 

func (d *Device) SetDNS(which uint8, dns1 uint32, dns2 uint32) error

func (*Device) SetDebug 

func (d *Device) SetDebug(on bool) error

func (*Device) SetHostname 

func (d *Device) SetHostname(hostname string) error

func (*Device) SetIP 

func (d *Device) SetIP(which uint8, ip uint32, gw uint32, subnet uint32) error

func (*Device) SetKey 

func (d *Device) SetKey(ssid string, index uint8, key string) error

func (*Device) SetNetwork 

func (d *Device) SetNetwork(ssid string) error

func (*Device) SetNetworkForAP 

func (d *Device) SetNetworkForAP(ssid string) error

func (*Device) SetPassphrase 

func (d *Device) SetPassphrase(ssid string, passphrase string) error

func (*Device) SetPassphraseForAP 

func (d *Device) SetPassphraseForAP(ssid string, passphrase string) error

func (*Device) SetPowerMode 

func (d *Device) SetPowerMode(mode uint8) error

func (*Device) StartClient 

func (d *Device) StartClient(addr uint32, port uint16, sock uint8, mode uint8) error

func (*Device) StartScanNetworks 

func (d *Device) StartScanNetworks() (uint8, error)

func (*Device) StopClient 

func (d *Device) StopClient(sock uint8) error

type Driver 

type Driver struct {
	// contains filtered or unexported fields
}

func (*Driver) ConnectSSLSocket 

func (drv *Driver) ConnectSSLSocket(addr, portStr string) error

func (*Driver) ConnectTCPSocket 

func (drv *Driver) ConnectTCPSocket(addr, portStr string) error

func (*Driver) ConnectUDPSocket 

func (drv *Driver) ConnectUDPSocket(addr, sport, lport string) error

func (*Driver) DisconnectSocket 

func (drv *Driver) DisconnectSocket() error

func (*Driver) GetDNS 

func (drv *Driver) GetDNS(domain string) (string, error)

func (*Driver) IsConnected 

func (drv *Driver) IsConnected() (bool, error)

func (*Driver) IsSocketDataAvailable 

func (drv *Driver) IsSocketDataAvailable() bool

IsSocketDataAvailable returns of there is socket data available

func (*Driver) ReadSocket 

func (drv *Driver) ReadSocket(b []byte) (n int, err error)

func (*Driver) Response 

func (drv *Driver) Response(timeout int) ([]byte, error)

func (*Driver) StartSocketSend 

func (drv *Driver) StartSocketSend(size int) error

func (*Driver) Write 

func (drv *Driver) Write(b []byte) (n int, err error)

type EncryptionType 

type EncryptionType uint8

func (EncryptionType) String 

func (e EncryptionType) String() string

type Error 

type Error uint8

func (Error) Error 

func (err Error) Error() string

type IPAddress 

type IPAddress string // TODO: does WiFiNINA support ipv6???

func ParseIPv4 

func ParseIPv4(s string) (IPAddress, error)

func (IPAddress) AsUint32 

func (addr IPAddress) AsUint32() uint32

func (IPAddress) String 

func (addr IPAddress) String() string

type MACAddress 

type MACAddress uint64

func (MACAddress) String 

func (addr MACAddress) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.