Real-Time Library - Template Applications Real-Time The RealView® Real-Time Library is based on a real- time kernel that simplifies the design and implementation of complex, time-critical applications. It includes an efficient Flash File System, a flexible TCP/IP networking Library suite, and other essential communication drivers.

Template applications help you to get started quickly and ® The RealView Real-Time Library (RL-ARM) solves the are royalty-free when used for product development. The Deterministic real-time and communication challenges of embedded RL-ARM components let you focus on the specific ® systems based on ARM powered MCU devices. It expands Real-Time OS Kernel requirements of your application. the Microcontroller Development Kit with essential components for sophisticated microcontroller applications. Included Template Applications TCP/IP, CAN, and USB Components of the Real-Time Library: n LED Switch Client/Server uses a UDP or Communications TCP/IP connection with Ethernet, SLIP, or PPP. RL-ARM contains TCP/IP and UDP protocols along with n RTX Kernel, a royalty-free fully deterministic RTOS that standard Internet applications such as HTTP server or SMTP client. n HTTP Server with CGI Scripting supports meets hard real-time requirements. Configurable dynamic Web pages. n CAN Drivers that utilize RTX mailboxes. n Telnet Server with user authentication. n USB Device Interfaces for standard USB device Flash File System n TFTP Server supports simple file upload. classes – no system driver development is required. n n SMTP Client for automated email messages. Flash File System with a configurable interface for data Ready-to-use storage on RAM or FLASH . n DNS Resolver for IP address resolution. n TCPnet Networking Suite for network Template Applications n RTX Kernel examples that show RTOS features like mailboxes, messages, events, and timeouts. communication using standard LAN and Internet protocols. n CAN Driver implementations for various devices. n USB Interfaces for standard device driver classes The TCPnet Networking Suite includes: – requires no Windows driver development. n TCP, UDP, and ARP communication protocols. Real-Time Library n Ethernet, SLIP, and PPP interface drivers. RTOS Kernel RL-ARM Template Applications are configured for various n M Telnet Server and TFTP Server. s standard Microcontroller devices and are ready to use e n t a with Evaluation Boards. DHCP Client, DNS Resolver, NetBIOS Name Service. TcpNet Suite l n TCP, UDP, PPP, SLIP, p The RL-ARM component also enable CAN and Modem applications, as HTTP Server with CGI and SMTP Client. ARP, DNS Resolver, m For more information, refer to www.keil.com/rl-arm. Ethernet, DHCP Client, e T well as standard USB devices that avoid Windows driver development. HTTP Server with CGI,

TFTP Server, SMTP Client m a R r g o r P Europe: United States:

Flash File System &

s

Keil Keil Software, Inc. e l Bretonischer Ring 15 1501 10th Street, Suite 110 p USB Device Interface m A 85630 Grasbrunn Plano, Texas 75074 a x

Germany USA E

Phone ++49 89 / 45 60 40 - 0 Phone ++1 800 348 8051 CAN Interface - Support ++49 89 / 45 60 40 - 24 ++1 972 312 1107 FAX ++49 89 / 46 81 62 FAX ++1 972 312 1159 Information in this data sheet is subject to change without notice and does not represent a Email [email protected] Email [email protected] The Real-Time Library (RL-ARM) enriches the [email protected] [email protected] commitment on the part of Keil or ARM. feature set of innovative microcontrollers with L easy-to-use software components. RL-ARM is

All brand names or product names are the property of their respective holders. Neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except scalable and works efficiently on tiny single-chip with the prior written permission of the copyright holder. The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given in good faith. designs as well as complex systems that require All warranties implied or expressed, including but not limited to implied warranties of satisfactory quality or fitness for purpose are excluded. This document is intended only to provide information to the reader about the product. To the extent permitted by local laws ARM shall not be liable for any loss or damage arising from the use of any information in this document or any error or omission in such information. Menu driven configuration files and extensive example projects deterministic reaction to time-critical events. Program examples and detailed technical information are available from your distributor and our web site (www.keil.com). help you get started quickly. R

4 Real-Time Library KEIL RL-ARM | 10.06 www.keil.com Real-Time , CAN & USB Drivers Networking Suite and Flash File System

