Automatisierung und Mikrosysteme
eCos H8S

 eCos H8S

Introduction

One result of a diploma thesis and an evaluation process for realtime operating systems is a port of the free open source RTOS eCos (Embedded Configurable Operating System) for the Renesas H8S processor architecture. This port is based on the H8300 port of Yoshinori Sato but is almost completely rewritten and optimized for H8S architecture. This port includes a number of variant ports of eCos for the microcontrollers H8S2357, H8S2674 and H8S2638 and platform ports for the EDOKS2674 board, the EDK2638EX board and the cetoni MCU2357 board.

cetoni contributes this port to the open source community for further development but does not offer any support for this software.


eCos Port for H8S

The eCos port and all drivers are available here for download. The port and drivers a provided without any support:

Download: H8S ports + drivers
Filesize: 4.52 MByte
Date: 2006-10-08

The eCos H8S port includes the following:

eCos for Renesas EDOSK2674

This is a eCos port for the Evaluation Design OS Kit for the Renesas H8S2674 microcontroller. This port supports all features of the EDOSK2674 board. Precompiled Redboot images with network support are part of this download. The EDOSK2674 platform port features the following drivers:

  1. H8S architecture HAL
  2. Variant support for microcontroller H8S2674
  3. Platform support for EDOSK2674
  4. Serial driver
  5. Network driver
  6. Realtime clock driver
  7. Watchdog driver
  8. FLASH driver

eCos for extend EDK2638

This is the platform port for the Renesas Evaluation Design Kit for Renesas H8S2638 microcontroller. The port was done for an extended version with additional SRAM and a LM629 motion controller. The port includes the following drivers:

  1. Variant support for microcontroller H8S2638
  2. Platform support for EDK2638EX
  3. Watchdog driver

eCos for cetoni MCU2357

This is the platform port for the cetoni microcontroller unit with H8S2357 microcontroller. The port contains precompiled Redboot images. A detailed decription of the porting process to this platform is part of the eCos H8S documentation and reference manual.

  1. Variant support for microcontroller H8S2638
  2. Platform support for EDK2638EX
  3. Watchdog driver


Precompiled h8300-elf Toolchain

If Windows + Cygwin is your development environment for eCos, then you can download a precompiled GNUH8 toolchain for Cygwin here.

GNUH8 v0401 is based on the gcc-3.3 branch snapshot dated 15th December 2003, binutils-2.14 and newlib sources as on 16th December 2003. GDBH8 v0401 is based on gdb-6.0 snapshot as on 31st December, 2003.

The Cygwin build is based on the sourcecode for GNUH8 provided by KPIT. Additional patches have been applied in order to enable 64 bit double support - this is required for building eCos math libraries. An additional compiler switch -mecos was added by cetoni. This switch is required in order to force a 4 byte alignment of char arrays - this is requires by eCos in order to work properly.

If the Cygwin toolchain does not work - this is possible if you have a newer Cygwin version - then you have to build the toolchain from sourcecode provided by KPIT.

IMPORTANT: If you would like to build a working eCos you have to use the toolchain provided here. It is not possible to build eCos with other toolchains or with the native KPIT toolchain because eCos requires 4 Byte array alignment and 64 Bit double support. The compiler switch -mecos is only available for the toolchain provided on this page.

You can debug sourcecode compiled with v401 toolchain only with the v401 version of the GDB debugger. For Windows debugging with Insight you should use the native Windows or Linux version provided by KPIT.

Download: Precompiled GNUH8 v0401 Cygwin Tool Chain (ELF) + GDB
Filesize: 29.76 MByte
Date: 2006-10-08

The following patch provides 64 bit double support and compiler switch -mecos for 4 byte array alignment for h8300-elf toolchain

IMPORTANT: If you would like to have a toolchain for Windows (not Cygwin) or Linux you have to download the sourcecode for v401 toolchain from KPIT and apply the patch provided down on this page.

Download: Patch for KPIT v0401 toolchain
Filesize: 12 KByte
Date: 2006-10-08

User Manual and Reference

This document contains installation manual, complete description of all configuration options (including drivers), realtime characterization, complete porting guide (variant and platform port) to new platform with Renesas H8S/2357 microcontroller. It further contains chapters about eCos application development, setting up a Windows development environment for eCos and debugging with Insight.

Download: eCos for H8S User Manual
Filesize: 876 KByte
Date: 2006-10-08


Source Documentation

Complete doxygen generated documentation of HAL part of the EDOSK-2674 port. This includes even function call graphs. Maybe this will help to speed up the development process for new variants and platforms. You can download the documentation or browse it online.

Download: Source Documentation
Filesize: 320 KByte
Date: 2006-10-08



Test Protocol

The eCos repository provides test suites for various packages. It includes test suites for kernel, various device drivers, services and I/O Subsystem. For the EDOSK-2674 eCos port a lot of tests where executed in order to check/prove its functionality and stability. The protocol of the executed tests is available here. It shows that the port, watchdog driver, wallclock driver and serial driver work and that they are quite stable now. It also shows that the libc and libm libraries work (so the toolchain works very well for eCos now).

The eCos library and all test cases where built with the new patched v401 toolchain. Most of the tests where executed with assertions and stack checking enabled in order to catch alignment, stack overflow or any other assertion failures - no such errors occurred. So there are no alignment problems anymore with the new toolchain and compiler switch -mecos.

Read online: EDOSK2674-Test Protocol
Date: 2006-10-08



Timing

Basic Timing
This is the result of tm_basic test. This test was build with optimization level 2 and assertions disabled.

Download: Basic EDOSK eCos timing
Date: 2006-10-08


Dhrystones
his is the result of dhrystone test. This test was build with optimization level 2 and assertions disabled.

Download: Dhrystones
Date: 2006-10-08
Copyright © 2009 - cetoni GmbH.   All rights reserved.   www.cetoni.de