GPIOMON(1)                          gpiomon                         GPIOMON(1)

نام (NAME)
       gpiomon - ابزار خط فرمان libgpiod

خلاصه دستور (SYNOPSIS)
       gpiomon [OPTIONS] <line>...

توضیحات (DESCRIPTION)
       منتظر ماندن برای رویدادها روی خطوط GPIO و چاپ آن‌ها در خروجی استاندارد.

       خطوط با نام مشخص می‌شوند، یا در صورت ارائهٔ گزینهٔ chip، به‌طور اختیاری با
       آفست تعیین می‌گردند.

گزینه‌ها (OPTIONS)
       --banner
              نمایش یک اعلان هنگام راه‌اندازی موفقیت‌آمیز

       -b, --bias <bias>
              تعیین بایاس خط مقدارهای ممکن: 'pull-down'، 'pull-up' و
              'disabled'.  (پیش‌فرض بر این است که بایاس بدون تغییر رها شود)

       --by-name
              در نظر گرفتن خطوط به‌عنوان نام، حتی اگر به‌صورت آفست قابل تجزیه
              باشند

       -c, --chip <chip>
              محدود کردن دامنه به یک تراشهٔ خاص

       -C, --consumer <name> نام مصرف‌کننده (consumer) اعمال‌شده روی خطوط
              درخواستی (پیش‌فرض 'gpiomon' است)

       -e, --edges <edges>
              تعیین لبه‌ها برای نظارت مقدارهای ممکن: 'falling'، 'rising' و
              'both'.  (پیش‌فرض 'both' است)

       -E, --event-clock <clock>
              تعیین ساعت مبدأ برای برچسب‌های زمانی رویداد مقدارهای ممکن:
              'monotonic'، 'realtime' و 'hte'.  (پیش‌فرض 'monotonic' است) به‌طور
              پیش‌فرض 'realtime' به‌صورت UTC قالب‌بندی می‌شود، سایر موارد به‌صورت
              u64 خام هستند.

       -h, --help
              نمایش این راهنما و خروج

       -F, --format <fmt>
              تعیین قالب خروجی سفارشی

       --idle-timeout <period>
              خروج تمیز در صورتی که هیچ رویدادی برای دورهٔ زمانی مشخص‌شده رخ
              ندهد

       -l, --active-low
              در نظر گرفتن خط به‌صورت active low، که مفهوم لبه‌های بالا رونده
              (rising) و پایین رونده (falling) را معکوس می‌کند

       --localtime
              قالب‌بندی برچسب‌های زمانی رویداد به وقت محلی

       -n, --num-events <num>
              خروج پس از پردازش num رویداد

       -p, --debounce-period <period>
              حذف نوسانات (debounce) خط(ها) با دورهٔ زمانی مشخص‌شده

       -q, --quiet
              تولید نکردن هیچ‌گونه خروجی

       -I, --initial-state
              چاپ وضعیت‌های اولیهٔ خطوط

       -N, --numeric
              نمایش مقادیر خط به‌صورت '0' (غیرفعال) یا '1' (فعال)

       -s, --strict
              لغو عملیات در صورت یکتا نبودن نام خطوط درخواستی

       --unquoted
              قرار ندادن نام خط یا مصرف‌کننده در علامت نقل‌قول

       --utc  قالب‌بندی برچسب‌های زمانی رویداد به‌صورت UTC (پیش‌فرض برای
              'realtime')

       -v, --version
              نمایش اطلاعات نگارش و خروج

   تراشه‌ها (Chips):
              یک تراشهٔ GPIO می‌تواند با شماره، نام یا مسیر شناسایی شود.  برای
              مثال '0'، 'gpiochip0' و '/dev/gpiochip0' همگی به یک تراشه اشاره
              دارند.

   دوره‌های زمانی (Periods):
              دوره‌های زمانی برحسب میلی‌ثانیه در نظر گرفته می‌شوند مگر اینکه
              واحدها مشخص شده باشند، مانند 10us.  واحدهای پشتیبانی‌شده به ترتیب
              عبارتند از 'm' برای دقیقه، 's' برای ثانیه، 'ms' برای میلی‌ثانیه و
              'us' برای میکروثانیه.

   مشخص‌کننده‌های قالب‌بندی (Format specifiers):
       %o     آفست خط GPIO

       %l     نام خط GPIO

       %c     نام تراشهٔ GPIO

       %e     نوع عددی رویداد لبه ('1' - بالا رونده یا '2' - پایین رونده)

       %E     نوع رویداد لبه ('rising' یا 'falling')

       %S     برچسب زمانی رویداد برحسب ثانیه

       %U     برچسب زمانی رویداد به‌صورت UTC

       %L     برچسب زمانی رویداد به وقت محلی

نویسندگان (AUTHORS)
       Bartosz Golaszewski <brgl@kernel.org>

گزارش باگ‌ها (BUGS)
       گزارش باگ‌ها به:
           Bartosz Golaszewski <brgl@kernel.org>
           linux-gpio <linux-gpio@vger.kernel.org>

کپی‌رایت و تکثیر (COPYRIGHT)
       حق نشر © 2017-2023 Bartosz Golaszewski مجوز: GPL-2.0-or-later
       این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.  هیچ‌گونه
       ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

gpiomon v2.3.1 (libgpiod v2.2.1)   July 2026                        GPIOMON(1)