OpenEZ

 

A GPL Operating System and Stack for the eZ80 family of microprocessors.

 

Getting Started

 

For a compiler/assembler/linker/IDE, I chose IAR Systems’s Embedded Workbench. This is a commercial product, but I chose it over the free tools from Zilog based on the relative quality of the tools and the effect that had on my productivity.  I tried using the IDE that comes from Zilog, but I was never able to get it to successfully compile and run the OpenEZ code. At the current level of maturity, I do not recommend using the Zilog tools with OpenEZ.

 

Unfortunately, the IAR Embedded Workbench software does not work well with ZDS II’s Xtool hardware. I recommend using the FS2 development hardware.

 

Things You Will Need

  1. IAR Systems Embedded Workbench (purchased version or download the 30 free trial version)
  2. FS2’s ISA-eZ80 In-Target System Analyzer
  3. Microsoft Windows based PC workstation
  4. Perl for Windows, this is a free package.
  5. OpenEZ, click here to download the latest version

 

Installation Steps

  1. Unzip the OpenEZ package, be sure to retain the directory structure while unzipping. I use “OpenEZ” as the top level directory for this project.
  2. Adjust the settings in main.c, particularly the settings for IP address, network mask and gateway.  Note those are commas between the octets, or enable DHCP in header file: lwipopts.h..
  3. If you are changing the web pages, put your “root” pages in the directory OpenEZ\httpd\html. You can also create subdirectories under OpenEZ\httpd\html. Doing so will affect the URL used to retrieve the files. Once you have your pages set, run the perl script:  OpenEZ\httpd\html_2_asm.pl.  This script will recurse thru the html directory and all subdirectories, creating the file: OpenEZ\http\filedata.asm.  Currently supported are file types: .htm, html, gif, class, jar, jpeg, jpg, and gif.  Any other file suffix is assumed to be plain text.
  4. You can use all of the IAR tools.  For example, you can disassemble, single step, view registers. Use the file Release\List\OpenEZ.map to find memory addresses for stuff.  C-Spy gives you a powerful tool for single stepping thru code.  As shipped, UART0 (“console”) is setup with a shell @57600.  If you want to change the baud rate or use the other UART port, make those changes in main.c.  See stream.c for the meanings of the baud rate codes.
  5. Once you have the OpenEZ software running, you can interact with it thru the console port.  You can also run shells by connecting via telnet on port 23.  Default login name is: “root”, password: “openez”.  The username/password table is in login.c if you want to add more entries. Multiple telnet sessions can be running at the same time. The echo service is available on port 7.  The software should also respond to pings.  These web pages are supplied as a demo, and can be viewed through the build in HTTPD server, unless you make changes. To get a list of supported shell commands, enter “help” At the prompt.  You also may want to try out the /log ,  /dump.cgi?address=000000, dyntest.htm,  images/penguin.gif and /form.html   URLs, (these links will not work except when viewing these pages from the development board), for other examples of the features of the built in web server.

 

 

Copyright2002, Robert Laughlin

Last Update 3/7/2005 1:01:59 PM