Library provided by Embedded Systems Academy, Copyright 2000
Visit www.esacademy.com/faq/progs for examples and libraries.


This library: PCORE_IO2 - name of application: pcore_io2_Example
================================================================
Phytec phyCORE 8051 and XA I/O Library


Hardware requirements
=====================
Phytec RDK 591 with Philips 591
or Phytec RDK XAC3 with Philips XA-C3


Software requirements
=====================
Phytec Flash Tools (part of RDKs)
  www.phytec.com
Raisonance 8051 Compiler System - EVAL version sufficient
  www.raisonance.com
or Raisonance XA Compiler System - EVAL version sufficient
  www.raisonance.com
or Keil 8051 Compiler System - EVAL version sufficient
  www.keil.com
Optional: Development Assistant-C by RistanCASE
  www.ristancase.ch


Tested using
============

Keil C51 v6.02
Raisonance RC51 v3.03.0C
Raisonance RCXA v2.05.0B


Application description
=======================
Raisonance specific files have their names prefixed with 'r'.
Keil specific files have their names prefixed with 'k'.
The same source files are used for both compilers.

The purpose of this library is to provide a common interface 
to the I/O on the Development Board regardless of whether an 
8051 or XA phyCORE module is being used, and regardless of the 
whether the XA is executing code in page 0 mode or non page 0
mode. This aids in migrating projects from the 8051 to the XA 
as this library may be used with both.

The package includes the library, a C header file, a manual in 
PDF format and an example project for both the Raisonance and 
Keil 8051 Compilers and the Raisonance XA Compiler.

The following functions are implemented in the library:

  void init_uart(void);
  unsigned char check_button (unsigned char Sx);
  void switch_leds (unsigned char on_off);
  void init_timer0_dim_d1 (void);
  void set_brightness_d1 (unsigned char value);
  void init_pcore_io2(void);
  unsigned char read_dip_switches (void);
  unsigned char read_poti (void);
  void error_state (unsigned char error);
  void init_timer1 (unsigned int reload);
  void lcd_writeinstruction(unsigned char instr);
  char lcd_putchar(char c);
  void init_lcd(unsigned char cursortype);
  void lcd_putcursor(unsigned char x, unsigned char y);
  void lcd_definecharacter(unsigned char c, const unsigned char *rows);