'\" t
.\"     Title: ubxtool
.\"    Author: Gary E. Miller
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: Persian
.\"
.TH "UBXTOOL" "1" "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)"
ubxtool \- ابزار ارتباط و پیکربندی ماژول‌های u\-blox GPS/GNSS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBubxtool\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBubxtool\fP \-h
.sp
\fBubxtool\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBubxtool\fP ابزاری برای گیرنده‌های GPS شرکت u\-blox است. اگر گیرنده GPS از نوع u\-blox ندارید، نیازی به خواندن ادامه این راهنما نیست.
.sp
این ابزار در سطحی بسیار پایین با گیرنده u\-blox GPS شما کار می‌کند. برای درک و استفاده از \fBubxtool\fP ابتدا باید با سخت‌افزار GPS خود و مستندات پروتکل باینری u\-blox آشنایی داشته باشید. پروتکل u\-blox بسته به مدل GPS و نسخه میان‌افزار (firmware) تفاوت‌های چشمگیری دارد. همیشه از مستندات متناسب با مدل و نگارش میان‌افزار دستگاه خود استفاده کنید.
.sp
برنامه \fBubxtool\fP می‌تواند پیام‌های باینری رایج u\-blox را رمزگشایی کند، وضعیت GPS را استعلام نماید، ویژگی‌های مختلف گیرنده را فعال یا غیرفعال سازد، و دستورات دلخواه کاربر را به GPS ارسال کند. همچنین قادر است پیام‌های باینری را از یک فایل بخواند، و مستقیماً از طریق درگاه سریال یا از طریق سرویس در حال اجرای \fBgpsd\fP بخواند و بنویسد.
.sp
دستور \fBubxtool\fP نیازی به دسترسی‌های ریشه (root) ندارد، مگر احتمالاً برای دسترسی مستقیم به درگاه سریال در حالت دسترسی مستقیم (\fB\-f FILE\fP). اجرای آن با کاربر root بدون مشکل است، اما اجرا با دستور sudo ممکن است باعث از دست رفتن برخی قابلیت‌ها شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
این برنامه گزینه‌های زیر را می‌پذیرد:
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش پیام راهنمای نحوه استفاده و خروج. همراه با \fB\-v 2\fP برای مشاهده تمام مقادیر فعال/غیرفعال‌سازی و پیش‌تنظیم‌ها، و همراه با \fB\-v 3\fP برای مشاهده موارد پیکربندی اضافی (فهرست طولانی).
.RE
.sp
\fB\-c COMMAND\fP, \fB\-\-command COMMAND\fP
.RS 4
ارسال یک دستور به GPS. یک پارامتر COMMAND به صورت فهرستی از بایت‌های هگزادسیمال جداشده با کاما دریافت می‌کند که کلاس، شناسه (ID) و هرگونه بار داده (payload) لازم را مشخص می‌کند. سرآیند، طول داده و چکسام (checksum) به طور خودکار اضافه می‌شوند.
.RE
.sp
\fB\-\-device DEVICE\fP
.RS 4
دستگاه روی \fBgpsd\fP برای اتصال. پیش‌فرض همه دستگاه‌ها است.
.RE
.sp
\fB\-d OPTION\fP, \fB\-\-disable OPTION\fP
.RS 4
غیرفعال‌سازی یک گزینه در GPS. یک پارامتر OPTION برای غیرفعال‌سازی دریافت می‌کند. برای مشاهده تمام مقادیر ممکن دستور "ubxtool \-h \-v 2" را اجرا کنید. برخی از مقادیر ممکن عبارتند از:
.sp
BEIDOU
.RS 4
غیرفعال‌سازی استفاده از منظومه ماهواره‌ای BeiDou (COMPASS).
.RE
.sp
BINARY
.RS 4
غیرفعال‌سازی ارسال پیام‌های پایه باینری.
.RE
.sp
ECEF
.RS 4
غیرفعال‌سازی ارسال پیام‌های باینری ECEF.
.RE
.sp
GALILEO
.RS 4
غیرفعال‌سازی استفاده از منظومه ماهواره‌ای گالیله (GALILEO).
.RE
.sp
GLONASS
.RS 4
غیرفعال‌سازی استفاده از منظومه ماهواره‌ای گلوناس (GLONASS).
.RE
.sp
GPS
.RS 4
غیرفعال‌سازی استفاده از منظومه‌های ماهواره‌ای GPS و QZSS.
.RE
.sp
NED
.RS 4
غیرفعال‌سازی ارسال پیام‌های باینری NED شامل UBX\-NAV\-VELNED و UBX\-NAV\-RELPOSNED.
.RE
.sp
NMEA
.RS 4
غیرفعال‌سازی ارسال پیام‌های پایه NMEA شامل GBS، GGA، GSA، GGL، GST، GSV، RMC، VTG و ZDA.
.RE
.sp
PPS
.RS 4
غیرفعال‌سازی TIMEPULSE 0.
.RE
.sp
RAWX
.RS 4
غیرفعال‌سازی ارسال پیام‌های UBX\-RXM\-RAWX.
.RE
.sp
SBAS
.RS 4
غیرفعال‌سازی استفاده از منظومه ماهواره‌ای SBAS.
.RE
.sp
SFRBX
.RS 4
غیرفعال‌سازی استفاده از پیام‌های SFRBX.
.RE
.sp
SURVEYIN
.RS 4
غیرفعال‌سازی حالت نقشه‌برداری (survey\-in) با TMODE2.
.RE
.sp
TP
.RS 4
غیرفعال‌سازی ارسال UBX\-TIM\-TP.
.RE
.RE
.sp
\fB\-e OPTION\fP, \fB\-\-enable OPTION\fP
.RS 4
فعال‌سازی یک گزینه در GPS. یک پارامتر OPTION را برای فعال‌سازی می‌پذیرد. این گزینه مقادیر مشابه \fB\-d\fP را می‌پذیرد با این تفاوت که عملکرد آن فعال‌سازی است.
.RE
.sp
\fB\-f FILE\fP, \fB\-\-file FILE\fP
.RS 4
اتصال مستقیم به یک فایل یا دستگاه. یک پارامتر FILE که نام فایل یا دستگاه مدنظر است را می‌پذیرد. فایل‌ها به صورت فقط‌خواندنی باز می‌شوند. دستگاه‌های کاراکتری به صورت خواندنی/نوشتنی باز می‌شوند مگر آنکه پارامتر \fB\-r\fP داده شده باشد. نیازمند ماژول pyserial است.
.RE
.sp
\fB\-g ITEM,LAYER,POSITION,END\fP, \fB\-\-getitem ITEM,LAYER,POSITION,END\fP
.RS 4
دریافت مقدار ITEM از لایه LAYER، شروع از POSITION تا حداکثر END جفت کلید/مقدار (UBX\-CFG\-VALGET). تمام پارامترهای پس از ITEM اختیاری و به صورت ده‌دهی هستند. اگر LAYER مشخص نشود، لایه‌های ۰، ۱، ۲ و ۷ همگی درخواست داده می‌شوند. بخش «آیتم‌های پیکربندی» را ببینید.
.RE
.sp
\fB\-\-host HOST\fP
.RS 4
اتصال به \fBgpsd\fP روی میزبان HOST (سرور). پیش‌فرض localhost است.
.RE
.sp
\fB\-i port\fP, \fB\-\-portid port\fP
.RS 4
مشخص کردن شناسه درگاه (رابط کاربری) برای دستورات مرتبط با درگاه نظیر UBX_CFG\-PRT.
.RE
.sp
\fB\-p PRESET\fP, \fB\-\-preset PRESET\fP
.RS 4
ارسال یک دستور پیش‌تنظیم به GPS. معمولاً یک پارامتر PRESET شامل نام دستور ارسالی دریافت می‌کند. برخی پیش‌تنظیم‌ها مانند LOG\-FINDTIME پارامترهای اضافی جداشده با کاما می‌پذیرند. می‌توان از چندین گزینه \-p به صورت همزمان استفاده کرد.
.RE
.sp
در اینجا فقط پیش‌تنظیم‌های متداول آورده شده‌اند. برای مشاهده فهرست کامل به همراه پارامترهای اختیاری، دستور "ubxtool \-h \-v 2" را اجرا کنید.
.sp
COLDBOOT
.RS 4
راه‌اندازی سرد (Coldboot) گیرنده GPS با دستور UBX\-CFG\-RST.
.RE
.sp
HOTBOOT
.RS 4
راه‌اندازی گرم (Hotboot) گیرنده GPS با دستور UBX\-CFG\-RST.
.RE
.sp
MODEL,model
.RS 4
پیکربندی مدل سکوی پویا (Dynamic Platform Model) به مقدار model (دستور UBX\-CFG\-NAV5). مقدار model عدد ده‌دهی حالت مورد نظر است.
.RE
.sp
PMS
.RS 4
تنظیمات مدیریت مصرف توان (UBX\-CFG\-PMS). به صورت "PMS,pow" که pow مقدار powerSetupValue است.
.RE
.sp
RATE
.RS 4
تنظیم نرخ اندازه‌گیری و ناوبری (UBX\-CFG\-RATE). به صورت "RATE,meas,nav" که meas نرخ اندازه‌گیری بر حسب میلی‌ثانیه و nav نرخ ناوبری بر حسب چرخه با پیش‌فرض ۱ است.
.RE
.sp
RESET
.RS 4
بازنشانی پیکربندی به مقادیر پیش‌فرض (UBX\-CFG\-CFG).
.RE
.sp
SAVE
.RS 4
ذخیره پیکربندی فعلی (UBX\-CFG\-CFG).
.RE
.sp
MON\-RESETODO
.RS 4
بازنشانی مسافت‌سنج (odometer) با دستور UBX\-MON\-RESETODO.
.RE
.sp
MON\-VER
.RS 4
استعلام نسخه و مشخصات GPS با دستور UBX\-MON\-VER.
.RE
.sp
WARMBOOT
.RS 4
راه‌اندازی ولرم (Warmboot) گیرنده GPS با دستور UBX\-CFG\-RST.
.RE
.sp
بیشتر پارامترهای PRESET دستورات ساده استعلام هستند. این دستورات صرفاً از GPS می‌خواهند که با پیام مربوطه پاسخ دهد. به عنوان مثال دستور "ubxtool \-p CFG\-GNSS" از GPS می‌خواهد با پیام UBX\-CFG\-GNSS که پیکربندی فعلی GNSS را شرح می‌دهد پاسخ دهد. برای افزایش جزئیات خروجی از گزینه‌های "\-v 2" یا "\-v 3" استفاده کنید.
.sp
\fB\-\-port PORT\fP
.RS 4
استفاده از درگاه PORT برای اتصال به \fBgpsd\fP. مقدار پیش‌فرض ۲۹۴۷ است.
.RE
.sp
\fB\-P protver\fP, \fB\-\-protver protver\fP
.RS 4
تعیین نسخه پروتکل برای ارسال دستورات. حداقل ۶ (Antaris 4). از "ubxtool \-p MON\-VER" برای مشاهده نسخه پشتیبانی‌شده توسط گیرنده استفاده کنید. بسیاری از گیرنده‌های جدیدتر u\-blox در صورت عدم تنظیم صحیح این مقدار، در سکوت یا به شکل غیرعادی با شکست مواجه می‌شوند. پیش‌فرض ۱۰ (u\-blox 5) است.
.RE
.sp
\fB\-r\fP, \fB\-readonly\fP
.RS 4
حالت فقط‌خواندنی. هیچ داده‌ای به GPS ارسال نمی‌شود.
.RE
.sp
\fB\-R RAW\fP, \fB\-\-rawfile RAW\fP
.RS 4
ذخیره تمام داده‌های خام سریال دریافت شده از GPS در فایل RAW.
.RE
.sp
\fB\-s SPEED\fP, \fB\-\-inspeed SPEED\fP
.RS 4
تنظیم سرعت درگاه سریال محلی به SPEED بیت بر ثانیه (bps). مقدار پیش‌فرض ۹۶۰۰ است.
.RE
.sp
\fB\-S SPEED\fP, \fB\-\-setspeed SPEED\fP
.RS 4
تنظیم سرعت درگاه سریال گیرنده GPS به SPEED بیت بر ثانیه (bps).
.RE
.sp
\fB\-t\fP, \fB\-\-timestamp\fP
.RS 4
درج برچسب زمانی روی پیام‌های رمزگشایی‌شده به صورت ثانیه‌های سپری‌شده از مبدأ زمان (epoch). با دو بار استفاده از این گزینه، زمان UTC نیز نمایش داده می‌شود.
.RE
.sp
\fB\-v VERBOSITY\fP, \fB\-\-verbosity VERBOSITY\fP
.RS 4
تعیین سطح جزئیات به مقدار VERBOSITY. سطح جزئیات می‌تواند از ۰ (بسیار کم)، ۲ (رمزگشایی پیام‌ها)، تا ۴ (بسیار پرجزئیات) باشد. پیش‌فرض ۱ است.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه \fBubxtool\fP و خروج.
.RE
.sp
\fB\-w WAIT\fP, \fB\-\-wait WAIT\fP
.RS 4
انتظار به مدت WAIT ثانیه پیش از خروج. برای انتظار نامحدود مقدار ۰ را وارد کنید. پیش‌فرض ۲ ثانیه است.
.RE
.sp
\fB\-x ITEM,LAYERS\fP, \fB\-\-delitem ITEM,LAYERS\fP
.RS 4
حذف مقدار ITEM از لایه‌های LAYERS. نگاشت بیتی LAYERS اختیاری است. به طور پیش‌فرض، حذف در هر دو لایه BBR و FLASH در گیرنده انجام می‌شود (UBX_CFG\-VALDEL) و مقدار پیش‌فرض گیرنده برای آن آیتم بازیابی می‌گردد. بخش «آیتم‌های پیکربندی» را ببینید.
.RE
.sp
\fB\-z ITEM,VAL,LAYERS\fP, \fB\-\-setitem ITEM,VAL,LAYERS\fP
.RS 4
تنظیم مقدار ITEM به VAL در لایه‌های LAYERS در GPS (دستور UBX\-CFG\-VALSET). مقادیر VAL و ماسک بیتی LAYERS به صورت ده‌دهی هستند. مقدار ",LAYERS" اختیاری است. لایه‌های پیش‌فرض RAM و FLASH هستند. بخش «آیتم‌های پیکربندی» را ببینید.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP که روی localhost و درگاه پیش‌فرض ۲۹۴۷ اجرا می‌شود جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را تغییر دهد: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات و مثال‌های بیشتر، بخش \fBARGUMENTS\fP در صفحه راهنمای \fBgps\fP(1) را ببینید.
.SH "آیتم‌های پیکربندی (CONFIGURATION ITEMS)"
.sp
پیکربندی GPSهای u\-blox با پیام‌های پیکربندی سنتی با مشکلات زیادی همراه است. بسیاری از پیام‌های پیکربندی به روش‌های عجیبی با یکدیگر تداخل دارند. کاری به سادگی تغییر سرعت درگاه سریال نیازمند این است که پیکربندی فعلی را با استفاده از UBX\-CFG\-PRT برای درگاه مربوطه بخوانید، تغییر را با آن ادغام کنید، و سپس پیام تغییریافته UBX\-CFG\-PRT را بازنویسی کنید؛ یا صرفاً پیکربندی فعلی را حدس زده و همه چیز را بازنویسی کنید.
.sp
سری u\-blox 9 با نسخه پروتکل +27 سعی کرده است (هرچند نه به طور کامل) این مشکل را با «آیتم‌های پیکربندی» (Configuration Items) برطرف کند. اگر GPS شما از نسخه پروتکل ۲۷ یا بالاتر پشتیبانی نمی‌کند، این بخش شامل دستگاه شما نمی‌شود.
.sp
به بیشتر متغیرهای پیکربندی در GPS یک شناسه کلید (Key ID) ۳۲ بیتی اختصاص داده شده است. هر کلید به یک مقدار خاص ارجاع می‌دهد. یک گیرنده معمولی ممکن است بیش از ۱۱۰۰ شناسه کلید داشته باشد. به هر Key ID یک نام کلید (Key Name) اختصاص یافته است. بیشتر نام‌های کلیدها توسط u\-blox مستندسازی شده و توسط \fBubxtool\fP پشتیبانی می‌شوند. برای مشاهده تمام نام‌های کلیدهای شناخته‌شده توسط \fBubxtool\fP دستور "ubxtool \-h \-v 3" را اجرا کنید.
.sp
برای دریافت مقدار مرتبط با یک آیتم، از "\-g ITEM" استفاده کنید.
.sp
برای بازنشانی مقدار یک آیتم به مقدار پیش‌فرض آن، از "\-x ITEM" استفاده کنید.
.sp
برای تنظیم مقدار یک ITEM، از "\-z ITEM,VAL" استفاده کنید.
.sp
اگر می‌خواهید یک ITEM را فقط در یک لایه تنظیم کنید، از "\-z ITEM,VAL,LAYER" استفاده کنید.
.sp
برای نمونه‌های عینی، بخش «مثال‌ها» را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.sp
تمامی مثال‌ها فرض می‌کنند که متغیر محیطی UBXOPTS با نسخه پروتکل گیرنده شما تنظیم شده است. حتماً مقدار "\-P 18" را با نسخه پروتکل صحیح خود جایگزین کنید.
.sp
.if n .RS 4
.nf
.fam C
export UBXOPTS="\-P 18"
.fam
.fi
.if n .RE
.sp
دریافت و ذخیره پیکربندی و وضعیت گیرنده GNSS. گزینه "\-w 4" برای فراهم کردن زمان کافی جهت تکمیل عملیات است.
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-p CONFIG \-p STATUS \-w 4 \-v 2
.fam
.fi
.if n .RE
.sp
رمزگشایی فایل لاگ خام:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-r \-f ublox\-neo\-m8n.log
.fam
.fi
.if n .RE
.sp
تغییر سرعت درگاه GPS دستگاه روی /dev/ttyAMA0 به ۲۳۰۴۰۰ بیت بر ثانیه:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-S 230400 \-f /dev/ttyAMA0
.fam
.fi
.if n .RE
.sp
مشاهده کل چرخه بازنشانی GPS، شامل پیام‌های $GPTXT:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-p COLDBOOT \-w 20 \-v 2
.fam
.fi
.if n .RE
.sp
استعلام منظومه‌های فعال:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-p CFG\-GNSS
.fam
.fi
.if n .RE
.sp
دریافت داده‌های \fBgpsd\fP از یک سرور دوردست با نام x.example.com:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-w 5 x.example.com
.fam
.fi
.if n .RE
.SS "CFG\-TP5"
.sp
برخی از دستورات "\-p" و "\-\-preset" می‌توانند چندین گزینه دریافت کنند. یکی از این موارد "\-\-preset CFG\-TP5" است.
.sp
خلاصه ساختار:
.sp
.if n .RS 4
.nf
.fam C
\-p CFG\-TP5,[tpIdx = 0],[antCableDelay = 2],[rfGroupDelay = 0],[freqPeriod = 1000000],[freqPeriodLock = 1000000],[pulseLenRatio = 0],[pulseLenRatioLock = 100000],[userConfigDelay = 0],[flags = 0x77]
.fam
.fi
.if n .RE
.sp
یک پارامتر مکانی را خالی بگذارید تا مقدار پیش‌فرض آن اعمال شود.
.sp
برای تنظیم دوره پالس روی ۰٫۲۵ ثانیه و طول آن روی ۰٫۱ ثانیه:
.sp
.if n .RS 4
.nf
.fam C
$ ubxtool \-p CFG\-TP5,,,,250000,250000,100000,100000
.fam
.fi
.if n .RE
.sp
برای تنظیم دوره پالس روی ۰٫۱ ثانیه و طول آن روی ۰٫۱ ثانیه در صورت قفل بودن:
.sp
.if n .RS 4
.nf
.fam C
$ ubxtool \-p CFG\-TP5,,,,,100000,,50000
.fam
.fi
.if n .RE
.SS "مثال‌های نسخه ۲۷ به بالا (Version 27+ examples)"
.sp
مثال‌های زیر نیازمند گیرنده‌ای هستند که از پروتکل ۲۷ یا بالاتر پشتیبانی کند. حتماً ابتدا نسخه پروتکل خود را مشخص کنید:
.sp
.if n .RS 4
.nf
.fam C
    export UBXOPTS="\-P 32"
