IPC@CHIP® RTOS-PPC – API Documentation
The name @CHIP-RTOS-PPC is used as the term for the operating system of the IPC@CHIP® SC2x3. The @CHIP-RTOS-PPC is a further development of the proven @CHIP-RTOS for IPC@CHIP® SC1x, SC2x and SC1x3 computers. The @CHIP-RTOS-PPC makes use of the PowerPC (PPC) processor MMU to protect against illegal memory accesses. For an overview of the provided features and the general architecture of the operating system see the @CHIP-RTOS-PPC architecture.
The operating system is preinstalled on the IPC@CHIP®. It is able to execute multiple application programs simultaneous. Each program is a discrete executable that can be transfered to the file system of the IPC@CHIP® over FTP. Each program runs as a task of the RTOS kernel. Within each application program additional tasks can be created. Beyond the normal RTOS services, like mananging task and using semaphores, etc., the operating system provides a complete TCP/IP stack and integrated servers, like SSH, Telnet, FTP(S) and HTTP(S).
Beck offers a development environment for C/C++ programming, the so-called ONE-Workbench. This documentation describes the Application Programming Interface (API), the system configuration over the CHIP.INI file and the available shell commands of the @CHIP-RTOS-PPC. It should be used as a reference manual for IPC@CHIP® SC2x3 application programmers. For a better understanding of this manual the reader should have some experience in programming embedded applications.
The document explains in detail how to call every provided function of the @CHIP-RTOS-PPC from user application programs. The API of the @CHIP-RTOS-PPC is structured into different sections (e.g. RTOS API, TCP/IP API, etc.). The processor hardware resources like CAN, SPI, I2C, GPIOs, Timers, etc. are also covered by API functions, so the application programmer has not to deal with processor register values. All API sections are listed as HTML-links on the main index page of this document.
The API is integrated as a C-Library (CLIB) into the ONE-Workbench development environment. The C-Library provides an efficient interface to the set of underlying @CHIP-RTOS-PPC system call services. A collection of example programs is also provided, which demonstrate the usage of the API.
You will find some useful general notes about programming @CHIP-RTOS-PPC applications for the IPC@CHIP® under Programming.
For some necessary knowledge about hardware details of the IPC@CHIP®, see the hardware manuals available from the download area of www.beck-ipc.com.