RTEMS 5 Embedded Realtime Operating System

RTEMS Web Sites

Release Files

RTEMS Documentation

The generated documentation can be found in the docs directory.

The following manuals are available as compress HTML tar files or PDF:

RTEMS User Manual

• docs/rtems-5.1.0-rc1-user.pdf
• docs/rtems-5.1.0-rc1-user-html.tar.xz

RTEMS C User Manual

• docs/rtems-5.1.0-rc1-c-user.pdf
• docs/rtems-5.1.0-rc1-c-user-html.tar.xz

RTEMS POSIX User Manual

• docs/rtems-5.1.0-rc1-posix-users.pdf
• docs/rtems-5.1.0-rc1-posix-users-html.tar.xz

RTEMS Software Engineering Manual

• docs/rtems-5.1.0-rc1-eng.pdf
• docs/rtems-5.1.0-rc1-eng-html.tar.xz

RTEMS Networking User Manual

• docs/rtems-5.1.0-rc1-networking.pdf
• docs/rtems-5.1.0-rc1-networking-html.tar.xz

RTEMS Shell User Manual

• docs/rtems-5.1.0-rc1-shell.pdf
• docs/rtems-5.1.0-rc1-shell-html.tar.xz

RTEMS Doxygen

• docs/rtems-5.1.0-rc1-doxygen-html.tar.xz

Quick Guide to Building

For new user the Quick Start in the User Manual contains a details Quick Start guide. Download the User Manual:

https://ftp.rtems.org/pub/rtems/releases/5/rc/5.1.0-rc1/docs/rtems-5.1.0-rc1-user.pdf

and follow the instructions in the Quick Start section. If are familiar with RTEMS or just want to get going the following steps will download the RTEMS Source Builder:

cd
mkdir -p development/rtems
cd development/rtems
wget https://ftp.rtems.org/pub/rtems/releases/5/rc/5.1.0-rc1/sources/rtems-source-builder-5.1.0-rc1.tar.xz
tar Jxf rtems-source-builder-5.1.0-rc1.tar.xz
cd rtems-source-builder-5.1.0-rc1/rtems

To build the tools for the ARM architecture:

../source-builder/sb-set-builder \
  --prefix=$HOME/development/rtems/5.1.0-rc1 \
  5/rtems-arm

To build the tools, kernel and all packages for the Beagleboneblack:

../source-builder/sb-set-builder \
  --prefix=$HOME/development/rtems/5.1.0-rc1 \
  5/bsps/beagleboneblack

If you encounter a problem please post to the user@rtems.org mailing list. You can join the Users mailing at https://lists.rtems.org/.

If you find a bug please raise a ticket at https://devel.rtems.org/newticket.

RTEMS 5.1 Release Notes

RTEMS Shell Improvements

The following improvements were made to the RTEMS Shell:

• Telnet now supports joel script output. Running a joel script in a telnet session now sees the output. Nested joel scripts also output to the telnet session.

General

• The system initialization is now performed by system initialization handlers registered in a special linker set (similar to global constructors in C++).

• API header files have been collected from the various locations in the RTEMS source tree and placed under cputkit/include and for BSPs under bsps/include. There is no header pre-install phase when building RTEMS.

• Improved parallel build performance. Nested make calls now run in parallel.

• Added support for the RISC-V 32-bit and 64-bit architecture.

• Added support for the 64-bit PowerPC architecture using the ELFv2 ABI.

• Synchronized support for Journalling Flash File System, Version 2 (JFFS2) with Linux 4.17.

• Import of libfdt from device tree compiler project.

• Added libdebugger, a thread aware GDB debug server with TCP transport support. Currently the supported architectures are i386 and ARM. The ARM support is experimental.

• Most BSP use now function and data sections to support the linker garbage collection.

• This is the last release of RTEMS with the autoconf/automake build system. RTEMS will be moving to a waf based build system driven from YAML specifications files. The effort is part of the on-going wotk in the RTEMS project to support qualification of the operating system.

Architectures

Removed obsolete architectures:

• AVR

• H8300

• M32C

• M32R

Obsoleted architectures:

• Epiphany

• PowerPC SPE

BSPs and Device Drivers

• General

  • BSP source code moved from c/src/lib/libbsp to bsps in the source tree. The configure and some other related pieces are still held in the original path.

• New BSPs

  • BSPs for ARM

    • atsamv - Microchip (former Atmel) SAM V71 series

    • xilinx-zynqmp - Xilinx Zynq UltraScale+ MPSoC platform

  • BSPs for RISC-V

    • riscv - Family of generic BSPs

    • griscv - BSP based on the GRLIB

• Significant updates to existing BSPs

  • powerpc/qoriq: 64-bit support

• Removal of obsoleted BSPs

  • arm/gdbarmsim

  • arm/nds

  • arm/gp32

  • arm/ep1a

  • arm/score603e

  • m68k/idp

• Obsoleted BSPs

  • m68k/gen68302

  • m68k/ods68302

  • powerpc/brs5l

  • powerpc/brs6l

  • powerpc/dp2

  • powerpc/mbx8xx

  • powerpc/mpc5566evb_spe

  • powerpc/mpc5643l_dpu

  • powerpc/mpc5643l_evb

  • powerpc/mpc5674f_ecu508_app

  • powerpc/mpc5674f_ecu508_boot

  • powerpc/mpc5674fevb_spe

  • powerpc/mpc5674f_rsm6

• Drivers

  • Drivers for getentropy()

  • New I2C device driver framework supporting the Linux user-space API

  • New SPI device driver framework supporting the Linux user-space API

Newlib Changes

• time_t is now 64-bit to adress the year 2038 problem.

• General improvements in the feature test macros support.

• Newlib internal locks are now supported, e.g. for FILE objects.

• The standard input, output, and error FILE objects are now global and no longer thread-specific.

• Added support for C++17 std::aligned_alloc

Ecosystem

• RSB support to build a BSP software stack of tools, kernel, libbsd, and supported 3rd party packages.

• RTEMS Tester (rtems-test) support for DHCP/TFTP target hardware testing.

• RTEMS Trace addition of a new trace record support for target tracing.

• RTEMS Bootimage, a tool to portably create SD card images.

Architectures and BSPs

Architectures: 18
BSP Families: 85
BSPs: 199