ESP32 I2S backend for the [awedio] audio playback library using ESP-IDF. Requires std.
mp3 is supported but may not work well on ESPs without native floating point.
The caller is responsible for setting up the I2S port before calling start on the backend. For example:
```rust norun const I2SPORTNUM: u32 = 0; const SAMPLERATE: u32 = 44100; const CHANNEL_COUNT: u16 = 1;
let config = espidfsys::i2sdriverconfigt { mode: espidfsys::i2smodetI2SMODEMASTER | espidfsys::i2smodetI2SMODETX, samplerate: SAMPLERATE, bitspersample: espidfsys::i2sbitsperchantI2SBITSPERCHAN16BIT, channelformat: espidfsys::i2schannelfmttI2SCHANNELFMTONLYRIGHT, communicationformat: espidfsys::i2scommformattI2SCOMMFORMATSTANDI2S, intrallocflags: espidfsys::ESPINTRFLAGLEVEL1 as i32, // Interrupt level 1, default 0 dmabufcount: 8, dmabuflen: 64, useapll: false, txdescautoclear: false, fixedmclk: 0, mclkmultiple: espidfsys::i2smclkmultipletI2SMCLKMULTIPLEDEFAULT, bitsperchan: 0, bitordermsb: false, bigedin: false, leftalign: false, chanmask: espidfsys::i2schanneltI2SCHANNELMONO, totalchan: 0, skipmsk: false, };
let result = unsafe { espidfsys::i2sdriverinstall(I2SPORTNUM, &config, 0, std::ptr::nullmut()) }; if result != espidfsys::ESPOK { panic!("error installing i2s driver"); }
let pinconfig = espidfsys::i2spinconfigt { mckionum: espidfsys::I2SPINNOCHANGE, // unused bckionum: espidfsys::gpionumtGPIONUM44, wsionum: espidfsys::gpionumtGPIONUM43, // LR clock dataoutnum: espidfsys::gpionumtGPIONUM38, datainnum: espidfsys::I2SPINNO_CHANGE, };
let result = unsafe { espidfsys::i2ssetpin(I2SPORTNUM, &pinconfig) }; if result != espidfsys::ESPOK { panic!("error setting i2s pins"); }
let mut backend = awedioesp32::Esp32Backend::withdefaults(CHANNELCOUNT, SAMPLERATE); let manager = backend.start(); ```
In order to get the rmp3 native dependency to compile for xtensa chips
(if the mp3 feature is enabled) you may need to export the following variables
(adjust for your target):
export CROSS_COMPILE=xtensa-esp32s3-elf; export CFLAGS=-mlongcalls
Built for creating activities for 10 Buttons, a screen-less tablet for kids. Purposefully kept generic to be usable in other contexts.
This project is licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.