README.rst
1Description
2-----------
3
4This is a demo showcasing the sound-handling capabilities of Renode on the example of a Zephyr application running on LiteX with the I2S module.
5
6The application copies the stereo signal encoded in 24-bit PCM format (signed, little-endian) at the 44100Hz rate from the input to the output.
7
8By default, the demo runs the simulation for 3.2 virtual seconds in order to copy a 3s sample containing a 440Hz sine signal with periodical beeps.
9The user can change these settings by providing the following variables:
10* $zephyr_application - an ELF file with the application to run on the CPU,
11* $simulation_duration - a period (in virtual seconds) for the simulation to run,
12* $input_file - an input sound sample (in the format described above).
13
14How to run
15----------
16
17The demo requires an `output_file` that points to the file containing the sound data generated by the Zephyr application.
18
19Run the following lines in the Monitor in order to run the demo:
20
21 (monitor) $output_file=@/tmp/output.pcm
22 (monitor) include @scripts/complex/litex_i2s/litex_vexriscv_i2s.resc
23
24Note: There is no need to start the simulation after including the script - it will run the simulation for 3.2 virtual seconds automatically.
25
