'\" t
.\"     Title: ppscheck
.\"    Author: Eric S. Raymond
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: Persian
.\"
.TH "PPSCHECK" "8" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
ppscheck \- ابزاری برای بررسی پورت سریال جهت دریافت سیگنال PPS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBppscheck\fP [\-?] [\-\-help] [\-p] [\-\-pps] [\-\-version] [\-h] [\-V]
.sp
\fBppscheck\fP [\-m] device
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
\fBppscheck\fP
یک پورت سریال مشخص‌شده را برای یافتن تغییر وضعیت‌هایی که ممکن است
سیگنال PPS (پالس در ثانیه) باشند، زیر نظر می‌گیرد. این ابزار با اجرای تابع
.BR ioctl (.\|.\|.., TIOCMIWAIT, .\|.\|.)
در یک حلقه، تغییرات در خطوط دست‌تکانی (handshake) شامل
.BR CD ،
.BR CTS ،
.B DSR
و
.B RI
را بررسی می‌کند. هنگامی که تغییری در وضعیت رخ دهد، یک خط خروجی دارای برچسب زمانی تولید می‌کند که وضعیت سیگنال‌های دست‌تکانی را به نمایش می‌گذارد. این برنامه برای بررسی اینکه آیا یک دستگاه در حال ارسال
PPS
است یا خیر، بسیار مفید است.
.sp
دستور
\fBppscheck\fP
می‌تواند توسط کاربر عادی اجرا شود، اما آن کاربر باید دسترسی خواندن دستگاه هدف را داشته باشد. اجرای برنامه با
\fBsudo\fP
ممکن است کار کند یا نکند؛ اما اجرا به عنوان کاربر ریشه (root) همیشه کار خواهد کرد.
.sp
برای بررسی نخستین پورت سریال، دستور زیر را اجرا کنید:
.sp
.if n .RS 4
.nf
.fam C
# ppscheck /dev/ttyS0
.fam
.fi
.if n .RE
.sp
به عنوان یک اثر جانبی،
\fBppscheck\fP
تلاش خواهد کرد تا با تنظیم دیسیپلین خط تی‌تی‌وای (ldisc) روی
.B N_PPS
(مقدار ۱۸)، دستگاه متناظر
.B /dev/ppsX
را بسازد. در این صورت باید دستگاه
.B /dev/pps0
را در اختیار داشته باشید. توجه داشته باشید که همه دستگاه‌های سریال از
ldisc N_PPS
پشتیبانی نمی‌کنند.
.sp
اکنون می‌توانید از
\fBppscheck\fP
برای بررسی کارکرد رابط
KPPS (RFC 2783)
استفاده کنید:
.sp
.if n .RS 4
.nf
.fam C
# ppscheck /dev/pps0
.fam
.fi
.if n .RE
.sp
دستور
\fBppscheck\fP
برای استفاده‌های روزمره و مداوم طراحی نشده است، بلکه برای مقاصد عیب‌یابی کاربرد دارد. هنگامی که تأیید کردید یک دستگاه خاص می‌تواند سیگنال‌های
PPS
را خروجی دهد، دیگر هرگز نیازی به اجرای مجدد آن روی آن دستگاه نخواهید داشت.
.SH "گزینه‌ها (OPTIONS)"
.sp
این برنامه گزینه‌های زیر را می‌پذیرد:
.sp
\f(CR\-?, `\-h, `\-\-help\fP
.RS 4
نمایش پیام راهنما و سپس خروج.
.RE
.sp
\f(CR\-m, `\-\-match\fP
.RS 4
یافتن دستگاه PPS که با
\fIdevice\fP
همخوانی دارد.
.RE
.sp
\f(CR\-p, `\-\-pps\fP
.RS 4
نمایش دستگاه‌های PPS فعال و سپس خروج.
.RE
.sp
\f(CR\-V, `\-\-version\fP
.RS 4
نمایش نسخه برنامه و سپس خروج.
.RE
.sp
\f(CR\fB\-x SEC\fP, \fB\-\-seconds SEC\fP\fP
.RS 4
خروج پس از تأخیر مشخص‌شده برحسب ثانیه (SEC).
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
آرگومان
\fIdevice\fP
باید مسیر یک دستگاه، مانند
/dev/ttyS0
یا
/dev/pps0
باشد. این مسیر دستگاهی است که بررسی می‌شود.
.sp
برای یک دستگاه tty، هر خط خروجی شامل بخش‌های ثانیه و نانوثانیه از یک برچسب زمانی است که پس از آن نام سیگنال‌های دست‌تکانی فعال‌شده (asserted) در آن لحظه درج می‌شود. تغییر وضعیت‌های خاموش (Off transitions) ممکن است خطوطی بدون هیچ سیگنال فعالی تولید کنند.
.sp
برای یک دستگاه pps، هر خط خروجی شامل زمان‌های فعال‌سازی (assert) و پاک‌سازی (clear) خواهد بود که آخرین بار توسط KPPS شناسایی شده‌اند.
.sp
اگر ظرف یک ثانیه خروجی ندیدید، پیش از ناامید شدن از احتمال وجود PPS، با استفاده از
\fBcgps\fP ،
\fBxgps\fP
یا ابزار معادل دیگری مطمئن شوید که دستگاه شما سیگنال ماهواره را قفل کرده (satellite lock) و داده‌های موقعیت‌یابی سه‌بعدی را دریافت می‌کند.
.sp
کابل خود را بررسی کنید. کابل‌های ارزان‌قیمت DB9 به DB9 که معمولاً همراه با UPSها ارائه می‌شوند اغلب فقط خطوط TXD/RXD/GND را متصل می‌کنند و خطوط دست‌تکانی مانند CD را حذف می‌کنند. اگر روکش کابل به اندازه‌ای باریک به نظر می‌رسد که نمی‌تواند بیش از سه رشته سیم را در خود جای دهد، بیشتر به آن شک کنید!
.sp
بیشتر دستگاه‌های GPS که دارای درگاه USB داخلی هستند، از PPS پشتیبانی نمی‌کنند. هنگام تردید، با سازنده دستگاه تماس بگیرید تا تأیید کند که دستگاه شما سیگنال PPS را ارائه می‌دهد.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
0
.RS 4
موفقیت‌آمیز
.RE
.sp
1
.RS 4
اگر باز کردن دستگاه با شکست مواجه شود، یا وقوع خطاهای دیگر
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcgps\fP(1), \fBxgps\fP(1), \fBgpsd\fP(8)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق امتیاز این فایل متعلق به سال ۲۰۱۳ پروژه GPSD است
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Eric S. Raymond