libpo32

Teenage Engineering PO-32の音響データ転送とドラム合成のための小さなC99ライブラリです。

libpo32はPO-32 Tonicの転送スタックと互換性のあるドラムボイスモデルを再実装しています。完全なPO-32ファームウェアやUIエミュレータではありません。PO-32転送の構築、送信、受信、プレビューに必要なパケット形式、音響モデム、フレームデコーダ、ローカルドラム合成をカバーしています。

目次

• 概要
• PO-32での使用方法
• はじめに
• 例
• libpo32を使用したプロジェクト
• 公開API
• ドキュメント
• プロジェクト構成
• 貢献
• ライセンス

概要

コアはfreestanding C99です。libcランタイム、外部DSPライブラリ、プラットフォームオーディオAPI、ファイルI/Oは一切使用しません。freestandingヘッダの<stddef.h>と<stdint.h>のみを使用します。組み込みターゲットやベアメタル環境に適しています。

PO-32での使用方法

PO-32はサウンドやパターンを転送する際に完成したドラムオーディオを受信しているわけではありません。構造化されたデータを受信します:

デバイスはその後、独自の内部シンセエンジンを使用してこれらのパラメータをサウンドに変換します。

高レベルでは、実機でのワークフローは次のとおりです:

はじめに

リポジトリのルートから、設定、ビルド、テストの実行、そしてデモの実行を行います:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j4
ctest --test-dir build --output-on-failure
./build/po32_demo

ローカル開発には任意ですが、推奨される手順:

./scripts/install-git-hooks.sh

これによりリポジトリ管理のpre-commitフックが有効になり、各コミット前にステージングされた.cおよび.hファイルに対してclang-formatを実行し、コミット件名をConventional Commitsに対して検証します。リポジトリ管理のpre-pushフックは、プッシュ前に静的解析スクリプトを実行します。

pre-commitフックにはclang-format 18が必要で、他のメジャーバージョンでは失敗します。インストールオプションについてはCONTRIBUTING.mdを参照してください。

デモは転送フレームを構築し、オーディオにレンダリングし、それをデコードして（ロスレスのラウンドトリップを検証）、ドラムヒットを合成し、demo_modem.wavとdemo_kick.wavの2つのWAVファイルを書き出します。

インストールと利用

cmake --installは静的ライブラリ、ヘッダ、CMakeパッケージ、pkg-configファイルを提供するため、両方の利用方法がそのまま動作します:

find_package(LibPO32 0.2 REQUIRED)
target_link_libraries(app PRIVATE LibPO32::po32)

cc app.c $(pkg-config --cflags --libs po32) -lm

例

libpo32を使用したプロジェクト

公開API

ドキュメント

プロジェクト構成

貢献

ローカルセットアップ、検証コマンド、およびSemVer対応の履歴に使用されるConventional CommitsポリシーについてはCONTRIBUTING.mdを参照してください。

ライセンス

Copyright (c) 2026 Eric Lewis. MITライセンスの下でライセンスされています。LICENSEを参照してください。