RTEMS Legacy Network User Manual (6.17c582f).

Copyrights and License

© 2018 Marçal Comajoan Cara

© 1988, 2015 On-Line Applications Research Corporation (OAR)

This document is available under the Creative Commons Attribution-ShareAlike 4.0 International Public License.

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 https://www.rtems.org. Any inquiries concerning RTEMS, its related support components, or its documentation should be directed to the RTEMS Project community.

RTEMS Online Resources

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

• 1. Preface
• 2. Quick Start
• 3. Network Task Structure and Data Flow
• 4. Networking Driver
  • 4.1. Introduction
  • 4.2. Learn about the network device
  • 4.3. Understand the network scheduling conventions
  • 4.4. Network Driver Makefile
  • 4.5. Write the Driver Attach Function
  • 4.6. Write the Driver Start Function.
  • 4.7. Write the Driver Initialization Function.
  • 4.8. Write the Driver Transmit Task
  • 4.9. Write the Driver Receive Task
  • 4.10. Write the Driver Interrupt Handler
  • 4.11. Write the Driver IOCTL Function
  • 4.12. Write the Driver Statistic-Printing Function
• 5. Using Networking in an RTEMS Application
  • 5.1. Makefile changes
    • 5.1.1. Including the required managers
    • 5.1.2. Increasing the size of the heap
  • 5.2. System Configuration
  • 5.3. Initialization
    • 5.3.1. Additional include files
    • 5.3.2. Network Configuration
    • 5.3.3. Network device configuration
    • 5.3.4. Network initialization
  • 5.4. Application Programming Interface
    • 5.4.1. Network Statistics
    • 5.4.2. Tapping Into an Interface
    • 5.4.3. Socket Options
    • 5.4.4. Adding an IP Alias
    • 5.4.5. Adding a Default Route
    • 5.4.6. Time Synchronization Using NTP
• 6. Testing the Driver
  • 6.1. Preliminary Setup
  • 6.2. Debug Output
  • 6.3. Monitor Commands
  • 6.4. Driver basic operation
  • 6.5. BOOTP/DHCP operation
  • 6.6. Stress Tests
    • 6.6.1. Giant packets
    • 6.6.2. Resource Exhaustion
    • 6.6.3. Cable Faults
    • 6.6.4. Throughput
• 7. Network Servers
  • 7.1. RTEMS FTP Daemon
    • 7.1.1. Configuration Parameters
    • 7.1.2. Initializing FTPD (Starting the daemon)
    • 7.1.3. Using Hooks
• 8. DEC 21140 Driver
  • 8.1. DEC 21240 Driver Introduction
  • 8.2. Document Revision History
  • 8.3. DEC21140 PCI Board Generalities
  • 8.4. RTEMS Driver Software Architecture
    • 8.4.1. Initialization phase
    • 8.4.2. Memory Buffer
    • 8.4.3. Receiver Thread
    • 8.4.4. Transmitter Thread
  • 8.5. Encountered Problems
  • 8.6. Netboot DEC driver
  • 8.7. List of Ethernet cards using the DEC chip
• 9. Command and Variable Index