RTX Kernel RTX Kernel TCPnet Networking Suite Today, microcontroller applications require simultaneous TCP/IP or UDP software layers are easy to implement using Mailbox execution of multiple jobs or tasks. For such applications, Memory Delay & the RL-ARM TCPnet Networking Suite. TCPnet provides the RTX Kernel allows task management and flexible Pool Interval standard Internet protocols (TCP, UDP, ARP, DHCP) and scheduling of system resources (CPU, memory, etc.). Mutex Event & offers flexible connections (with Ethernet or UART/Modem Scheduler RTX is a full-featured real-time kernel with task priorities, interface). round-robin, preemptive context switching, and support Parameters and the functionality of the TCPnet Networking for multiple instances of the same task function. It is Suite can be tailored for your software requirements. royalty-free and is fully integrated into µVision. RTX Kernel Function Overview TCPnet supports a wide range of features from reliable TCP/IP connections to multi-language HTTP configurations. n Task Management Functions allows you to To create highly interactive applications, TCPnet includes a create and delete tasks. RTX supports 256 task file conversion utility that creates images for a ROM File TCPnet Protocol Overview priorities and multiple instances of the same task. System from HTML and graphic files. n TCP (Transmission Control Protocol) is a full- n Task Stacks are allocated from a stack memory duplex, reliable, connection-oriented protocol pool or can be supplied when a task is created. between network applications. n Fast Memory Pool Management allows you to n UDP () is a protocol for create an unlimited number of fixed size pools sending data packages (with optional checksum) while providing fully deterministic allocation times. without the overhead or reliability of TCP. The µVision Debugger includes a kernel-aware dialog that displays complete information about all the tasks in your RTX program. n Event Flag Management allows synchronization n ARP (Address Resolution Protocol) translates IP with up to 16 event flags per task. addresses to Ethernet MAC addresses. The RTX Kernel runs on the smallest embedded n Unlimited number of Mailboxes, Semaphores, n DHCP (Dynamic Host Configuration Protocol) microcontrollers. The memory requirements depend on and Mutexes are available for inter-task configures network parameters automatically. the number of tasks that run simultaneously and the synchronization and communication. n PPP (Point to Point Protocol) is used for reliable functionality used. n Time Management and Timer Callback dial-up modem connections. n ROM requirements: 3.5KB – 5KB. Functions support time delays (interval or n SLIP (Serial Line ) is a simple n RAM requirements: less than 500 bytes. Each task timeout) for tasks. Menu-driven configuration is available for all TcpNet components including the protocol for data transmission over serial lines. requires additional 52 bytes + stack space. Debug Interface. The RTX Kernel can interface to standard service routines (ISR). Task is less than 5µs; Interrupt lock-out Memory Pool Management and Mailbox functions can be used in a ISR. Flash File System time is less than 1.8µs (on NXP LPC2000 @ 60MHz). Events and Semaphores can be sent from a ISR to a task. Evaluation Hardware The Flash File System is designed to be fast, simple, and All TCPnet communication interfaces are fully configurable. efficient while allowing you to create, save, read, and CAN Driver USB Device Interface Ready-to-run template applications are available for popular modify files. Files may be stored in standard Flash ROM Evaluation Boards such as the Keil MCB2300, Keil MCBSTR9, The CAN Driver interfaces to the RTX Kernel via The USB Device Interface uses standard device driver or RAM devices (both may be used parallel). FAT file Atmel AT91SAM7X, and Phytec LPC22xx. mailboxes and memory pools and is composed of: classes that are available with all Windows PCs. No system support for SD memory cards will be available n a generic software layer that is identical across all Windows host driver development is required. The USB soon. supported microcontrollers. Device interface uses a generic software layer using RTX n a hardware-dependent software layer that implements Kernel features. Flash File System Function Overview the physical interface to the CAN peripheral. n RL-ARM includes support for the Atmel AT91SAM7, USB Device Driver Classes File I/O Functions such as fopen, fclose, fread, NXP LPC2000, and STM STR7xx/STR9xx devices. fwrite, fprintf, and ftell create and access files on the n Mass Storage Device implements a memory Flash ROM device. The CAN Driver interrupt service routines use the device that can be accessed via the file system. n File Maintenance Functions allow you to features of the RTX Kernel. This implementation reduces n Human Interface Device implements a generic rename a filename, provide access to the directory, interrupt complexity and provides high-performance TCPnet example applications device that allows all types of data I/O. and format or defragment the file system. functions that transmit and receive CAN messages. are ready-to-run on many Support for other Device Driver Classes will be available soon. standard Evaluation Boards. n System Functions are used for initialization.

2 Real-Time Library www.keil.com 3 Real-Time Operating System, CAN & USB Drivers Networking Suite and Flash File System

