نام (NAME)

rigmem - پشتیبان‌گیری و بازیابی حافظه فرستنده‌-گیرنده‌ها و گیرنده‌های رادیویی

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

rigmem [-ahvVx] [-m id] [-r device] [-s baud] [-c id] [-C parm=val] [-p sep] command [file]

توضیحات (DESCRIPTION)

پشتیبان‌گیری و بازیابی حافظه فرستنده‌-گیرنده‌ها و گیرنده‌های رادیویی. دستور rigmem دستورات (command) را فقط از خط فرمان می‌پذیرد.

به یاد داشته باشید که Hamlib نرم‌افزاری در سطح بتا (BETA) است. گرچه بسیاری از کتابخانه‌های بک‌اند فاقد پشتیبانی کامل از تمام رادیوها هستند، اما توابع پایه معمولاً به خوبی پشتیبانی می‌شوند.

لطفاً اشکالات را گزارش داده و بازخورد خود را به نشانی ایمیل ارائه‌شده در بخش اشکالات (BUGS) در زیر ارسال کنید. وصله‌ها و بهبودهای کد ارسالی به همین نشانی با استقبال پذیرفته می‌شوند.

گزینه‌ها (OPTIONS)

این برنامه از نحو مرسوم خط فرمان GNU پیروی می‌کند. گزینه‌های کوتاهی که آرگومان می‌پذیرند می‌توانند مقدار را بلافاصله پس از خود داشته باشند یا با یک فاصله جدا شوند. گزینه‌های بلندی که با دو خط تیره (‘-’) آغاز می‌شوند نیازمند یک علامت مساوی (‘=’) بین گزینه و آرگومان هستند.

خلاصه‌ای از گزینه‌های پشتیبانی‌شده در ادامه آمده است:

-m, --model=id: انتخاب شماره مدل رادیو.

: مشاهده فهرست مدل‌ها (از “rigctl -l” استفاده کنید).

-r, --rig-file=device: استفاده از device به عنوان نام فایل پورتی که به رادیو متصل است.

: معمولاً یک پورت سریال است، اما می‌تواند یک مبدل USB به سریال باشد. به طور معمول /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0 و غیره در لینوکس، COM1, COM2 و غیره در ویندوز. توزیع‌های BSD و Mac OS/X نام‌گذاری‌های خاص خود را دارند. مستندات سیستم خود را بررسی کنید.

-s, --serial-speed=baud: تنظیم سرعت سریال رادیو بر روی نرخ baud.

: به طور پیش‌فرض از حداکثر سرعت سریال قابلیت‌های بک‌اند رادیو استفاده می‌کند.

-c, --civaddr=id: استفاده از id به عنوان آدرس CI-V جهت برقراری ارتباط با رادیو.

: تنها برای رادیوهای Icom و برخی رادیوهای Ten-Tec کاربرد دارد.
: نکته: مقدار id به صورت ده‌دهی (decimal) است، مگر اینکه با پیشوند 0x همراه باشد که در این صورت هگزادسیمال در نظر گرفته می‌شود.

-C, --set-conf=parm=val[,parm=val]: تنظیم پارامتر(های) پیکربندی رادیو، به عنوان مثال stop_bits=2.

: از گزینه -L در rigctl برای دریافت فهرست پارامترهای پیکربندی یک شماره مدل خاص استفاده کنید.

-p, --set-separator=sep: تنظیم کاراکتر به عنوان جداکننده ستون‌ها به جای کامای CSV.

: برخی جایگزین‌های متداول عبارتند از خط عمودی (pipe)، ‘|’، نقطه‌ویرگول، ‘;’ و دو‌نقطه، ‘:’.

