نام (NAME)

ppscheck - ابزاری برای بررسی پورت سریال جهت دریافت سیگنال PPS

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

ppscheck [-?] [--help] [-p] [--pps] [--version] [-h] [-V]

ppscheck [-m] device

توضیحات (DESCRIPTION)

دستور ppscheck یک پورت سریال مشخص‌شده را برای یافتن تغییر وضعیت‌هایی که ممکن است سیگنال PPS (پالس در ثانیه) باشند، زیر نظر می‌گیرد. این ابزار با اجرای تابع ioctl(....,TIOCMIWAIT,...) در یک حلقه، تغییرات در خطوط دست‌تکانی (handshake) شامل CD، CTS، DSR و RI را بررسی می‌کند. هنگامی که تغییری در وضعیت رخ دهد، یک خط خروجی دارای برچسب زمانی تولید می‌کند که وضعیت سیگنال‌های دست‌تکانی را به نمایش می‌گذارد. این برنامه برای بررسی اینکه آیا یک دستگاه در حال ارسال PPS است یا خیر، بسیار مفید است.

دستور ppscheck می‌تواند توسط کاربر عادی اجرا شود، اما آن کاربر باید دسترسی خواندن دستگاه هدف را داشته باشد. اجرای برنامه با sudo ممکن است کار کند یا نکند؛ اما اجرا به عنوان کاربر ریشه (root) همیشه کار خواهد کرد.

برای بررسی نخستین پورت سریال، دستور زیر را اجرا کنید:

# ppscheck /dev/ttyS0

به عنوان یک اثر جانبی، ppscheck تلاش خواهد کرد تا با تنظیم دیسیپلین خط تی‌تی‌وای (ldisc) روی N_PPS (مقدار ۱۸)، دستگاه متناظر /dev/ppsX را بسازد. در این صورت باید دستگاه /dev/pps0 را در اختیار داشته باشید. توجه داشته باشید که همه دستگاه‌های سریال از ldisc N_PPS پشتیبانی نمی‌کنند.

اکنون می‌توانید از ppscheck برای بررسی کارکرد رابط KPPS (RFC 2783) استفاده کنید:

# ppscheck /dev/pps0

دستور ppscheck برای استفاده‌های روزمره و مداوم طراحی نشده است، بلکه برای مقاصد عیب‌یابی کاربرد دارد. هنگامی که تأیید کردید یک دستگاه خاص می‌تواند سیگنال‌های PPS را خروجی دهد، دیگر هرگز نیازی به اجرای مجدد آن روی آن دستگاه نخواهید داشت.

گزینه‌ها (OPTIONS)

این برنامه گزینه‌های زیر را می‌پذیرد:

-?, `-h, `--help

نمایش پیام راهنما و سپس خروج.

-m, `--match

یافتن دستگاه PPS که با device همخوانی دارد.

-p, `--pps

نمایش دستگاه‌های PPS فعال و سپس خروج.

-V, `--version

نمایش نسخه برنامه و سپس خروج.

-x SEC, --seconds SEC

خروج پس از تأخیر مشخص‌شده برحسب ثانیه (SEC).

آرگومان‌ها (ARGUMENTS)

آرگومان device باید مسیر یک دستگاه، مانند /dev/ttyS0 یا /dev/pps0 باشد. این مسیر دستگاهی است که بررسی می‌شود.

برای یک دستگاه tty، هر خط خروجی شامل بخش‌های ثانیه و نانوثانیه از یک برچسب زمانی است که پس از آن نام سیگنال‌های دست‌تکانی فعال‌شده (asserted) در آن لحظه درج می‌شود. تغییر وضعیت‌های خاموش (Off transitions) ممکن است خطوطی بدون هیچ سیگنال فعالی تولید کنند.

برای یک دستگاه pps، هر خط خروجی شامل زمان‌های فعال‌سازی (assert) و پاک‌سازی (clear) خواهد بود که آخرین بار توسط KPPS شناسایی شده‌اند.

اگر ظرف یک ثانیه خروجی ندیدید، پیش از ناامید شدن از احتمال وجود PPS، با استفاده از cgps ، xgps یا ابزار معادل دیگری مطمئن شوید که دستگاه شما سیگنال ماهواره را قفل کرده (satellite lock) و داده‌های موقعیت‌یابی سه‌بعدی را دریافت می‌کند.

کابل خود را بررسی کنید. کابل‌های ارزان‌قیمت DB9 به DB9 که معمولاً همراه با UPSها ارائه می‌شوند اغلب فقط خطوط TXD/RXD/GND را متصل می‌کنند و خطوط دست‌تکانی مانند CD را حذف می‌کنند. اگر روکش کابل به اندازه‌ای باریک به نظر می‌رسد که نمی‌تواند بیش از سه رشته سیم را در خود جای دهد، بیشتر به آن شک کنید!

بیشتر دستگاه‌های GPS که دارای درگاه USB داخلی هستند، از PPS پشتیبانی نمی‌کنند. هنگام تردید، با سازنده دستگاه تماس بگیرید تا تأیید کند که دستگاه شما سیگنال PPS را ارائه می‌دهد.

مقادیر بازگشتی (RETURN VALUES)

0

موفقیت‌آمیز

1

اگر باز کردن دستگاه با شکست مواجه شود، یا وقوع خطاهای دیگر

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

cgps(1), xgps(1), gpsd(8)

منابع (RESOURCES)

وبگاه پروژه: https://gpsd.io

کپی‌رایت و تکثیر (COPYING)

حق امتیاز این فایل متعلق به سال ۲۰۱۳ پروژه GPSD است
SPDX-License-Identifier: BSD-2-clause

نویسنده (AUTHOR)

Eric S. Raymond