/pacmog

PCM decoding library for embedded systems

Primary LanguageRustApache License 2.0Apache-2.0

pacmog

Cargo
Documentation
Tests

pacmog is a decoding library for the PCM file.
Designed for use in playing the PCM file embedded in microcontroller firmware.
Rust has an include_bytes! macro to embed the byte sequence in the program. Using it, PCM files can be embedded in firmware and used for playback.
pacmog works with no_std by default.

Format Status
WAV 16bit ✅
WAV 24bit ✅
WAV 32bit ✅
WAV 32bit float ✅
WAV 64bit float ✅
IMA ADPCM ✅
AIFF 16bit ✅
AIFF 24bit ✅
AIFF 32bit ✅
AIFF 32bit float ✅
AIFF 64bit float ✅

Example

cargo run --example beep

Read a sample WAV file.

use pacmog::PcmReader;

let wav = include_bytes!("../tests/resources/Sine440Hz_1ch_48000Hz_16.wav");                        
let reader = PcmReader::new(wav);
let specs = reader.get_pcm_specs();
let num_samples = specs.num_samples;
let num_channels = specs.num_channels as u32;

println!("PCM info: {:?}", specs);

for sample in 0..num_samples {
    for channel in 0..num_channels {
        let sample_value = reader.read_sample(channel, sample).unwrap();
        println!("{}", sample_value);
    }
}

Test

cargo test

Benchmark

cargo criterion

no_std

pacmog works with no_std by default.
No setup is needed.