RTEMS Documentation Project
RTEMS User Manual
5.d8d5876
1. Introduction
1.1. Overview
1.2. Features
1.3. Ecosystem
1.3.1. Rational
1.3.2. Open Source
1.3.3. Deployment
1.4. Support
1.4.1. RTEMS Project Support
1.4.1.1. Bug Tracker
1.4.1.2. Documentation
1.4.1.3. Mailing Lists
1.4.1.4. IRC
1.4.1.5. Developers
1.4.2. Commercial Support Services
1.5. Real-time Application Systems
1.6. Real-time Executive
2. Quick Start
2.1. Prepare Your Host Computer
2.2. Choose an Installation Prefix
2.3. Obtain the Sources
2.4. Install the Tool Suite
2.5. Bootstrap the RTEMS Sources
2.6. Build a Board Support Package (BSP)
2.7. Test a Board Support Package (BSP)
2.8. Build Your Application
3. Host Computer
3.1. Host Operating Systems
3.2. POSIX Hosts
3.2.1. Root Access
3.2.2. Linux
3.2.2.1. ArchLinux
3.2.2.2. CentOS
3.2.2.3. Fedora
3.2.2.4. Raspbian
3.2.2.5. Ubuntu
3.2.2.6. Linux Mint
3.2.2.7. openSUSE
3.2.3. FreeBSD
3.2.4. NetBSD
3.3. Apple MacOS
3.3.1. Mavericks
3.3.2. Sierra
3.4. Microsoft Windows
3.4.1. Windows Path Length
3.4.2. Parallel Builds with Make
3.4.3. POSIX Support
3.4.4. Python
3.4.5. MSYS2
3.4.6. Cygwin
4. Installation
4.1. Releases
4.1.1. RTEMS Tools and Kernel
4.2. Developer (Unstable)
4.2.1. POSIX and OS X Host Tools Chain
4.2.2. Windows Host Tool Chain
4.2.2.1. RTEMS Windows Tools
4.2.2.2. Building the Kernel
4.3. RTEMS Kernel
4.3.1. Development Sources
4.3.2. Tools Path Set Up
4.3.3. Bootstrapping
4.3.4. Building a BSP
4.3.5. Installing A BSP
4.3.6. Contributing Patches
4.4. Project Sandboxing
5. Target Hardware
5.1. Targets
5.2. Architectures
5.3. Tiers
6. Board Support Packages
6.1. aarch64 (AArch64)
6.2. arm (ARM)
6.2.1. altera-cyclone-v (Intel Cyclone V)
6.2.1.1. Boot via U-Boot
6.2.1.2. Clock Driver
6.2.1.3. Console Driver
6.2.1.4. I2C Driver
6.2.1.5. Network Interface Driver
6.2.1.6. MMC/SDCard Driver
6.2.1.7. USB Host Driver
6.2.1.8. Caveats
6.2.2. atsam
6.2.3. beagle
6.2.3.1. Boot via U-Boot
6.2.3.2. Getting the Device Tree Blob
6.2.3.3. Writing the uEnv.txt file
6.2.3.4. I2C Driver
6.2.3.5. SPI Driver
6.2.4. csb336
6.2.5. edb7312
6.2.6. gdbarmsim
6.2.7. gumstix
6.2.8. imx (NXP i.MX)
6.2.8.1. Build Configuration Options
6.2.8.2. Boot via U-Boot
6.2.8.3. Clock Driver
6.2.8.4. Console Driver
6.2.8.5. I2C Driver
6.2.8.6. SPI Driver
6.2.8.7. Network Interface Driver
6.2.8.8. MMC/SDCard Driver
6.2.8.9. Caveats
6.2.9. lm3s69xx
6.2.10. lpc176x
6.2.11. imx (NXP i.MX)
6.2.11.1. Build Configuration Options
6.2.11.2. Boot via U-Boot
6.2.11.3. Clock Driver
6.2.11.4. Console Driver
6.2.11.5. I2C Driver
6.2.11.6. SPI Driver
6.2.11.7. Network Interface Driver
6.2.11.8. MMC/SDCard Driver
6.2.11.9. Caveats
6.2.12. raspberrypi
6.2.13. realview-pbx-a9
6.2.14. rtl22xx
6.2.15. smdk2410
6.2.16. tms570
6.2.17. xilinx-zynq
6.3. bfin (Blackfin)
6.3.1. bf537Stamp
6.3.2. eZKit533
6.3.3. TLL6527M
6.4. epiphany (Epiphany)
6.4.1. epiphany_sim
6.5. i386
6.5.1. pc386
6.6. lm32 (LatticeMicro32)
6.6.1. lm32_evr
6.6.2. milkymist
6.7. m68k (Motorola 68000 / ColdFire)
6.7.1. av5282
6.7.2. csb360
6.7.3. gen68340
6.7.4. gen68360
6.7.5. genmcf548x
6.7.6. mcf5206elite
6.7.7. mcf52235
6.7.8. mcf5225x
6.7.9. mcf5235
6.7.10. mcf5329
6.7.11. mrm332
6.7.12. mvme147
6.7.13. mvme147s
6.7.14. mvme162
6.7.15. mvme167
6.7.16. uC5282
6.8. microblaze (Microblaze)
6.9. mips (MIPS)
6.9.1. csb350
6.9.2. hurricane
6.9.3. jmr3904
6.9.4. malta
6.9.5. rbtx4925
6.9.6. rbtx4938
6.10. moxie
6.10.1. moxiesim
6.11. nios2 (Nios II)
6.11.1. nios2_iss
6.12. or1k (OpenRISC 1000)
6.12.1. generic_or1k
6.13. powerpc (PowerPC)
6.13.1. beatnik
6.13.2. gen5200
6.13.3. gen83xx
6.13.4. haleakala
6.13.5. motorola_powerpc
6.13.5.1. Boot Image Generation
6.13.6. mpc55xxevb
6.13.7. mpc8260ads
6.13.8. mvme3100
6.13.9. mvme5500
6.13.10. psim
6.13.11. qemuppc
6.13.12. qoriq (QorIQ)
6.13.12.1. Boot via U-Boot
6.13.12.2. Clock Driver
6.13.12.3. Console Driver
6.13.12.4. Network Interface Driver
6.13.12.5. Topaz Hypervisor Guest
6.13.13. ss555
6.13.14. t32mppc
6.13.15. tqm8xx
6.13.16. virtex
6.13.17. virtex4
6.13.18. virtex5
6.14. riscv (RISC-V)
6.14.1. riscv
6.14.1.1. Build Configuration Options
6.14.1.2. Interrupt Controller
6.14.1.3. Clock Driver
6.14.1.4. Console Driver
6.14.2. griscv
6.15. sh (SuperH)
6.15.1. gensh1
6.15.2. gensh2
6.15.3. gensh4
6.15.4. shsim
6.16. sparc64 (SPARC V9)
6.16.1. niagara
6.16.2. usiii
6.17. sparc (SPARC / LEON)
6.17.1. erc32
6.17.2. leon2
6.17.3. leon3
6.18. v850 (V850)
6.18.1. gdbv850sim
6.19. x86_64
6.19.1. amd64
6.19.1.1. Build Configuration Options
6.19.1.2. Testing with QEMU
6.19.1.3. Boot RTEMS via FreeBSD’s bootloader
6.19.1.4. Paging
6.19.1.5. Interrupt Setup
6.19.1.6. Clock Driver
6.19.1.7. Console Driver
7. Executables
7.1. RTEMS Executable
7.2. Building an Application
7.2.1. Machine Flags and ABI
7.3. Target Execution
7.4. BSP Initialization
7.5. RTEMS Initialization
7.5.1. System Initialization Handlers
7.6. Debugging
7.7. Dynamic Loader
7.7.1. System Design
7.7.2. Loader Interface
7.7.3. Symbols
7.7.3.1. Base Image Symbols
7.7.3.2. Embedded Symbols
7.7.3.3. Loadable Symbols
7.7.4. Unresolved Symbols
7.7.5. Libraries
7.7.6. Large Memory
7.7.7. Allocator
7.7.8. Languages
7.7.9. Thread Local Storage
7.7.10. Architectures
7.7.10.1. ARM
7.7.10.2. PowerPC
8. Testing
8.1. Test Banners
8.2. Test Controls
8.2.1. Expected Test States
8.2.2. Test Configuration
8.3. Test Builds
8.4. Tester Configuration
8.4.1. Defaults
8.4.2. BSP and User Configuration
8.4.3. Configuration Scripts
8.4.3.1. Console
8.4.3.2. Execute
8.4.3.3. GDB
8.4.3.4. TFTP
8.5. Consoles
8.6. Simulation
8.7. GDB and JTAG
8.8. TFTP and U-Boot
8.8.1. Target Hardware
8.8.1.1. U-Boot Set Up
8.8.2. BSP Configuration
8.8.3. TFTP Sequences
9. Tracing
9.1. Introduction to Tracing
9.1.1. RTEMS Trace Using Trace Buffering
9.1.2. RTEMS Trace Using Printk
9.2. Tracing Examples
9.2.1. Features
9.2.2. Prerequisites
9.2.3. Demonstration
9.3. Capture Engine
9.3.1. Capture Engine Commands
9.3.2. Example
9.4. Trace Linker
9.4.1. Command Line
9.4.2. Configuration (INI) files
9.4.2.1. Tracer Section
9.4.2.2. Options section
9.4.2.3. Trace Section
9.4.2.4. Function Section
9.4.2.5. Generators
9.4.3. Development
9.5. Event Recording
10. Host Tools
10.1. RTEMS Linker
10.2. RTEMS Symbols
10.2.1. Symbol Table
10.2.2. 2-Pass Linking
10.2.3. Command
10.2.4. Examples
10.3. RTEMS Executable Infomation
10.3.1. System Initialisation
10.3.2. Command
10.3.3. Examples
10.4. RTEMS BSP Builder
10.4.1. Developer Workflows
10.4.2. Build Characteristics
10.4.2.1. Profiles
10.4.2.2. Builds
10.4.3. Build Configurations
10.4.4. Performance
10.4.5. Command
10.4.5.1. Examples
10.5. RTEMS Tester and Run
10.5.1. Available BSP testers
10.5.2. Building RTEMS Tests
10.5.3. Running the Tests
10.5.4. Test Status
10.5.4.1. Pass
10.5.4.2. Fail
10.5.4.3. User-input
10.5.4.4. Expected-fail
10.5.4.5. Indeterminate
10.5.4.6. Benchmark
10.5.4.7. Timeout
10.5.4.8. Invalid
10.5.5. Reporting
10.5.5.1. All
10.5.5.2. Failures
10.5.5.3. None
10.5.6. Running Tests in Parallel
10.5.7. Command Line Help
10.6. RTEMS Boot Image
10.6.1. Boot Loaders
10.6.1.1. U-Boot
10.6.2. Hosts
10.6.2.1. FreeBSD
10.6.2.2. Linux
10.6.2.3. MacOS
10.6.3. Configuration
10.6.4. Command
10.6.5. Examples
11. RTEMS Source Builder
11.1. Why Build from Source?
11.2. Project Sets
11.2.1. Bare Metal
11.2.2. RTEMS
11.2.3. Patches
11.3. Cross and Canadian Cross Building
11.3.1. Cross Building
11.3.2. Canadian Cross Building
11.4. RTEMS Third-Party Packages
11.4.1. Vertical Integration
11.4.2. Building
11.4.3. Adding
11.4.4. BSP Support
11.4.5. RTEMS BSP Configuration
11.5. Configuration
11.5.1. Source and Patches
11.5.1.1. HTTP, HTTPS, and FTP
11.5.1.2. GIT
11.5.1.3. CVS
11.5.2. Macros and Defaults
11.5.2.1. Macro Maps and Files
11.5.2.2. Personal Macros
11.5.3. Report Mailing
11.5.4. Build Set Files
11.5.5. Configuration Control
11.5.6. Personal Configurations
11.5.7. New Configurations
11.5.7.1. Layering by Including
11.5.7.2. Configuration File Numbering
11.5.7.3. Common Configuration Scripts
11.5.7.4. DTC Example
11.5.7.5. Debugging
11.5.8. Scripting
11.5.8.1. Expanding
11.5.8.2. %prep
11.5.8.3. %build
11.5.8.4. %install
11.5.8.5. %clean
11.5.8.6. %include
11.5.8.7. %name
11.5.8.8. %summary
11.5.8.9. %release
11.5.8.10. %version
11.5.8.11. %buildarch
11.5.8.12. %source
11.5.8.13. %patch
11.5.8.14. %hash
11.5.8.15. %echo
11.5.8.16. %warning
11.5.8.17. %error
11.5.8.18. %select
11.5.8.19. %define
11.5.8.20. %undefine
11.5.8.21. %if
11.5.8.22. %ifn
11.5.8.23. %ifarch
11.5.8.24. %ifnarch
11.5.8.25. %ifos
11.5.8.26. %else
11.5.8.27. %endfi
11.5.8.28. %bconf_with
11.5.8.29. %bconf_without
11.6. Commands
11.6.1. Checker (sb-check)
11.6.2. Defaults (sb-defaults)
11.6.3. Set Builder (sb-set-builder)
11.6.4. Set Builder (sb-builder)
11.7. Building and Deploying Tool Binaries
11.8. Bugs, Crashes, and Build Failures
11.8.1. Contributing
11.9. History
12. Glossary
Index
RTEMS User Manual
Docs
»
6. Board Support Packages
»
6.9. mips (MIPS)
6.9. mips (MIPS)
¶
6.9.1. csb350
¶
TODO.
6.9.2. hurricane
¶
TODO.
6.9.3. jmr3904
¶
TODO.
6.9.4. malta
¶
TODO.
6.9.5. rbtx4925
¶
TODO.
6.9.6. rbtx4938
¶
TODO.