RTX Kernel RTX Kernel TCPnet Networking Suite TCPnet Networking Suite Today, microcontroller applications require simultaneous TCP/IP or UDP software layers are easy to implement using Mailbox HTTP Server Telnet Server SMTP Client execution of multiple jobs or tasks. For such applications, Memory Delay & the RL-ARM TCPnet Networking Suite. TCPnet provides Pool Interval the RTX Kernel allows task management and flexible standard Internet protocols (TCP, UDP, ARP, DHCP) and CGI Scripting TFTP Server DNS Resolver scheduling of system resources (CPU, memory, etc.). Mutex Event & offers flexible connections (with Ethernet or UART/Modem Scheduler Semaphore RTX is a full-featured real-time kernel with task priorities, interface). TCP UDP ARP DHCP PPP SLIP round-robin, preemptive context switching, and support Parameters and the functionality of the TCPnet Networking for multiple instances of the same task function. It is Suite can be tailored for your software requirements. Ethernet Modem UART Debug UART royalty-free and is fully integrated into µVision. RTX Kernel Function Overview TCPnet supports a wide range of features from reliable TCP/IP connections to multi-language HTTP configurations. n Task Management Functions allows you to To create highly interactive applications, TCPnet includes a create and delete tasks. RTX supports 256 task file conversion utility that creates images for a ROM File TCPnet Protocol Overview priorities and multiple instances of the same task. System from HTML and graphic files. n TCP (Transmission Control Protocol) is a full- n Task Stacks are allocated from a stack memory duplex, reliable, connection-oriented protocol pool or can be supplied when a task is created. between network applications. n Fast Memory Pool Management allows you to n UDP (User Datagram Protocol) is a protocol for create an unlimited number of fixed size pools sending data packages (with optional checksum) while providing fully deterministic allocation times. without the overhead or reliability of TCP. The µVision Debugger includes a kernel-aware dialog that displays complete information about all the tasks in your RTX program. n Event Flag Management allows synchronization n ARP (Address Resolution Protocol) translates IP with up to 16 event flags per task. addresses to Ethernet MAC addresses. The RTX Kernel runs on the smallest embedded n Unlimited number of Mailboxes, Semaphores, n DHCP (Dynamic Host Configuration Protocol) microcontrollers. The memory requirements depend on and Mutexes are available for inter-task configures network parameters automatically. the number of tasks that run simultaneously and the synchronization and communication. n PPP (Point to Point Protocol) is used for reliable functionality used. n Time Management and Timer Callback dial-up modem connections. n ROM requirements: 3.5KB – 5KB. Functions support time delays (interval or n SLIP (Serial Line Internet Protocol) is a simple n RAM requirements: less than 500 bytes. Each task timeout) for tasks. Menu-driven configuration is available for all TcpNet components including the protocol for data transmission over serial lines. requires additional 52 bytes + stack space. Debug Interface. The RTX Kernel can interface to standard interrupt service routines (ISR). Task context switch is less than 5µs; Interrupt lock-out Memory Pool Management and Mailbox functions can be used in a ISR. Flash File System time is less than 1.8µs (on NXP LPC2000 @ 60MHz). Events and Semaphores can be sent from a ISR to a task. Evaluation Hardware The Flash File System is designed to be fast, simple, and All TCPnet communication interfaces are fully configurable. efficient while allowing you to create, save, read, and CAN Driver USB Device Interface Ready-to-run template applications are available for popular modify files. Files may be stored in standard Flash ROM Evaluation Boards such as the Keil MCB2300, Keil MCBSTR9, The CAN Driver interfaces to the RTX Kernel via The USB Device Interface uses standard device driver or RAM devices (both may be used parallel). FAT file Atmel AT91SAM7X, and Phytec LPC22xx. mailboxes and memory pools and is composed of: classes that are available with all Windows PCs. No system support for SD memory cards will be available n a generic software layer that is identical across all Windows host driver development is required. The USB soon. supported microcontrollers. Device interface uses a generic software layer using RTX n a hardware-dependent software layer that implements Kernel features. Flash File System Function Overview the physical interface to the CAN peripheral. n RL-ARM includes support for the Atmel AT91SAM7, USB Device Driver Classes File I/O Functions such as fopen, fclose, fread, NXP LPC2000, and STM STR7xx/STR9xx devices. fwrite, fprintf, and ftell create and access files on the n Mass Storage Device implements a memory Flash ROM device. The CAN Driver interrupt service routines use the device that can be accessed via the file system. n File Maintenance Functions allow you to features of the RTX Kernel. This implementation reduces n Human Interface Device implements a generic rename a filename, provide access to the directory, interrupt complexity and provides high-performance TCPnet example applications device that allows all types of data I/O. and format or defragment the file system. functions that transmit and receive CAN messages. are ready-to-run on many Support for other Device Driver Classes will be available soon. standard Evaluation Boards. n System Functions are used for initialization.