.fam
.fi
.if n .RE
.sp
برای بررسی مدل دینامیک فعلی، تغییر آن به ۶ (AIR1، هوابرد با شتاب کمتر از 1g)، بازگشت به تنظیمات پیش‌فرض و تأیید بازگشت تنظیمات:
.sp
.if n .RS 4
.nf
.fam C
$ ubxtool \-g CFG\-NAVSPG\-DYNMODEL
[...]
UBX\-CFG\-VALGET:
 version 1 layer 0 reserved 0,0
  layers (ram)
    item CFG\-NAVSPG\-DYNMODEL/0x20110021 val 2
[...]
$ ubxtool \-z CFG\-NAVSPG\-DYNMODEL,6
[...]
UBX\-ACK\-ACK:
 ACK to Class x6 (CFG) ID x8a (VALSET)
[...]
$ ubxtool \-g CFG\-NAVSPG\-DYNMODEL
[...]
UBX\-CFG\-VALGET:
 version 1 layer 0 reserved 0,0
  layers (ram)
    item CFG\-NAVSPG\-DYNMODEL/0x20110021 val 6
[...]
$ ubxtool \-x CFG\-NAVSPG\-DYNMODEL
[...]
UBX\-ACK\-ACK:
 ACK to Class x6 (CFG) ID x8c (VALDEL)
