This repository was archived by the owner on Aug 11, 2026. It is now read-only.
Repository navigation
Releases
Releases · OpenBLIP25/blip25-mbe
blip25-mbe v0.1.0
Initial public release. Research-grade Rust implementation of the MBE
codec family (IMBE / AMBE / AMBE+ / AMBE+2) targeting P25 Phase 1 and
Phase 2 pipelines, derived from TIA-102 specifications and expired DVSI
patents. See PATENT_NOTICE.md for the AMBE+2
patent caveat (US8359197 active until 2028-05-20).
Added
- Chip-shaped façade —
Vocoder::new(Rate)per-channel handle with
encode_pcm/decode_bits/encode_stream/decode_stream,
modeled on the DVSI AMBE-3000R API. LiveEncoder/LiveDecoder— chunk-driven streaming with
internal residue buffers for audio-callback and socket use.Transcoder— parametric bridge between Phase 1 IMBE and Phase 2
AMBE+2 wire formats (and same-codec FEC ↔ no-FEC pairs).VocoderBuilder— explicit configuration of optional enhancement,
spectral subtraction, tone detection, and LCG generator selection.Ratevariants —Imbe7200x4400,Imbe4400x4400,
AmbePlus2_3600x2450,AmbePlus2_2450x2450, plus chip-internal r34.- Classical post-decoder enhancement — HPF + peaking EQ + output gain
filter chain, enabled by default. Opt out via
vocoder.set_enhancement(EnhancementMode::None). - Spectral-subtraction noise suppression — Boll-style with
spectral-stationarity gated noise estimate, enabled by default.
Opt out viavocoder.set_spectral_subtraction(false). - Tone-frame detection — Annex T DTMF / Knox single-tone matching
with end-to-end Phase 2 tone-frame routing. extract_params/synthesize_params— parameter-layer entry
points for users who want to interpose between analysis and synthesis.- Cross-rate conformance harness —
cargo run -p conformance-vectors -- cross-rate-comparevalidates IMBE FEC ↔ no-FEC bit-equivalence
against DVSI test vectors. serdefeature (optional, off by default) — derives
Serialize/Deserializeon the public diagnostic types
(Rate,FrameStats,AnalysisStats,MbeParams, etc.) for RPC use.profilefeature (optional, off by default) — per-stage timing
instrumentation in the analysis encoder; zero overhead when disabled.
Documentation
INTEGRATION.md— chip-shaped façade walkthrough and migration notes
for callers coming from a DVSI hardware path.docs/codec_family_explainer.md— wire-format-vs-implementation
primer for the IMBE / AMBE / AMBE+ / AMBE+2 family.docs/wire_formats_and_storage.md— guide to the fourRate
variants and their on-wire byte layouts.examples/vocoder_demo— exercises one-shot, streaming, live, params,
builder, and transcoder paths in a single binary.
Conformance
- Validated bit-by-bit against the DVSI
tv-rcandtv-stdtest
vector suites and via PESQ/STOI black-box comparison against the
DVSI AMBE-3000R hardware. No code or algorithms imported from
existing open-source MBE projects.