Zerynth Docs

First Steps

  • Installation Guide
  • Getting Started
  • Programming Guide
  • Examples

The Tools

  • Zerynth Toolchain
  • Zerynth Studio
  • Zerynth Device Manager

Devices and Libraries

  • Supported Devices
    • Adafruit Feather M0 Wi-Fi
    • AWS Hexagon v1
    • Adafruit Feather Huzzah
    • Adafruit Huzzah32
    • Arduino DUE
    • Arduino/Genuino MKR1000
    • Arduino/Genuino Zero
    • DFRobot FireBeetle Esp32
    • DFRobot FireBeetle ESP8266
    • DOIT Esp32 DevKit v1
    • ESP-WROOM32
    • ESP32 Azure IoT Kit
    • ESP32 DevKitC
    • ESP32 EthernetKit
    • ESP32 Pico v4
    • Flip & Click Sam3X
    • Heltec Wi-Fi Kit 32
    • Hexiwear
    • Infineon XMC4200 Digital Power Control Card
    • Infineon XMC4400 Enterprise Kit
    • Infineon XMC4700 Relax Kit
    • Infineon XMC4800 Connectivity Kit
    • Lilygo T-Wristband
    • MXChip IoT DevKit AZ3166
    • NodeMCU ESP-32S
    • NodeMCU v2
    • NodeMCU v3
    • Nordic nRF52 DK
    • Nordic nRF52840 DK
    • Olimex Esp32 EVB
    • Olimex Esp32 Gateway
    • PSoC6 WiFi-Bt Pioneer Kit
    • Particle Core (Formerly Spark Core)
    • Particle Electron
    • Particle Photon
    • Polaris 2G
    • Polaris 3G
    • Polaris NB-IoT
    • Pycom FiPy 1.0
    • Pycom WiPy 3.0
    • MikroElektronika Quail
    • RedBear Blend 2
    • RedBear Nano 2
    • Renesas PK-S5D9
    • Renesas TB-S5D5
    • Riverdi IoT Display
    • SODAQ ExpLoRer
    • ST Microelectronics Discovery F407VG
    • ST Microelectronics Nucleo F401RE
    • ST Microelectronics Nucleo F429ZI
    • ST Microelectronics Nucleo F746ZG
    • ST Microelectronics Nucleo L4R5
    • ST Microelectronics Discovery F407VG
    • Sony Spresense
    • SparkFun Photon RedBoard
    • Sparkfun ESP32 Thing
    • Sparkfun Esp8266 Thing Dev
    • Wemos D1 Mini
    • Wemos ESP32 OLED
    • Wio Link
      • Pin Mapping
      • Flash Layout
      • Device Summary
      • Power
      • Connect, Register, Virtualize and Program
      • Firmware Over the Air update (FOTA)
      • Power Management
    • Wireless Tag WT8266-DK V2
    • XinaBox CW02 (ESP32)
    • Xplained Pro Sam C21
    • Xplained Pro Sam C21N
    • Xplained Pro Sam D21
    • Xplained Pro Sam E54
    • Xplained Pro Sam G55
    • Xplained Pro Sam L21
    • 4ZeroBox
    • oddWires IO
    • oddWires Proteus
  • Standard Library
  • Official Libraries
  • Partners’ Libraries
  • Community Libraries
Zerynth Docs
  • Docs »
  • Supported Devices »
  • Wio Link
  • View page source

Wio Link¶

The SeeedStudio Wio Link is an ESP8266 SoC based open-source Wi-Fi development board, that allows users to create IoT custom applications by adding plug and play Grove modules in its 6 dedicated Grove slot.

The Wio Link features 4MB of flash memory, Tensilica microcontroller (80MHz of system clock), around 50k of usable RAM and an Espressif ESP8266 chip Wi-fi Transceiver.

Wio Link

Pin Mapping¶

Wio Link

Official reference for Wio Link can be found here.

Flash Layout¶

