RTEMS BSP and Driver Guide (5.0.0 (master)).

COPYRIGHT (c) 1988 - 2015.

On-Line Applications Research Corporation (OAR).

COPYRIGHT (c) 2016-2018.

RTEMS Foundation, The RTEMS Documentation Project

Licenses:

Creative Commons Attribution-ShareAlike 4.0 International Public License

https://creativecommons.org/licenses/by-sa/4.0/legalcode

The authors have used their best efforts in preparing this material. These efforts include the development, research, and testing of the theories and programs to determine their effectiveness. No warranty of any kind, expressed or implied, with regard to the software or the material contained in this document is provided. No liability arising out of the application or use of any product described in this document is assumed. The authors reserve the right to revise this material and to make changes from time to time in the content hereof without obligation to notify anyone of such revision or changes.

The RTEMS Project is hosted at http://www.rtems.org/. Any inquiries concerning RTEMS, its related support components, or its documentation should be directed to the Community Project hosted at http://www.rtems.org/.

RTEMS Online Resources

Home	https://www.rtems.org/
Developers	https://devel.rtems.org/
Documentation	https://docs.rtems.org/
Bug Reporting	https://devel.rtems.org/query
Mailing Lists	https://lists.rtems.org/
Git Repositories	https://git.rtems.org/

• 1. Introduction
• 2. Target Dependent Files
  • 2.1. CPU Dependent
  • 2.2. Board Dependent
  • 2.3. Peripheral Dependent
  • 2.4. Questions to Ask
  • 2.5. CPU Dependent Executive Files
  • 2.6. Board Support Package Structure
• 3. Linker Script
  • 3.1. What is a “linkcmds” file?
  • 3.2. Program Sections
  • 3.3. Image of an Executable
  • 3.4. Example Linker Command Script
  • 3.5. Initialized Data
• 4. Miscellaneous Support Files
  • 4.1. GCC Compiler Specifications File
  • 4.2. README Files
  • 4.3. Times
  • 4.4. Tools Subdirectory
  • 4.5. bsp.h Include File
  • 4.6. tm27.h Include File
  • 4.7. sbrk() Implementation
  • 4.8. bsp_fatal_extension() - Cleanup the Hardware
  • 4.9. Configuration Macros
  • 4.10. set_vector() - Install an Interrupt Vector
  • 4.11. Interrupt Delay Profiling
  • 4.12. Programmable Interrupt Controller API
• 5. Initialization Code
  • 5.1. Introduction
  • 5.2. Required Global Variables
  • 5.3. Board Initialization
    • 5.3.1. Start Code - Assembly Language Initialization
    • 5.3.2. boot_card() - Boot the Card
    • 5.3.3. bsp_work_area_initialize() - BSP Specific Work Area Initialization
    • 5.3.4. bsp_start() - BSP Specific Initialization
    • 5.3.5. Device Driver Initialization
  • 5.4. The Interrupt Vector Table
    • 5.4.1. Interrupt Vector Table on the gen68340 BSP
  • 5.5. Chip Select Initialization
  • 5.6. Integrated Processor Registers Initialization
  • 5.7. Data Section Recopy
  • 5.8. The RTEMS Configuration Table
• 6. Console Driver
  • 6.1. Introduction
  • 6.2. Build System and Files
  • 6.3. Driver Functioning Modes
  • 6.4. Polled Mode
  • 6.5. Interrupt Driven Mode
  • 6.6. First Open
  • 6.7. Last Close
  • 6.8. Set Attributes
  • 6.9. IO Control
  • 6.10. Flow Control
  • 6.11. General Initialization
• 7. Clock Driver
  • 7.1. Introduction
  • 7.2. Initialization
    • 7.2.1. Timecounter Variant
    • 7.2.2. Simple Timecounter Variant
    • 7.2.3. Clock Tick Only Variant
  • 7.3. Install Clock Tick Interrupt Service Routine
  • 7.4. Support At Tick
  • 7.5. System Shutdown Support
  • 7.6. SMP Support
  • 7.7. Multiple Clock Driver Ticks Per Clock Tick
  • 7.8. Clock Driver Ticks Counter
• 8. Entropy Source
• 9. I2C Driver
• 10. SPI Driver
• 11. Real-Time Clock Driver
  • 11.1. Introduction
  • 11.2. Initialization
  • 11.3. setRealTimeToRTEMS
  • 11.4. setRealTimeFromRTEMS
  • 11.5. getRealTime
  • 11.6. setRealTime
  • 11.7. checkRealTime
• 12. Networking Driver
  • 12.1. Introduction
  • 12.2. Learn about the network device
  • 12.3. Understand the network scheduling conventions
  • 12.4. Network Driver Makefile
  • 12.5. Write the Driver Attach Function
  • 12.6. Write the Driver Start Function.
  • 12.7. Write the Driver Initialization Function.
  • 12.8. Write the Driver Transmit Task
  • 12.9. Write the Driver Receive Task
  • 12.10. Write the Driver Interrupt Handler
  • 12.11. Write the Driver IOCTL Function
  • 12.12. Write the Driver Statistic-Printing Function
• 13. Frame Buffer Driver
  • 13.1. Introduction
  • 13.2. Driver Function Overview
    • 13.2.1. Initialization
    • 13.2.2. Opening the Frame Buffer Device
    • 13.2.3. Closing the Frame Buffer Device
    • 13.2.4. Reading from the Frame Buffer Device
    • 13.2.5. Writing to the Frame Buffer Device
    • 13.2.6. Frame Buffer IO Control
• 14. Ada95 Interrupt Support
  • 14.1. Introduction
  • 14.2. Mapping Interrupts to POSIX Signals
  • 14.3. Example Ada95 Interrupt Program
  • 14.4. Version Requirements
• 15. Shared Memory Support Driver
  • 15.1. Shared Memory Configuration Table
  • 15.2. Primitives
    • 15.2.1. Convert Address
    • 15.2.2. Get Configuration
    • 15.2.3. Locking Primitives
      • 15.2.3.1. Initializing a Shared Lock
      • 15.2.3.2. Acquiring a Shared Lock
      • 15.2.3.3. Releasing a Shared Lock
  • 15.3. Installing the MPCI ISR
• 16. Timer Driver
  • 16.1. Benchmark Timer
    • 16.1.1. benchmark_timer_initialize
    • 16.1.2. Read_timer
    • 16.1.3. benchmark_timer_disable_subtracting_average_overhead
  • 16.2. gen68340 UART FIFO Full Mode
• 17. ATA Driver
  • 17.1. Terms
  • 17.2. Introduction
  • 17.3. Initialization
  • 17.4. ATA Driver Architecture
    • 17.4.1. ATA Driver Main Internal Data Structures
    • 17.4.2. Brief ATA Driver Core Overview
• 18. IDE Controller Driver
  • 18.1. Introduction
  • 18.2. Initialization
  • 18.3. Read IDE Controller Register
  • 18.4. Write IDE Controller Register
  • 18.5. Read Data Block Through IDE Controller Data Register
  • 18.6. Write Data Block Through IDE Controller Data Register
• 19. Command and Variable Index

• Index