stxent / audio-player

Audio Player for LPC17xx MCU

Installation

MCU Audio Player project supports playing MP3 and WAV files on LPC175x/LPC176x and LPC43xx MCU. It requires GNU toolchain for ARM Cortex-M processors and CMake version 3.21.

Quickstart

Clone git repository:

git clone https://github.com/stxent/audio-player.git
cd audio-player
git submodule update --init --recursive

Build release version for LPC17xx development board:

mkdir build
cd build
cmake .. -DPLATFORM=LPC17XX -DBOARD=lpc17xx_devkit -DCMAKE_TOOLCHAIN_FILE=libs/xcore/toolchains/cortex-m3.cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_MP3=ON -DUSE_DFU=ON -DUSE_LTO=OFF -DUSE_WDT=ON
make

Build release version for LPC43xx development board:

mkdir build
cd build
cmake .. -DPLATFORM=LPC43XX -DBOARD=lpc43xx_devkit -DCMAKE_TOOLCHAIN_FILE=libs/xcore/toolchains/cortex-m4.cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_MP3=ON -DUSE_DFU=ON -DUSE_LTO=OFF -DUSE_WDT=ON
make

Build release version for flashless LPC43xx parts with first-stage external NOR Flash bootloader (LTO should be disabled at all times):

mkdir build
cd build
cmake .. -DPLATFORM=LPC43XX -DBOARD=lpc43xx_devkit -DCMAKE_TOOLCHAIN_FILE=libs/xcore/toolchains/cortex-m4.cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_MP3=ON -DUSE_DFU=ON -DUSE_LTO=OFF -DUSE_NOR=ON -DUSE_WDT=ON
make

All firmwares are placed in a board directory inside the build directory. The Application firmware is placed in an application.bin file and may be flashed using a preferred tool, for example LPC-Link or J-Link. DFU firmwares are available in the dpm-examples project. Application firmwares with DFU memory layout should be loaded using dfu-util (root access may be required):

dfu-util -R -D application.bin

Useful settings

• CMAKE_BUILD_TYPE — specifies the build type. Possible values are empty, Debug, Release, RelWithDebInfo and MinSizeRel.
• USE_DBG — enables debug messages and profiling.
• USE_DFU — links application and test firmwares using DFU memory layout.
• USE_LTO — enables Link Time Optimization.
• USE_NOR — places application and test firmwares in the NOR Flash instead of the internal Flash.
• USE_WDT — enables Watchdog Timer.