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 두 개의 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를 참조하세요.