1. Dag Ågren
  2. EMW3165 Template

Overview

HTTPS SSH

FreeRTOS+LwIP template project for EMW3165

This is a template project for building code for the EMW3165 using FreeRTOS 9.0.0 and LwIP 2.0.0. It is targeting the standard WiFiMCU development board. It is probably possible to use with other EMW3165 hardware with minor tweaks.

It uses a basic arm-none-eabi GCC toolchain to build, and OpenOCD to upload code to the board. It uses the WiFi driver from Broadcom's WICED framework, but no other parts of it. It is otherwise self-contained and has no other dependencies. It uses only the basic headers from the STM libraries, as the STM driver code is generally quite atrocious.

Toolchain

This code should build with any basic arm-none-eabi toolchain that has support for the Cortex-M4 FPU, but it is developed using the official ARM-maintained toolchain from https://launchpad.net/gcc-arm-embedded.

Building

  • make builds the .elf and .bin files for the project.

  • make upload uses OpenOCD to talk to an STLink v2 programmer and uploads and runs the code on the board.

  • make debugserver starts OpenOCD as a debug server, again using an STLink v2 programmer.

  • make debug builds and connects to the debug server to upload and run the code.

  • make clean cleans up all build product and dependency files.

For OS X users, there's a convenience Xcode project for code editing. Building should execute make upload.

Installing WICED

As the WICED files are restrictively licensed, you will need to download them separtely from Broadcom. Only WICED-SDK-3.7.0-7 is currently supported. You should download WICED-SDK-3.7.0-7.7z.zip from Broadcom's website, unpack it (twice), then put the contained directories in the WICED directory.

Only the include, libraries, resources and WICED directories are actually used.

The WICEDIncludes directories contains symlinks to some files under the WICED directory, for convenience.

Notes

The WiFi chip driver uses the driver code from WICED, with a custom driver to talk to the hardware (SDIO, IO pins and clocks). This is somewhat hackish, and some corners were cut, for instance:

  • The WICED code has a powersave mode for the WiFi chip. It is unclear if this works on the EMW3165, but it certainly doesn't work on with this driver.
  • The only way to change the MAC address is to edit WICEDIncludes/generated_mac_address.txt by hand.
  • The WiFi chip firmware data is stored in normal flash memory. This uses up a lot of space. It should be moved to the external flash, but this is not yet implemented.

License

Except for the FreeRTOS and LwIP parts, which are released under their own license, this code is released into the public domain with no warranties. If that is not suitable, it is also available under the CC0 license.

The WICED code is not distributed with this code, and can probably not be redistributed.