MCUXpresso_LPC55S69/boards/lpcxpresso55s69/audio_examples/maestro_playback/cm33_core0/readme.txt

97 lines
3.3 KiB
Plaintext

Overview
========
The maestro_demo application demonstrates audio processing on the ARM cortex core
utilizing the Maestro Audio Framework library.
Depending on target platform there are different features of the demo enabled.
- file decoding and playback
- EAP effects during file playback
The application is controlled by commands from a shell interface using serial console.
Type "help" to see the command list. Similar description will be displayed on serial console:
>> help
"help": List all the registered commands
"exit": Exit program
"version": Display component versions
"file": Perform audio file decode and playback
USAGE: file [start|stop|pause|update|track|list|info]
start Play default (first found) or specified audio track file.
stop Stops actual playback.
pause Pause actual track or resume if already paused.
update=<preset> Apply current EAP parameters without attribute value
or switch to preset 1-10
set=<preset> Apply current EAP parameters without attribute value
or switch to preset 1-10
list List audio files on SD card available for playback
get Sync actual EAP parameters from library to ATT config structures.
track=<filename> Select audio track to play.
list List audio files available on mounted SD card.
info Prints playback info.
EXAMPLE: Playback with eap effect: file track <audio_file> eap 3
Toolchain supported
===================
- GCC ARM Embedded 10.3.1
- MCUXpresso 11.5.0
- IAR embedded Workbench 9.20.2
Hardware requirements
=====================
- Mini/micro USB cable
- LPCXpresso55s69 board
- Personal Computer
- headphones with 3.5 mm stereo jack
- source of sound (line output to 3.5 mm stereo jack)
Board settings
==============
Insert the card into the card slot
Prepare the Demo
================
Note: MCUXpresso IDE project default debug console is semihost
1. Connect headphones to Audio HP / Line-Out connector.
2. Connect source of sound to Audio Line-In connector.
3. Connect a micro USB cable between the PC host and the CMSIS DAP USB port (P6) on the board
4. Open a serial terminal with the following settings :
- 115200 baud rate
- 8 data bits
- No parity
- One stop bit
- No flow control
5. Download the program to the target board.
6. Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Note:
There is limited RAM on this platform, which brings following limitations:
- EAP is enabled just with mp3 files
- to enable opus decoding and playback it is necessary to disable EAP:
1. Undefine EAP_PROC in the project settings
2. Make sure that MAX_SAMPLE_SIZE is defined to 960.
- some of the Opus files might fail to play due to insufficient memory
Running the demo
================
When the example runs successfully, you should see similar output on the serial terminal as below:
**********************************
Maestro audio solutions demo start
**********************************
[APP_SDCARD_Task] start
[APP_Shell_Task] start
SHELL build: Nov 5 2020
Copyright 2020 NXP
>> [APP_SDCARD_Task] SD card drive mounted