Home > Resources > Application Notes
Embecosm application notes give tutorial case studies on key software technology.
These are made freely available under a Creative Commons Attribution License. Which means that you are free to copy, distribute, make derivative works and commercial use of them. All we ask is that you give credit. For further information see the license details.
They can be read online or downloaded as a PDF or HTML archive. The DocBook XML source can be found on GitHub.
This application note describes by example how to build a simple SoC, capable of running a modern Linux kernel, using OSCI TLM 2.0 convenience sockets.
Issue 2 has been updated to use the latest patch release, 2.0.1 of the OSCI TLM environment. It adds a new chapter on transactional modeling of the IEEE 1149.1 JTAG debug interface.
This application note describes how to install the OpenRISC 1000 architectural simulator, associated tool chain and Linux 2.6 kernel. This open source architecture, simulator and tool set is used as a case study in Embecosm application notes.
The tool versions covered are GNU binutils 2.16.1, GNU C Compiler 3.4.4, GNU Debugger 6.8 (with RSP support), Linux Kernel 2.6.23, uClibc 0.9.28.3 and Or1ksim 0.3.0rc2.
This application note is aimed at engineers porting GDB to a new architecture for the first time.
The GNU Debugger software distribution includes a guide for users and a 100-page guide to its internals. The latter is a document primarily aimed at those wishing to become developers of new functionality in GDB, rather than engineers wishing to port the existing functionality to a new architecture. Whilst an admirable document, it is not the place to find the "big picture" about how GDB works, is far from complete and in many places out of date.
This application note fills the gap between the user guide and the GDB internals document for engineers porting GDB to a new architecture. It is based on the author's experience porting GDB 6.8 to the OpenRISC 1000 architecture, and includes practical examples from that work.
This application note is aimed at engineers writing a GDB Remote Serial Protocol Server for the first time.
The GNU Debugger software distribution includes a User Guide which documents the GDB Remote Serial Protocol for communicating with remote targets. The distribution also includes "stub" code for use by those implementing their own RSP server.
This application note provides practical advice to supplement the GDB User Guide for engineers writing a GDB RSP server. It is based on the author's experience implementing the first RSP server to support GDB 6.8 on the OpenRISC 1000 architecture, and includes practical examples from that work.
This application note is aimed at engineers needing to interface SystemC to cycle accurate models of devices implementing the IEEE 1149.1 JTAG interface.
Cycle accurate models of devices in SystemC may be written by hand. More commonly they are generated automatically by tools such as Verilator, ARC VTOC and Carbon Design Systems ModelStudio. They may also be implemented using SystemC interfaces to traditional event driven simulation.
Directly interfacing to the JTAG cycle accurate ports of a SystemC model is a complex task, requiring careful modeling of the JTAG Test Access Port (TAP) state machine.
This application note specifies a more abstract interface, allowing the user to simply read and write hardware registers through JTAG. The interface takes responsibility for ensuring the correct sequence of signals is sent through the TAP to achieve the desired action.
The application note and its associated reference implementation provide a practical tool for engineers involved in the detailed design, verification and modeling of complex FPGAs and ASICs.
This application note is a tutorial in building high performance SystemC cycle accurate models from Verilog RTL.
Typical uses are:
Embecosm are also able to present the content of this tutorial as a two day seminar. Please contact us for more details.
This application note demonstrates how to integrate the GNU Debugger with SystemC cycle accurate models. It builds on the techniques described in EAN 5, Using JTAG with SystemC and EAN 6, High Performance SoC Modeling with Verilator.
The result is a GDB Server that makes firmware development and debugging on the cycle accurate model highly productive. Typical uses are:
The tutorial demonstrates the techniques using the OpenRISC Reference Platform System-on-Chip (ORPSoC), a 32-bit SoC. Full GDB debugging functionality is provided with a cycle accurate model running at nearly 100kHz.
Embecosm are also able to present the content of this tutorial as a three day seminar. Please contact us for more details.
DejaGnu is the testing framework for the GNU project. It is a powerful system for setting up automated test environments that are highly portable. However the documentation of this technology can prove daunting for the first time user.
This application note was written in response to the author's frustration when setting up a DejaGnu test framework without any prior experience. It provides a simple guide for any engineer setting up such an environment for the first time.
Robust testing is central to all Embecosm's work. We are able to present the content of this tutorial as a one day seminar. We can also offer consultancy to help users set up their own test environments. Please contact us for more details.
Newlib is a C library intended for use on embedded systems. It is a collection of several library parts, all under free software licenses that make them easily usable on embedded products. It is also commonly used when testing GNU tool chains.
Embecosm has worked with a number of customers to port Newlib to embedded targets. This application note shares some of our expertise for those who wish to explore Newlib for themselves. The examples are all based on the version of Newlib 1.18.0 for the OpenRISC 1000 architecture.
Library implementation is one aspect of Embecosm's consultancy in open source software development. We reply on robust libraries for reliable tool validation. Please contact us, to learn more about our services in this area.
The LLVM integrated assembler is an alternative to using a standalone assembler with the LLVM compiler. It uses the data from TableGen to translate from symbolic assembler to binary instructions, which are emitted as an ELF file.
This is the first in a series of application notes on LLVM development written by Simon Cook of Embecosm. It shares some of our expertise for those who wish to develop their own LLVM assembler The examples are all based on the implementation of the LLVM assembler for the OpenRISC 1000 architecture.
LLVM development is one aspect of Embecosm's consultancy in open source software development. We provide production quality open source compiler development, essential to any high quality software development tool chain. Please contact us, to learn more about our services in this area.
This application note describes the process of migrating CVS modules to Git repositories, and is aimed at developers or administrators who wish to migrate repositories on either a one time or continual basis.
Using the Sourceware repository for GNU tool chain components as an example throughout, the application note draws on the author's experience in building a script for the conversion of many CVS modules from this repository.