[...]
$ ubxtool \-g CFG\-NAVSPG\-DYNMODEL
[...]
UBX\-CFG\-VALGET:
 version 1 layer 0 reserved 0,0
  layers (ram)
    item CFG\-NAVSPG\-DYNMODEL/0x20110021 val 6
.fam
.fi
.if n .RE
.sp
توجه کنید که DYNMODEL فعلی روی ۶ (AIR1) باقی ماند. گزینه "\-x" تنها روی تنظیمات ذخیره‌شده تأثیر می‌گذارد، نه تنظیمات جاری. برای تغییر تنظیم جاری باید آن را با "\-z" تعیین کنید.
.sp
دریافت تمام آیتم‌های پیکربندی یک گروه به صورت تک‌تک بسیار زمان‌بر و دشوار است. گزینه VAL\-GET به شما امکان می‌دهد شماره آیتم را با نویسه عام (wildcard) تعیین کرده و تمام آیتم‌های یک گروه را استخراج کنید. برای دریافت تمام آیتم‌های CFG\-TP در حافظه ram (آیتم‌های فعال فعلی)، می‌توانید چنین عمل کنید:
.sp
.if n .RS 4
.nf
.fam C
$ ubxtool \-g CFG\-TP,0
[...]
UBX\-CFG\-VALGET:
 version 1 layer 0 position 0
  layers (ram)
    item CFG\-TP\-TP1_ENA/0x10050007 val 1
    item CFG\-TP\-SYNC_GNSS_TP1/0x10050008 val 1
    item CFG\-TP\-USE_LOCKED_TP1/0x10050009 val 1
