From 0ad5d9f85df8f688774ab7491b237d8a9b2e7a2f Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Thu, 31 Jul 2014 08:18:07 -0600 Subject: [PATCH] Add short document for running the NxWM demo --- configs/sama5d4-ek/README.txt | 18 ++++- configs/sama5d4-ek/RunningNxWM.txt | 121 +++++++++++++++++++++++++++++ 2 files changed, 135 insertions(+), 4 deletions(-) create mode 100644 configs/sama5d4-ek/RunningNxWM.txt diff --git a/configs/sama5d4-ek/README.txt b/configs/sama5d4-ek/README.txt index 4a14fd1fd9..8189167f9d 100644 --- a/configs/sama5d4-ek/README.txt +++ b/configs/sama5d4-ek/README.txt @@ -4140,10 +4140,17 @@ Configurations new one, you should see the .WAV files on the SD card in the lis box. - Currently the list box is not scollable. So you will be limited to - the number .WAV files that will fit in the existing list box (a - scrollable list box class exists, but has not been integrated into - the media play demo). + Things still to do: + + a. Currently the list box is not scrollable. So you will be + limited to the number .WAV files that will fit in the existing + list box (a scrollable list box class exists, but has not been + integrated into the media play demo). + + b. Although the lower level NxPlayer does support them, there are + no controls at the GUI for balance or tone/equalization. + + c. There is no visual indication of play status or end of playing. STATUS: See the To-Do list below @@ -4259,3 +4266,6 @@ To-Do List for the PWM and the Timer/Counter drivers. These drivers use the BOARD_MCK_FREQUENCY definition in more complex ways and will require some minor redesign and re-testing before they can be available. + +5) Board-related I2C issues have prevented integration of the WM8904 audio + decoder. So the NxWM Media Player demo cannot produce sounds. diff --git a/configs/sama5d4-ek/RunningNxWM.txt b/configs/sama5d4-ek/RunningNxWM.txt new file mode 100644 index 0000000000..c5b19b6407 --- /dev/null +++ b/configs/sama5d4-ek/RunningNxWM.txt @@ -0,0 +1,121 @@ +Simplified instructions for Running the NxWM Demo: + +Prequisites: +=========== + +1. SAMA5D4-MB Rev. C board and power supply +2. TM7000 LCD panel +3. RS-232 NUL modem cable +4. Ethernet cross-over cable +5. USB "Boot" Keyboard +6. One each of a microSD card and a full size SD card. These should + be older style SD or SDHC cards. Some of the newest very high + capacity cards will not work. +7. The file dramboot.bin which is the NuttX boot program. It runs + from SRAM and will load the NuttX HEX binary from serial into + DRAM. +8. The NuttX HEX binary, nuttx.hex. + +References: +========== + +See the README.txt for much more detailed, technical information. + +Setup: +===== + +1. Make sure that the you a terminal like TeraTerm connected to the DB-9 + and configured to work at 11520 8N1. + +2. You should also connect a USB keyboard and the TM7000 LCD to the + SAMA5D4-MB Rev C. Note only USB "Boot" keyboards are supported. + +3. The binary has networking enabled. The network is configured to + work in my test environment so it does not use DHCP, rather the board + uses the fixed IP address of 10.0.0.2. It expects the host PC to + have the address 10.0.0.1. + + For testing, usually use a PC with two networks (one configured at + 115200 8N1) and an Ethernet crossover cable. + +4. A full size SD card with some sample .WAV files may be inserted in + HSMCI0 slot. These files will be accessed by the Media Player demo. + +If you do not connect a network to the board, the consequence will be an +extremely slow start up time. Ideally, network bring-up should occur on +a separate thread so that it does not interfere with the main application. +If you have the network connected, the start up will be quick. If there +is no network connected, it could take a long time to start (perhaps a +minute?). The delay is the time before the Ethernet driver decides to +fail the attempt to negotiate the link speed. + +Starting the Demo: +================= + +1. Copy dramboot.bin to a microSD card as boot.bin + +2. Inserted the microSD card in the HSMCI1 slot. + +3. Power cycle the board, you should see: + + RomBOOT + Send Intel HEX file now + +4. Send the NuttX file from the terminal. If you use TeraTerm, this is in + the "Files" menu as "Send file ..." + +5. When the file download completes, NuttX will start. + +Running the Demo: +================ + +When NuttX first starts, you will need to perform a touchscreen calibration: + +1. Touch the circular when you see the "Touch" or "Again" messages. + +2. Release the touch when you see the "OK" message. + +There are four points to be touched and the software will expect you to +touch each position twice. + +There is a NuttX configuration option that will allow you to save this +calibration file to FLASH or a file, but that option is not enabled in +this configuration. As you result, you have to do this calibration on +each boot. + +After that the Demo will start. The opening screen will show a taskbar +and tray to the left and the background with the NuttX logo. + +Touching the triange button in the taskbar will bring up the Start Window. +The start window holds icons for each installed application. For this demo +the following icons will be visible: + +1. Scales: This will perform touchscreen calibration again. + +2. NxConsole. This is will bring up a graphics terminal running the + NuttShell (NSH). You interact with NSH using the attached USB + keyboard. + +3. Calculator. A simple HEX calculator + +4. Media Player. This brings up the media player GUI. There is a list + box that shows all of the .WAV fails from the SD card that are available. + Touching the file name selects it. There are also controls to play, + pause, fast forward, rewind, and adjust the volume. + + Unfortunately in this version, the WM8904 audio CODEC is stubbed out so + you will not actually be able to heard any of the .WAV files that you + +Telnet access: +============== + +For better access to NSH, you can also Telnet to the target at address 10.0.0.2 + + + + + + + + +