*******************************************************************************
** Copyright © 2008, Xilinx, Inc. 
** This design is confidential and proprietary of Xilinx, Inc. All Rights Reserved.
*******************************************************************************
**   ____  ____ 
**  /   /\/   / 
** /___/  \  /   Vendor: Xilinx 
** \   \   \/    Version: 1.0
**  \   \        Filename: ps2_scancodes_polled_readme.txt 
**  /   /         
** /___/   /\     
** \   \  /  \ 
**  \___\/\___\ 
** 
**Device: 
**Purpose:
**Reference: 
**   
*******************************************************************************
**
**  Disclaimer: LIMITED WARRANTY AND DISCLAIMER. These designs are
**              provided to you "as is." Xilinx and its licensors make and you
**              receive no warranties or conditions, express, implied,
**              statutory or otherwise, and Xilinx specifically disclaims any
**              implied warranties of merchantability, noninfringement, or
**              fitness for a particular purpose. Xilinx does not warrant that
**              the functions contained in these designs will meet your
**              requirements, or that the operation of these designs will be
**              uninterrupted or error free, or that defects in the Designs
**              will be corrected. Furthermore, Xilinx does not warrant or
**              make any representations regarding use or the results of the
**              use of the designs in terms of correctness, accuracy,
**              reliability, or otherwise.
**
**              LIMITATION OF LIABILITY. In no event will Xilinx or its
**              licensors be liable for any loss of data, lost profits, cost
**              or procurement of substitute goods or services, or for any
**              special, incidental, consequential, or indirect damages
**              arising from the use or operation of the designs or
**              accompanying documentation, however caused and on any theory
**              of liability. This limitation will apply even if Xilinx
**              has been advised of the possibility of such damage. This
**              limitation shall apply notwithstanding the failure of the
**              essential purpose of any limited remedies herein.
**
*******************************************************************************

Application:  ps2_scancodes_polled
----------------------------------
After connecting a PS/2 keyboard to the ML507 and running this application, the
scancodes associated with each key press are displayed.  The user can select
which PS/2 input port to use through a simple definition change as described in
the output sent to the serial port.
 
   CONFIG Switch Settings:  00010101 

1. Connect the Host PC to the ML507 (J1 header) using a PC-IV or
   Platform USB JTAG cable

2. Connect the Host PC serial port to the ML507 serial port using a null
   modem cable and launch a terminal program on the Host (eg. TeraTerm)
   with the settings: 9600 baud, 8-N-1, No flow control

3. Connect a PS/2 keyboard to the ML507 PS/2 keyboard input port

4. Launch and open the ML507 EDK project (ml507_bsb_system.xmp)

5. Launch a Shell window using XPS menu selection: Project > Launch EDK Shell

6. Download bitstream in shell window by typing: impact -batch etc/download.cmd

7. XPS menu selection: Debug > Launch XMD

8. At XMD% prompt type: cd microblaze_0/code

9. At XMD% prompt type: rst

10. At XMD% prompt type: dow ps2_scancodes_polled.elf

11. At XMD% prompt type: con

12. Press any key and observe the returned scancode.  The output below shows
    the results of pressing the 'a' key one time. 


Serial Port Output:
-------------------
PS/2 Demo using polled mode
Depending on which port you would like to test,
Port 0: Uncomment "#define USE_PS2_0
Port 1: Comment   "#define USE_PS2_0"
and recompile the source code.

Echoing PS/2 scancodes from a PS/2 input device connected to PS/2 port 1 (Keyboa
rd):
1C
F0
1C