-a, --all: دور زدن mem_caps، اعمال بر روی تمام فیلدهای channel_t.
-x, --xml: استفاده از قالب XML به جای CSV، در صورت در دسترس بودن libxml2.
-v, --verbose: تنظیم حالت پرگو (verbose)، افزایشی و تجمعی (بخش عیب‌یابی (DIAGNOSTICS) در زیر را ببینید).
-h, --help: نمایش خلاصه‌ای از این گزینه‌ها و خروج.
-V, --version: نمایش نسخه rigmem و خروج.

نکته: برخی از گزینه‌ها ممکن است توسط یک بک‌اند مشخص پیاده‌سازی نشده باشند و خطایی بازگردانند. این مورد بیشتر برای گزینه --set-conf رخ می‌دهد.

دستورات (COMMANDS)

پشتیبان‌گیری و بازیابی برای فایل پایه CSV و قالب XML (در صورت در دسترس بودن) پشتیبانی می‌شوند.

لطفاً توجه داشته باشید که بک‌اند رادیوی تحت کنترل، یا خود دستگاه رادیو ممکن است از برخی دستورات پشتیبانی نکند. در چنین شرایطی، عملیات با یک پیام خطای Hamlib با شکست مواجه خواهد شد.

خلاصه‌ای از دستورات پشتیبانی‌شده در ادامه آمده است:

save file: ذخیره تمام محتوای حافظه در یک فایل CSV (یا XML) که به عنوان آرگومان به دستور داده می‌شود.
load file: بارگذاری محتوا در تمام حافظه از یک فایل CSV (یا XML) که به عنوان آرگومان به دستور داده می‌شود.
save_parm file: ذخیره تمام پارامترهای رادیو در یک فایل CSV (یا XML) که به عنوان آرگومان به دستور داده می‌شود.
load_parm file: بارگذاری پارامترهای رادیو از یک فایل CSV (یا XML) که به عنوان آرگومان به دستور داده می‌شود.
clear: این یک دستور بسیار خطرناک است، زیرا تمام مواردی را که در حافظه رادیوی خود برنامه‌ریزی کرده‌اید به طور کامل پاک خواهد کرد. تمام داده‌ها از دست خواهند رفت. مسئولیت استفاده از آن بر عهده خودتان است!

عیب‌یابی (DIAGNOSTICS)

گزینه -v, --verbose امکان می‌دهد سطوح مختلفی از اطلاعات عیب‌یابی در stderr چاپ شود که مطابق است با -v برای BUG, -vv برای ERR, -vvv برای WARN, -vvvv برای VERBOSE یا -vvvvv برای TRACE.

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

وضعیت خروج (EXIT STATUS)

دستور rigmem با این کدهای وضعیت خارج می‌شود:

0: اگر تمام عملیات‌ها به طور عادی تکمیل شده باشند؛
1: اگر یک گزینه یا آرگومان خط فرمان نامعتبر وجود داشته باشد؛
2: اگر خطایی از سوی Hamlib بازگردانده شده باشد؛
3: بک‌اند Hamlib پشتیبانی از حافظه را پیاده‌سازی نکرده است و/یا رادیو دسترسی حافظه ندارد.

اشکالات (BUGS)

گزارش اشکالات به:


لیست ایمیل توسعه‌دهندگان Hamlib

حق نشر (COPYING)

این فایل بخشی از Hamlib است؛ پروژه‌ای برای توسعه کتابخانه‌ای که توابع کنترل رادیو، روتاتور و تقویت‌کننده را برای توسعه‌دهندگان نرم‌افزارهایی که عمدتاً مورد علاقه رادیوآماتورها و علاقه‌مندان به ارتباطات رادیویی هستند، ساده‌سازی می‌کند.

این یک نرم‌افزار آزاد است؛ شرایط تکثیر را در فایل COPYING ببینید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

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

rigctl(1), hamlib(7)

شناسنامه (COLOPHON)

پیوندها به ویکی Hamlib، مخزن گیت، بایگانی‌های نسخه‌های منتشرشده و بایگانی اسنپ‌شات‌های روزانه از طریق hamlib.org در دسترس هستند.