نام (NAME)

gps2udp - ارسال داده‌های دریافتی از gpsd به یک یا چند پایگاه تجمیع داده

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

gps2udp [گزینه‌ها] [server[:port[:device]]]

gps2udp -h

gps2udp -V

توضیحات (DESCRIPTION)

gps2udp ابزاری برای اتصال به gpsd و ارسال جملات دریافتی به یک یا چند مقصد UDP با فرمت میزبان:درگاه (host:port) است. این ویژگی باعث می‌شود که این برنامه برای ارسال اطلاعات AIS از gpsd به پایگاه‌هایی مانند aishub، marinetraffic، shipfinder و... بسیار مفید باشد.

gps2udp برای اجرا نیازی به مجوزهای کاربر ارشد (root) ندارد، اما می‌تواند با این کاربر نیز اجرا شود. همچنین این ابزار می‌تواند بدون ایجاد هیچ مشکلی، به‌طور هم‌زمان با سایر ابزارهایی که به gpsd محلی متصل هستند اجرا شود.

خروجی شامل یک یا هر دو نوع جملات NMEA (گزینه -n) یا JSON (گزینه -j) از gpsd خواهد بود. خروجی از طریق یک سوکت شبکه UDP به یک یا چند میزبان مقصد (گزینه -u HOST:PORT) فرستاده می‌شود.

به‌صورت اختیاری می‌توان یک کارساز (سرور)، شماره درگاه TCP/IP و دستگاه دوردست را مشخص کرد. در صورت عدم تعیین، gps2udp به localhost روی درگاه پیش‌فرض (2947) متصل می‌شود و تمامی دستگاه‌های بازشده توسط gpsd را نظارت می‌کند.

gps2udp می‌تواند به‌صورت یک دیمن (گزینه -b) اجرا شود.

gps2udp به‌گونه‌ای طراحی شده است که به‌خوبی در پس‌زمینه اجرا شود؛ در صورت راه‌اندازی مجدد gpsd، این ابزار به‌طور خودکار دوباره به آن متصل می‌شود. برای مقاصد اشکال‌زدایی، گزینه‌ای برای خروج تمیز پس از ارسال تعداد مشخصی بسته در نظر گرفته شده است (گزینه -c).

گزینه‌ها (OPTIONS)

-?, -h, --help

چاپ پیام راهنمای نحوه استفاده و خروج.

-a, --ais

فقط ارسال پیام‌های AIS.

-b, --daemon

اجرای gps2udp به‌صورت یک دیمن (در پس‌زمینه).

-c COUNT, --count COUNT

خروج پس از ارسال COUNT جمله.

-d LVL, --debug LVL

تنظیم سطح اشکال‌زدایی روی LVL. مقدار LVL = 0 چیزی چاپ نمی‌کند. مقدار LVL = 1 بسته‌های ارسالی را در خروجی استاندارد چاپ می‌کند. مقدار LVL = 2 بسته‌های نادیده‌گرفته‌شده را چاپ می‌کند.

-j, --json

باعث خروجی داده شدن جملات JSON می‌شود.

-n, --nmea

باعث خروجی داده شدن جملات NMEA می‌شود.

-t, --tpv

تنها خروجی دادن جملات TPV. به طور ضمنی شامل --json نیز می‌شود.

-u HOST:PORT, --udp HOST:PORT

مقصد UDP برای جملات خروجی (تا حداکثر پنج مقصد).

-v, -V, --version

چاپ نسخه برنامه و خروج. گزینه -v از دسامبر ۲۰۲۰ منسوخ شده است.

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

به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی gpsd که روی localhost اجرا می‌شود و با استفاده از درگاه پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند. با آرگومان اختیاری کلاینت می‌توان این رفتار را بازنویسی کرد: [server[:port[:device]]]

برای توضیحات بیشتر و مشاهده مثال‌ها، به بخش ARGUMENTS در صفحه راهنمای gps(1) مراجعه کنید.

مثال‌ها (EXAMPLES)

با وجود یک gpsd در حال اجرا و قابل دسترسی روی شبکه، دستور زیر داده‌ها را از localhost:gpsd جمع‌آوری کرده، آن‌ها را در خروجی استاندارد (stdout) نمایش می‌دهد و رونوشتی از آن را در قالب NMEA برای آزمایش به aishub ارسال می‌کند:

gps2udp -d 1 -n -u data.aishub.net:2222

دستور زیر داده‌ها را از یک gpsd دوردست مستقر بر روی میزبان fridu.net جمع‌آوری کرده، پیام‌های AIS را فیلتر می‌کند و آن‌ها را در قالب NMEA به ۳ مقصد (aishub، marinetraffic و shipfinder) می‌فرستد، در حالی که در حالت پس‌زمینه اجرا می‌شود:

gps2udp -a -n -b -u data.aishub.net:2222 -u 5.9.207.224:5321 \
   -u 109.200.19.151:4001 fridu.net:2947

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

0

در صورت موفقیت.

1

در صورت بروز خطا.

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

gpsd(8), gps(1)

منابع (RESOURCES)

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

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

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

نویسنده (AUTHOR)

Fulup Ar Foll