WE Adafruit FeatherWings

Würth Elektronik eiSos presents, a range of FeatherWing development boards that are open source and fully compatible with the Feather form factor. Through these development boards WE brings a range of wireless connectivity modules, sensors and power modules to the Feather ecosystem.

Adafruit Feather is a complete line of development boards from Adafruit and other developers that are both standalone and stackable. They're able to be powered by LiPo batteries for on-the-go use or by their micro-USB plugs for stationary projects. Feathers are flexible, portable, and as light as their namesake.

FeatherWings are stacking boards and add functionality and room for prototyping. At its core, the Adafruit Feather is a complete ecosystem of products - and the best way to get your project flying.

Supercharge your prototyping for easy and fast solution testing. Start by checking our quick start section.

Image	Description
	Adrastea-I FeatherWing (2615039336001) LTE-Cat.M/LTE-Cat.NB-IoT AIntegrated GNSS Integrated User MCU Secure IoT Connectivity using MQTT, LWM2M Note: This board can be used as a featherWing or as a standalone Feather.
	Sensor FeatherWing (2501000201291) Acceleration (WSEN-ITDS) Absolute Pressure (WSEN-PADS) Temperature (WSEN-TIDS) Humidity (WSEN-HIDS) Sparkfun QWIIC® Connect System to connect additional peripherals Note: this Feather will be updated with new sensors in the future.
	Thyone-I Wireless FeatherWing (2611059021001) 2.4 GHz Proprietary radio Module Easy build up networks Connect to Thyone modules or USB-Stick. Note: this Feather will be replaced by Setebos-I Feather with selectable radio protocol (either Proteus-III Bluetooth LE or Thyone-I) in the future.
	Calypso WiFi FeatherWing (2610039025001) 2.4 GHz WiFi-Connectivity Easy and secure connection to Smart Devices Out-of-the-box support to applications like HTTP(S), MQTT(S) AT-style command interface
	Proteus-III BLE FeatherWing (not available as a standalone product) Bluetooth® Low Energy 5.1 module Nano SIM size 2 MBit PHY and Coded PHY (long range) Connect to any smart device with and app. Note: this Feather will be replaced by Setebos-I Feather with selectable radio protocol (either Proteus-III Bluetooth LE or Thyone-I) in the future.
	MagI³C Power FeatherWing (2601157100001) 5 V and 3.3 V power supply Using a range of input voltages (5 V, 9 V, 12 V, 15 V, 18 V and 24 V industrial rails)
	Serial Bridge FeatherWing (2601167101001) RS232/RS485 to UART bridge Retrofit legacy devices with modern Wireless connectivity
	Connect any Adafruit Feather Microcontroller (e.g. Adafruit Feather M0 Express or Adafruit Feather M4 Express) Request sensor data Transfer data to RF-Module Examples available on Github Source code available on Github

Quick start guide

Read this documentation!

This step-by-step description will guide you through the setup process for taking WE FeatherWings into operation and help avoid the most common mistakes.

Hardware requirements

1. Adafruit Feather M0 - FeatherWings are stackable, add-on boards that bring additional functionality to any Feather board. The current repository contains software developed on the Adafruit Feather M0 express.

Note: The WE FeatherWings can be operated only in combination with a Feather. Please use the Feather M0 express for the quick start examples.

2. WE FeatherWing - Please choose the FeatherWing of interest or a combination of FeatherWings and stack it on to the Feather.

3. Stable power supply - Please ensure that the boards are powered using a clean and stable power supply. The following input options are available,

• USB interface on the M0 Feather.

Note: Please use this option for the quick start examples. The USB interface will also be used to upload the example code to the microcontroller.

• LiPo - For low power applications, it is also possible to connect a LiPo battery. Please ensure that the battery can deliver sufficient current at the desired voltage for the combination of boards used.

• MagI³C Power FeatherWing (2601157100001) - Stack on this WE FeatherWing to use a range of input voltages (5 V, 9 V, 12 V, 15 V, 18 V and 24 V industrial rails).

4. Computing device with sufficient memory and an internet connection.

Note: The software tools used in the quick start example require up to 2 GB of data storage.

Software installation

In order to enable ease of prototyping, we use the popular cross platform integrated development environment, Visual Studio Code along with some extensions. The following steps will guide you through the installation process.

1. Download and install Visual Studio Code by following the steps described here.

Note: If you are in a corporate environment, check with your IT department if you are required to enter proxy settings and credentials inside Visual Studio Code.

2. Install the PlatformIO extension for Visual Studio Code.

• Select Extensions in the lower left
• Type platformio in the Search window and
• when PlatformIO IDE extension appears, press the blue Install button

Note: Do not close the Visual Studio Code window until PlatformIO is completely installed. Installation process can be slow, depending on speed and network connection of your computer.

3. After the PlatformIO extension has been installed follow the on screen instructions to restart Visual Studio Code.

The PlatformIO extension will then be loaded in Visual Studio Code and its icon will appear in the Visual Studio Code menu bar on the left side.

Running the sample applications

1. Download documentation and example code from https://github.com/WurthElektronik/FeatherWings using git clone https://github.com/WurthElektronik/FeatherWings.git or a simple zip file.

1. This repository contains the following different, ready-to-run applications:

   • Sensor FeatherWing example showing the functionality of the Sensor FeatherWing.

   • Thyone-I Wireless FeatherWing example showing the transmit and receive functionality over a 2.4 GHz proprietary wireless link.

   • Calypso Wi-Fi FeatherWing example showing the Wi-Fi capabilities.

   • Sensor2Cloud connectivity example sends data measured using the sensors via Wi-Fi to the Microsoft Azure or Amazon AWS cloud.

   • Sensor2BLE connectivity example uses Bluetooth Low Energy in Role Peripheral to share the Sensor measurement values with a Smart Device. The WE-SensorBLE App is required on the smart device. Requires to a Proteus-III compatible radio module, such as available with Setebos-I Feather.

   • Adrastea Cloud connectivity example showing cloud connectivity via MQTT.

   • RS232/RS485 to wireless example that shows bridging RS232/RS485 to either Proprietary Wireless link of standard MQTT over Wi-Fi.

   • Thyone Wireless Sensors example that shows a sensor node that transmit sensor data over proprietary wireless link.

   • Sensor data via HTTP example shows a demo to display sensor data on a webpage using RestAPIs.

Note: For more details on each board and workspace, please click on the links above.

3. Open workspace file for the case you want to test.

Chose the workspace you would like to work with based on your preferences.

After selecting the workspace, the workspace will appear in your Visual Studio Code and PlatformIO will recognize it as its project. In this quick start guide we will use the simple SensorFeatherWing workspace.

1. After loading the workspace, connect the set of boards you want to test to the USB port for programming. For that you will need a combination of at least one WE FeatherWing and one microcontroller Feather board (for more details see table below).

5. Go into the PlatformIO extension and select the PROJECT TASKS dropdown list.

6. Build the code using the PlatformIO extension and then Upload it to the microcontroller. The Upload command will also execute Build before it uploads, but doing it in two steps, first Build then Upload, you will be able to check if the code is correctly built and it prevents uploading erroneous code to the microcontroller.

Note: Wait until PlatformIO rebuilds its indices. Index rebuild processes can be slow, depending on speed and network connection of you computer.

7. Press Monitor and check the Visual Studio Code TERMINAL window for results.