[...]
.fam
.fi
.if n .RE
.sp
افرادی که می‌خواهند تمام آیتم‌های پیکربندی را استخراج کنند می‌توانند گروه را به صورت عام مشخص کنند. استخراج بیش از ۱۰۰۰ آیتم به صورت بسته‌های ۶۴تایی همچنان ممکن است زمان‌بر باشد. پارامتر \-g اختیاری به شما اجازه می‌دهد موقعیت شروع و پایان را مشخص کنید. برای دریافت تمام آیتم‌های شناخته‌شده و ناشناخته پشتیبانی‌شده توسط گیرنده که در حال حاضر در ram هستند:
.sp
.if n .RS 4
.nf
.fam C
$ ubxtool \-g CFG,0,0,1200 | fgrep "item CFG\-"
    item CFG\-1\-1/0x10010001 val 0
    item CFG\-1\-1/0x10010101 val 0
    item CFG\-4\-1/0x10040001 val 1
    item CFG\-4\-2/0x10040002 val 0
    item CFG\-4\-3/0x10040003 val 0
    item CFG\-4\-4/0x10040004 val 0
    item CFG\-4\-9/0x10040009 val 0
    item CFG\-TP\-TP1_ENA/0x10050007 val 1
    item CFG\-TP\-SYNC_GNSS_TP1/0x10050008 val 1
[...]
.fam
.fi
.if n .RE
.sp
تغییر CFG,0,0,1200 به CFG,7,0,1200 در عوض مقادیر پیش‌فرض پیکربندی را از لایه پیش‌فرض (۷) استخراج می‌کند.
.SH "محیط (ENVIRONMENT)"
.sp
گزینه‌ها می‌توانند در متغیر محیطی UBXOPTS قرار گیرند. متغیر UBXOPTS پیش از گزینه‌های خط فرمان پردازش می‌شود.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
ابزار \fBubxtool\fP مطابق با مستندات رسمی u\-blox برای پروتکل باینری u\-blox نوشته شده است.
.URL "https://www.u\-blox.com/en/product\-resources" "" ""
.sp
\fBgpsd\fP(8), \fBgpsctl\fP(1), \fBgps\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق کپی‌رایت این سند متعلق به پروژه GPSD سال 2013 است.
.br
شناسه پروانه: SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Gary E. Miller