نام (NAME)

gpscat - ابزار خواندن و ارسال داده‌های خام دستگاه GPS

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

gpscat [گزینه‌ها] پرونده-یا-درگاه-سریال

gpscat -h

gpscat -V

توضیحات (DESCRIPTION)

برنامه gpscat یک ابزار ساده برای ثبت وقایع (لاگ‌گیری) و بسته‌بندی جریان‌های داده‌ای GPS است. این برنامه ورودی را از یک پرونده مشخص یا یک دستگاه سریال (که فرض می‌شود یک GPS به آن متصل است) دریافت کرده و در خروجی استاندارد گزارش می‌دهد. برنامه تا زمان پایان ورودی یا متوقف شدن با کلیدهای ^C یا روش‌های دیگر به اجرای خود ادامه می‌دهد. برنامه در صورت مواجهه با یک بسته نامعتبر متوقف نمی‌شود؛ این رفتار عمدی است.

در حالت خام (حالت پیش‌فرض)، gpscat صرفاً ورودی خود را در خروجی استاندارد می‌ریزد. نویسه‌های غیرقابل‌چاپ به‌جز فاصله‌های خالی اَسکی (ASCII whitespace) به‌صورت رشته‌های گریز هگزادسیمال نمایش داده می‌شوند.

در حالت بسته‌بندی (packetizing mode)، gpscat از همان کد به‌کار رفته در اسنیفر بسته‌های gpsd(8) برای شکستن و تفکیک ورودی به بسته‌ها استفاده می‌کند. بسته‌ها به‌صورت یک بسته در هر سطر گزارش می‌شوند؛ شکستگی‌های خط درون خود بسته‌ها با نویسه گریز مشخص می‌شوند.

این برنامه به‌عنوان یک ابزار بررسی سلامت (sanity checker) هنگام آزمایش یک دستگاه جدید بسیار مفید است. می‌توان از آن به‌عنوان یک ثبت‌کننده اولیه NMEA استفاده کرد، اما توجه داشته باشید که: الف) متوقف کردن آن احتمالاً خروجی را در میانه یک جمله قطع می‌کند، و ب) برای جلوگیری از نمایش جملات ناقص NMEA دقیقاً در کنار خط فرمان پوسته که اغلب حاوی علامت $ هستند، حالت خام همیشه یک خط جدید (linefeed) اضافی در پایان منتشر می‌کند.

همچنین در نظر داشته باشید که حالت بسته‌بندی در صورتی که داده‌هایی دریافت کند که دنباله‌ای از بسته‌های یکی از انواع شناخته‌شده نباشد، نتایج نامعتبری تولید خواهد کرد -- احتمالاً کل ورودی را مصرف کرده و به نظر می‌رسد برنامه قفل شده است.

گزینه‌ها (OPTIONS)

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

-?, -h, --help

نمایش راهنمای استفاده از برنامه و خروج.

-D LVL, --debug LVL

در حالت بسته‌بندی، پیام‌های پیشرفت دریافت‌کننده بسته را فعال می‌کند. احتمالاً فقط برای توسعه‌دهندگانی که تغییرات دریافت‌کننده بسته را آزمایش می‌کنند کاربرد دارد. آرگومان‌های بالاتر برای -D خروجی بیشتری تولید می‌کنند.

-p, --packetizer

فراخوانی حالت بسته‌بندی (packetizer).

-s SPEED, --speed SPEED

تنظیم نرخ باود (baud rate) درگاه (و در صورت تمایل، بیت‌های توازن و توقف آن) روی مقدار SPEED پیش از خواندن. آرگومان باید با یکی از نرخ‌های باود عددی معمول (۳۰۰، ۱۲۰۰، ۴۸۰۰، ۹۶۰۰، ۱۹۲۰۰، ۳۸۴۰۰ و غیره) شروع شود. این مقدار می‌تواند با پسوند اختیاری [NOE][12] برای تعیین توازن (None برای هیچ، Odd برای فرد، Even برای زوج) و بیت‌های توقف (۱ یا ۲) همراه باشد. مشخص کردن -s 4800N1 اغلب در مواجهه با دستگاه‌های ناشناخته بسیار مفید است.

-t, --typeflag

فراخوانی حالت بسته‌بندی، به طوری که نوع بسته و طول آن (در پرانتز) قبل از یک دونقطه و فاصله در ابتدای هر خط گزارش شود.

-V, --version

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