NETMF for STM32

"Congratulations! Great to see this cooperation across different NETMF manufacturers, and your leadership. I’m particularly grateful since you’ve paved the way for a halving of the cost of Gadgeteer mainboards!"

James Scott, Microsoft Research, Cambridge

Modern 32-bit microcontrollers

Most smartphones and tablets are powered by ARM-compatible microprocessors. These are relatively large devices that need additional memories and other support chips. In contrast, microcontrollers often don't require external memories and can therefore be put into smaller and less expensive packages with fewer pins.

While microcontrollers are not as powerful as high-end smartphone processors, they have nevertheless reached impressive performance levels. ARM-compatible microcontrollers support data buses that are 32 bit wide, making them much faster than the older 8-bit microcontrollers. They enable the use of modern, robust and productive software platforms for programming them.

What is the .NET Micro Framework?

Microsoft's .NET platform is preinstalled on every Windows PC and is well-known to hundreds of thousands of software developers worldwide. The .NET Micro Framework (NETMF) is an implementation of .NET specifically for microcontrollers. It allows writing embedded software in C#, using Microsoft’s ubiquitous Visual Studio tools. Yet it is about a hundred times smaller than the PC version of .NET!

The .NET Micro Framework is designed so that it can run directly on the hardware, without underlying operating system. It is a "bootable .NET runtime".

The .NET Micro Framework is open source software, governed by the Apache 2.0 license: there are no "target royalties", you may develop commercial software without being required to pass on your own improvements, and adaptations to different hardware are possible anytime.

The ARM architecture

Today, ARM is one of the most popular architectures for microcontrollers. The current ARM architecture (i.e., instruction set) for microcontrollers is called ARMv7M. It provides a carefully chosen subset of the instruction set of higher-end smartphone processors. ARM Ltd. defines the ARM architectures.

ARM Cortex-M cores

ARM Ltd. also designs cores.  An ARM core is a specific implementation of an ARM architecture. There may exist multiple cores for the same architecture. Confusingly, an ARM7 core implements the ARMv3, ARMv4, or ARMv5 architecture. An ARM9 core implements the ARMv4 or ARMv5 architecture.

Cores that implement the current ARMv7M architecture have a more intuitive naming scheme. They are called Cortex-M, with a suffix that indicates relative performance and functionality. For example, Cortex-M3 is more powerful than Cortex-M0, but possibly more expensive and consuming more power. Cortex-M4 is basically Cortex-M3 with some additional instructions that are useful when implementing specialized signal processing algorithms.

There have been NETMF ports to various ARM7 and ARM9 cores for some time. We have ported NETMF to the newer Cortex-M3 and Cortex-M4 cores. This task involved mainly the core initializations: interrupts, reset, error handling, etc.

This was the most difficult part of porting NETMF, namely to a completely different core (and instruction set architecture as well), although it only affects a small part of the overall sources. It should make life far easier for anyone who wants to port NETMF to a Cortex-M3 or Cortex-M4 core, regardless of the chosen manufacturer.

The STM32 microcontroller family

ARM develops the cores, but doesn't manufacture them. Its semiconductor partners license one or more cores and develop complete microcontroller chips around them. To that purpose, they add on-chip RAM and Flash memories to the cores, plus a multitude of (proprietary) peripherals. STMicroelectronics is one of several ARM licensees that have built products around Cortex-M cores, in this case called STM32. This has become one of the most popular and cost-effective Cortex-M implementations on the market.

Today, there are over 200 different STM32 variations. Some of their part numbers start with STM32F1, STM32F2, or STM32F4. These are three families with different performance characteristics. The STM32F4 family is the most powerful, using a Cortex-M4 core.

One example is the STM32F407. It runs at 168 MHz, has 1 MB of Flash and 192 KB of RAM. It sports a variety of on-chip peripherals, from digital I/O (GPIO) to USB and Ethernet support. It comes on a 14 mm by 14 mm package with 100 pins. There are larger package variants with more pins, allowing to add external memories, and also smaller packages, with fewer I/Os. At the time of this writing, a 100 pin variant of this chip is available for about $17 (one chip) to less than $10 (10,000 units).

NETMF for STM32

