*******************************************************************************
** Copyright © 2008, Xilinx, Inc. 
** This design is confidential and proprietary of Xilinx, Inc. All Rights Reserved.
*******************************************************************************
**   ____  ____ 
**  /   /\/   / 
** /___/  \  /   Vendor: Xilinx 
** \   \   \/    Version: 1.0
**  \   \        Filename: piezo_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:  piezo
-------------------
A user selected melody is played through the onboard piezo speaker.  The
MicroBlaze processing system retrieves and interprets a Ringing Tones Text
Transfer Language (RTTTL) file from the CF card to generate the ring tones.

   CONFIG Switch Settings:  00010101 

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

2. Connect the Host PC serial port to the ML506 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. Insert the production ML506 CF card and power-up the board 

4. Launch and open the ML506 EDK project (ml506_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 piezo.elf

11. At XMD% prompt type: con

12. After picking a ringtone, the ML506 will play the selected melody over the
    onboard piezo speaker


Serial Port Output:
-------------------
This program attempts to access the CF card's file system
Please insert a CF card with folder 'ringtones', which contains RTTTL ringtone fi
les:
a:\ringtone\5thSym.txt
a:\ringtone\OdeToJoy.txt
a:\ringtone\MozartE.txt
a:\ringtone\MozartR.txt
a:\ringtone\BachMin.txt
a:\ringtone\Enter.txt
a:\ringtone\User.txt

Press any key to continue after CF is inserted.



**********   Pick a Ringtone   **********

1. Beethoven - 5th Symphony
2. Beethoven - Ode to Joy
3. Mozart    - Eine Kleine Nachtmusik
4. Mozart    - Rondo Alla Turca
5. Bach      - Minuet
6. Joplin    - Entertainer
7. User      - From file 'User.txt'
8. User      - Type in your ringtone