نام (NAME)

alsatplg - کامپایلر توپولوژی ALSA

خلاصه دستور (SYNOPSIS)

alsatplg <options> [command]

توضیحات (DESCRIPTION)

برنامه alsatplg (کامپایلر توپولوژی ALSA) ابزاری برای کامپایل کردن فایل پیکربندی توپولوژی به فایل باینری جهت استفاده در درایورهای هسته است.

درایورهای صوتی فعلی معمولاً اطلاعات توپولوژی را به‌صورت کد سراسری و ثابت (hard-coded) در سورس‌های درایور قرار می‌دهند: این کار درایور صوتی را به‌شدت به برد توسعه وابسته می‌کند و تغییر درایور برای کار روی دستگاه‌های مختلف را زمان‌بر می‌سازد. همچنین درایور به‌شدت به نسخه فریم‌ور DSP وابسته است، به این معنی که برای همگام نگه داشتن نسخه درایور و فریم‌ور دقت بیشتری لازم است. ویژگی‌های جدید فریم‌ور نیز به معنای به‌روزرسانی درایور خواهد بود.

پروژه توپولوژی ALSA نیاز به بازنویسی یا پورت کردن درایورهای صوتی برای دستگاه‌های مختلف یا فریم‌ورهای گوناگون را برطرف می‌کند: درایورها فاقد داده‌های توپولوژی ثابت درون کد هستند، به این معنی که یک درایور واحد می‌تواند با به‌روزرسانی داده‌های توپولوژی از طریق سیستم فایل، بر روی دستگاه‌های مختلف استفاده شود. به‌روزرسانی‌های فریم‌ور می‌توانند بدون نیاز به به‌روزرسانی درایورها اعمال شوند. فریم‌ور جدید تنها کافی است شامل یک فایل توپولوژی به‌روزرسانی‌شده باشد که تغییرات را توصیف می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های در دسترس:

-h, --help: نمایش این راهنما
-V, --version: نمایش نسخه ابزار و نسخه کتابخانه‌های استفاده‌شده
-c, --compile FILE: فایل پیکربندی مبدأ برای کامپایل
-d, --decode FILE: فایل باینری توپولوژی مبدأ برای رمزگشایی (decode)
-n, --normalize FILE: تجزیه و ذخیره فایل پیکربندی در قالب نرمال‌شده (normalized)
-u, --dump FILE: تجزیه و ذخیره فایل پیکربندی در قالب مشخص‌شده
-o, --output FILE: فایل خروجی
-v, --verbose LEVEL: تنظیم سطح پرگویی (verbose)
-s, --sort: مرتب‌سازی شناسه‌های پیکربندی (تنظیم برای نرمال‌سازی)
-x, --nocheck: ذخیره پیکربندی بدون بررسی صحت (integrity check) اضافی
-z, --dapm-nosort: عدم مرتب‌سازی موارد گراف DAPM (مانند نسخه 1.2.1-)

فایل‌ها (FILES)

فایل‌های توپولوژی اصلی برای هر کارت صدای پشتیبانی‌شده در مسیر /usr/share/alsa/topology قرار دارند.

برای نمونه، فایل مورد استفاده اصلی برای کارت broadwell در مسیر /usr/share/alsa/topology/broadwell/broadwell.conf قرار دارد؛ این فایل سخت‌افزار صوتی را برای درایور توصیف می‌کند.

برای جزئیات بیشتر در مورد ساختار نحوی فایل‌های UCM، سورس‌کد alsa-lib را ببینید: http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/topology/parser.c

همچنین ببینید (SEE ALSO)

•: رابط توپولوژی (Topology Interface): http://www.alsa-project.org/alsa-doc/alsa-lib/group__topology.html

اشکالات (BUGS)

مورد شناخته‌شده‌ای وجود ندارد.

نویسنده (AUTHOR)

Jaroslav Kysela <perex@perex.cz>

حق نشر (COPYRIGHT)

GPLv2+