We have ported NETMF to the STM32F1, STM32F2 and STM32F4 families ("NETMF for STM32"). This involved writing drivers for the on-chip peripherals: GPIOs, analog inputs and outputs, I2C, SPI, UARTs, USB, internal Flash, power management, timers, etc. From the perspective of NETMF, STM32F2 and STM32F4 are almost identical. The older STM32F1 requires some different drivers, however, as it has more limited peripherals. We distinguish between NETMF for STM32 (F1 Edition) for the STM32F1 products, and NETMF for STM32 (F4 Edition) for the STM32F2 and STM32F4 products.

This part of porting NETMF was the most time-consuming, as it involved writing drivers for many different peripherals, and for two hardware generations (F1 versus F2/F4).

NETMF for STM32 (F1 Edition)

The STM32F1 edition of our NETMF port is already contained in Microsoft’s Porting Kit for NETMF 4.2 since October 2011. Once you have installed the porting kit, you can find the STM32 software in


C:\MicroFrameworkPK_v4_2\DeviceCode\Targets\Native\STM32\

The following documents provide more information on the F1 Edition of our NETMF port:

NETMF for STM32 - Technical Notes Release 4.2.pdf
Technical notes regarding the supported STM32F1 boards (supported drivers, memory maps, etc.)
NETMF for STM32 - Technical Notes Releas
Adobe Acrobat Document [95.3 KB]
Download
NETMF for STM32 - Standard IO Mapping for STM32F1.pdf
Which CPU pins are available on an STM32F1 microcontroller, and how can they be used from NETMF.
NETMF for STM32 - Standard IO Mapping fo
Adobe Acrobat Document [58.2 KB]
Download

NETMF for STM32 (F4 Edition)

You can find NETMF for STM32 (F4 Edition), for NETMF 4.2, at this Codeplex site. Note that it can also be used for STM32F2 chips, you just need other project settings (compiler options), as the F2 chips have no floating-point units.

For NETMF 4.3, the F4 Edition will be integrated into Microsoft's Porting Kit just like the F1 Edition.

The following document provides an overview over NETMF porting in general, and the F4 Edition in particular:

NETMF for STM32 (F4 Edition) - Tour d'Horizon
Gives an overview over the STM32 hardware, the NETMF Porting Kit in general, and the files that need to be touched when adapting a port for your specific needs.
NETMF for STM32 - Tour d'Horizon.pdf
Adobe Acrobat Document [881.8 KB]
Download

More documentation is available on the Codeplex site.

Boards with the STM32

We have adapted NETMF for STM32 to several off-the-shelf boards (not all peripherals may be supported):

  • STM32F103: the MCBSTM32E evaluation kit of Keil, an ARM subsidiary.
  • STM32F103: the ET-STM32-Stamp from Futurelec. At $25, this is an inexpensive board. To save memory, we use the boot loader built into the STM32 chips, instead of the NETMF boot loader.
  • STM32F207: the STM3230G-EVAL evaluation board from STMicroelectronics.
  • STM32F407: the STM3240G-EVAL evaluation board from STMicroelectronics.
  • STM32F407: the STM32F4DISCOVERY discovery kit from STMicroelectronics. This board has audio support and is somewhere between inexpensive and free.

Other boards

You could adapt NETMF for STM32 to any other board with a suitable STM32 microcontroller. Depending on your experience and knowledge of NETMF and the C/C++ tool chain that you use, this may take from less than one day to several weeks. Additional work may be required depending on what additional hardware the board provides. For example, if the board has a GSM module, then a driver for this module must be developed.

Custom boards

The board shown to the right uses an STM32F103RE microcontroller and NETMF for STM32. It was custom-designed for Phonak (aka Unitron), the world’s largest provider of hearing aids. The board helps the Phonak engineers to test new hearing aids. It allows switching between several pairs of attached hearing aids. This switching is controlled by a PC via USB. For the PC, we provided a .NET library that sends control commands to the board. In this way, we were able to use .NET, C# and Visual Studio both for the PC application and for the embedded software, eliminating the need for special-purpose embedded tools.

Support

We contribute NETMF for STM32 to Microsoft's NETMF code base, with integration and basic support done by Microsoft. The members of the Mountaineer Group can offer more specific support, albeit only in the context of substantial customer projects (contract volumes for our engineering services usually start at about $25,000).

If you find any issues with the code, please use the issue tracker on Codeplex to report them.