Common Native Board

Shared files and configuration for native. More...

Detailed Description

Shared files and configuration for native.

Overview

The RIOT native boards use system calls and signals to emulate hardware at the API level. That means that you can compile the complete RIOT software stack for your *NIX system and run it as a process. Reasons why you might want to do that are:

• You want to try out RIOT but don't have one of the supported hardware platforms
• You are developing an application for RIOT or you are hacking on RIOT itself and want to test and debug without the limitations and requirements of debugging on actual hardware
• You want to experiment with network protocols in a controlled environment

Two different boards are currently available, depending on the host platform: Native32 Board and Native64 Board. Using BOARD=native will automatically select the right variant.

Hardware

• CPU: Host CPU
• RAM: Host RAM
• Flash:
  • for program execution: Host file system
  • for the Flash page driver : emulated in RAM
• Network: Tap Interface
• UART: Runtime configurable - /dev/tty* are supported
• Timers: Host timer
• LEDs: One red and one green LED - state changes are printed to the UART
• PWM: Dummy PWM
• QDEC: Emulated according to PWM
• SPI: Runtime configurable - /dev/spidev* are supported (Linux host only)
• GPIO: Runtime configurable - /dev/gpiochip* are supported (Linux host only)

Configuration

Some aspects of a native RIOT instance can be configured at runtime. To get an overview invoke the program with the -h option. Example:

$ examples/basic/default/bin/native64/default.elf -h
usage: examples/basic/default/bin/native64/default.elf <tap interface 1> [-i <id>] [-d] [-e|-E] [-o] [-c <tty>] [-g <gpiochip>] [-i <id>] [-d] [-e|-E] [-o] [-c <tty>] [--eui64 <eui64> …]
 
help: examples/basic/default/bin/native64/default.elf -h
 
Options:
    -h, --help
        print this help message
    -i <id>, --id=<id>
        specify instance id (set by config module)
    -s <seed>, --seed=<seed>
        specify srandom(3) seed (/dev/random is used instead of random(3) if
        the option is omitted)
    -d, --daemonize
        daemonize native instance
    -e, --stderr-pipe
        redirect stderr to file
    -E, --stderr-noredirect
        do not redirect stderr (i.e. leave sterr unchanged despite
        daemon/socket io)
    -o, --stdout-pipe
        redirect stdout to file (/tmp/riot.stdout.PID) when not attached
        to socket
    -c <tty>, --uart-tty=<tty>
        specify TTY device for UART. This argument can be used multiple
        times (up to UART_NUMOF)
    -g <gpio>, --gpio=<gpio>
        specify gpiochip device for GPIO access.
        This argument can be used multiple times.
        Example: --gpio=/dev/gpiochip0 uses gpiochip0 for port 0
    -U <eui64>, --eui64=<eui64>
        provide a ZEP interface with EUI-64 (MAC address)
        This argument can be provided multiple times
    -w <tap>
        Add a tap interface as a wireless interface

As with any platform, you can specify the sizes of your stacks, i.e. the amount of space your application can use. You may wish to use a more realistic stack size than native's THREAD_STACKSIZE_DEFAULT to increase realism.

Known Issues

Check the list of open issues labeled native in the github issue tracker

Files
file	board.h
	The native boards use call level hardware simulation.
file	eui_provider_params.h
	EUI providers found on the board.