Explorer Board#
This example application demonstrates various capabilities of the Explorer board using FreeRTOS. The application uses I2C, I2S, SPI, UART, flash, mic array, and GPIO devices.
The FreeRTOS application creates a single stage audio pipeline which applies a variable gain. The output audio is sent to the DAC and can be listened to via the 3.5mm audio jack. The audio gain can be adjusted via GPIO, where button A is volume up and button B is volume down.
Preparing the hardware#
The UART loopback section of the demo requires that a jumper cable be connected between X1D36 and X1D39. This connects the Tx pin to the Rx pin.
Deploying the firmware with Linux or macOS#
Building the firmware#
Run the following commands in the xcore_iot root folder to build the firmware:
cmake -B build -DCMAKE_TOOLCHAIN_FILE=xmos_cmake_toolchain/xs3a.cmake
cd build
make example_freertos_explorer_board
Note
The host applications are required to create the filesystem. See the XCORE-IOT installation instructions for more information.
From the build folder, create the filesystem and flash the device with the following command:
make flash_app_example_freertos_explorer_board
Running the firmware#
From the build folder run:
make run_example_freertos_explorer_board
Debugging the firmware with xgdb#
From the build folder run:
make debug_example_freertos_explorer_board
Deploying the firmware with Windows#
Building the firmware#
Run the following commands in the xcore_iot root folder to build the firmware:
cmake -G "NMake Makefiles" -B build -DCMAKE_TOOLCHAIN_FILE=xmos_cmake_toolchain/xs3a.cmake
cd build
nmake example_freertos_explorer_board
Note
The host applications are required to create the filesystem. See the XCORE-IOT installation instructions for more information.
From the build folder, create the filesystem and flash the device with the following command:
nmake flash_app_example_freertos_explorer_board
Running the firmware#
From the build folder run:
nmake run_example_freertos_explorer_board
Debugging the firmware with xgdb#
From the build folder run:
nmake debug_example_freertos_explorer_board