2 Real-Time Library www.keil.com 3 Real-Time Library - Template Applications Real-Time The RealView® Real-Time Library is based on a real- time kernel that simplifies the design and implementation of complex, time-critical applications. It includes an efficient Flash File System, a flexible TCP/IP networking Library suite, and other essential communication drivers. LAN Template applications help you to get started quickly and ® The RealView Real-Time Library (RL-ARM) solves the are royalty-free when used for product development. The Deterministic Router real-time and communication challenges of embedded RL-ARM components let you focus on the specific ® systems based on ARM powered MCU devices. It expands Real-Time OS Kernel requirements of your application. the Microcontroller Development Kit with essential components for sophisticated microcontroller applications. Included Template Applications TCP/IP, CAN, and USB Components of the Real-Time Library: n LED Switch Client/Server uses a UDP or Internet Communications TCP/IP connection with Ethernet, SLIP, or PPP. RL-ARM contains TCP/IP and UDP protocols along with n RTX Kernel, a royalty-free fully deterministic RTOS that standard Internet applications such as HTTP server or SMTP client. n HTTP Server with CGI Scripting supports meets hard real-time requirements. Configurable dynamic Web pages. n CAN Drivers that utilize RTX mailboxes. n Telnet Server with user authentication. n USB Device Interfaces for standard USB device Flash File System n TFTP Server supports simple file upload. classes – no system driver development is required. n n SMTP Client for automated email messages. Flash File System with a configurable interface for data Ready-to-use storage on RAM or FLASH . n DNS Resolver for IP address resolution. USB n TCPnet Networking Suite for network Template Applications n RTX Kernel examples that show RTOS features like mailboxes, messages, events, and timeouts. Internet communication using standard LAN and Internet protocols. n CAN Driver implementations for various devices. n USB Interfaces for standard device driver classes The TCPnet Networking Suite includes: – requires no Windows driver development. n TCP, UDP, and ARP communication protocols. Real-Time Library RS232 n Ethernet, SLIP, and PPP interface drivers. RTOS Kernel CAN PPP/SLIP RL-ARM Template Applications are configured for various n M Telnet Server and TFTP Server. s standard Microcontroller devices and are ready to use e n t a with Evaluation Boards. GPRS/GSM DHCP Client, DNS Resolver, NetBIOS Name Service. TcpNet Suite l n TCP, UDP, PPP, SLIP, p The RL-ARM component also enable CAN and Modem applications, as HTTP Server with CGI and SMTP Client. ARP, DNS Resolver, m For more information, refer to www.keil.com/rl-arm. Ethernet, DHCP Client, e T well as standard USB devices that avoid Windows driver development. HTTP Server with CGI,

TFTP Server, SMTP Client m a R r g o r P Europe: United States:

Flash File System &

s

Keil Keil e l Bretonischer Ring 15 1501 10th Street, Suite 110 p USB Device Interface m A 85630 Grasbrunn Plano, Texas 75074 a x

Germany USA E

Phone ++49 89 / 45 60 40 - 0 Phone ++1 800 348 8051 CAN Interface - Support ++49 89 / 45 60 40 - 24 ++1 972 312 1107 FAX ++49 89 / 46 81 62 FAX ++1 972 312 1159 Information in this data sheet is subject to change without notice and does not represent a Email [email protected] Email [email protected] The Real-Time Library (RL-ARM) enriches the [email protected] [email protected] commitment on the part of Keil or ARM. feature set of innovative microcontrollers with L easy-to-use software components. RL-ARM is

All brand names or product names are the property of their respective holders. Neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except scalable and works efficiently on tiny single-chip with the prior written permission of the copyright holder. The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given in good faith. designs as well as complex systems that require All warranties implied or expressed, including but not limited to implied warranties of satisfactory quality or fitness for purpose are excluded. This document is intended only to provide information to the reader about the product. To the extent permitted by local laws ARM shall not be liable for any loss or damage arising from the use of any information in this document or any error or omission in such information. Menu driven configuration files and extensive example projects deterministic reaction to time-critical events. Program examples and detailed technical information are available from your distributor and our web site (www.keil.com). help you get started quickly. R

4 Real-Time Library KEIL RL-ARM | 10.06 www.keil.com