The Wio Link device features a 4 MB (32 Mb) flash memory organized in sectors of 4k each. The flash memory address starts at 0x40200000 and can be read and written from a Zerynth program using the internal flash module.

Warning

If flash memory must be used in a Zerynth program, it is recommended to begin using it from secure addresses towards the end the bytecode (start address of the bytecode can be found in the log console of Zerynth Studio during the uplink operation), leaving a minimum safe place to minimize the chance of clashes.

Note

The internal flash of Wio Link can be organized in different ways. The standard VM is a non-FOTA VM with the VM code beginning at 0x0000, followed by the esp8266 ir0m image at 0x20000 and the esp_init_data at 0x3fc000. The VM is based on the Espressif RTOS SDK 1.4.1.

Device Summary¶

  • Microcontroller: Tensilica 32-bit RISC CPU Xtensa LX106

  • Operating Voltage: 3.3V

  • Input Voltage: 7-12V

  • Digital I/O Pins (DIO): 10

  • Analog Input Pins (ADC): 1

  • UARTs: 1

  • SPIs: 1

  • I2Cs: 1

  • Flash Memory: 4 MB

  • SRAM: 64 KB

  • Clock Speed: 80 Mhz

  • Wi-Fi: IEEE 802.11 b/g/n:

    • Integrated TR switch, balun, LNA, power amplifier and matching network
    • WEP or WPA/WPA2 authentication, or open networks

Power¶

Power to the Wio Link is supplied via the on-board USB Micro B connector or directly throught the connector for a 3.7/4.2 V battery. The power source is selected automatically.

The device can operate on an external supply of 2.5 to 6 volts. If using more than 6V, the voltage regulator may overheat and damage the device.

Connect, Register, Virtualize and Program¶

The Wio Link exposes the serial port of the ESP8266 module via a CP2102 usb bridge which is also connected to the boot pins of the module, allowing for a seamless virtualization of the device.

Note

Drivers for the bridge can be downloaded here and are needed for Windows and Mac platforms.

Note

For Linux Platform: to allow the access to serial ports the user needs read/write access to the serial device file. Adding the user to the group, that owns this file, gives the required read/write access:

  • Ubuntu distribution –> dialout group
  • Arch Linux distribution –> uucp group

Once connected to a USB port the Wio Link device can be seen as a Virtual Serial port and it is automatically recognized by Zerynth Studio. The next steps are:

  • Select the Wio Link on the Device Management Toolbar (disambiguate if necessary);
  • Register the device by clicking the “Z” button from the Zerynth Studio;
  • Create a Virtual Machine for the device by clicking the “Z” button for the second time;
  • Virtualize the device by clicking the “Z” button for the third time.

Note

No user intervention on the device is required for registration and virtualization process

After virtualization, the Wio Link device is ready to be programmed and the Zerynth scripts uploaded. Just Select the virtualized device from the “Device Management Toolbar” and click the dedicated “upload” button of Zerynth Studio.

Note

No user intervention on the device is required for the upload process.

Important

To exploit the Wi-Fi chip functionalities of the Wio Link, the lib.espressif.esp8266wifi library must be installed (some example code is provided).

Firmware Over the Air update (FOTA)¶

The Firmware Over the Air feature allows to update the device firmware at runtime. Zerynth FOTA in the Wio Link device is available for bytecode only.

Flash Layout is shown in table below:

Start address Size Content
0x40200000 448Kb VM Slot
0x40270000 256Kb Bytecode Slot 0
0x402B0000 320Kb Bytecode Slot 1

Important

FOTA Record (small segment of memory where the current and desired state of the firmware is store) for the Wio Link device is allocated in the RTC memory.

Power Management¶

Power Management feature allows to optimize power consumption by putting the device in low consumption state. More information in Power Management - ESP8266 section.

Next Previous

© Copyright Zerynth.

Built with Sphinx using a theme provided by Read the Docs.