Contiki-NG
Modules | Files | Functions

The OpenMote platform is based on the CC2538 by Texas Instruments based on an ARM Cortex-M3 core and a IEEE 802.15.4 radio. More...

Modules

 OpenMote boards
 

Files

file  platform.c
 Main module for the OpenMote platform.
 

Functions

void board_init (void)
 Board specific iniatialisation.
 
void platform_init_stage_one (void)
 Basic (Stage 1) platform driver initialisation. More...
 
void platform_init_stage_two ()
 Stage 2 of platform driver initialisation. More...
 
void platform_init_stage_three ()
 Final stage of platform driver initialisation. More...
 
void platform_idle ()
 The platform's idle/sleep function. More...
 

Detailed Description

The OpenMote platform is based on the CC2538 by Texas Instruments based on an ARM Cortex-M3 core and a IEEE 802.15.4 radio.

The OpenMote platform was designed at UC Berkeley in 2013 and is comercialized by OpenMote Technologies since 2014. It is the first commercial platform based on the TI CC2538 SoC.

Function Documentation

◆ platform_idle()

void platform_idle ( void  )

The platform's idle/sleep function.

This function will be called as part of the main loop after all events have been serviced. This is where you will normally put the device in a low-power state. Waking up from this state and tidying up the hardware is the port's responsibility.

It is the port developer's responsibility to implement this function.

Definition at line 180 of file platform.c.

◆ platform_init_stage_one()

void platform_init_stage_one ( void  )

Basic (Stage 1) platform driver initialisation.

This function will get called early on in the Contiki-NG boot sequence.

In this function, the platform should initialise all core device drivers. For example, this is where you will normally want to initialise hardware timers/clocks, GPIO, LEDS. Normally this function will also enable the MCU's global interrupt.

The Contiki-NG process scheduler, software clocks and timers will not be running yet, so any platform drivers that rely on it should not be initialised here. Instead, they should be initialised in platform_init_stage_two() or in platform_init_stage_three()

It is the port developer's responsibility to implement this function.

See also
platform_init_stage_two()
platform_init_stage_three()

Definition at line 117 of file platform.c.

References leds_init(), and soc_init().

◆ platform_init_stage_three()

void platform_init_stage_three ( void  )

Final stage of platform driver initialisation.

Initialisation of platform-specific drivers that require networking to be running. This is also a good place to initialise sensor drivers.

When this function returns, the main routine will assume that the hardware is fully initialised.

It is the port developer's responsibility to implement this function.

See also
platform_init_stage_one()
platform_init_stage_two()

Definition at line 164 of file platform.c.

◆ platform_init_stage_two()

void platform_init_stage_two ( void  )

Stage 2 of platform driver initialisation.

This function will be called by the Contiki-NG boot sequence after parts of the core have been initialised. More specifically, when this function gets called, the following modules will be running:

  • Software clock
  • Process scheduler
  • Event timer (etimer)
  • Callback timer (ctimer)
  • rtimer
  • Energest (if enabled)

Therefore, any platform driver that relies on any of the above modules should be initialised here or in platform_init_stage_three(), but not in platform_init_stage_one()

The Contiki-NG network stack will not be running yet, so any platform drivers that rely on networking should not be initialised here.

When this function returns, the main routine will assume that the platform has enabled character I/O and can print to console. When this function returns, main() will attempt to initialise the network stack. For this to work properly, this function should also populate linkaddr_node_addr.

It is the port developer's responsibility to implement this function.

See also
platform_init_stage_one()
platform_init_stage_three()

Definition at line 126 of file platform.c.

References i2c_init(), SERIAL_LINE_CONF_UART, serial_line_input_byte(), uart_init(), uart_set_input(), usb_serial_init(), and usb_serial_set_input().