rigmem(1)

1RIGMEM(1)                   Radio Memory Operations                  RIGMEM(1)
2
3
4

NAME

6       rigmem - backup and restore memory of radio transceivers and receivers
7

SYNOPSIS

9       rigmem [OPTION]... [COMMAND]...
10

DESCRIPTION

12       Backup  and restore memory of radio transceivers and receivers.  rigmem
13       accepts commands from the command line only.
14
15       Keep in mind that Hamlib is BETA level software.  While a lot of  back‐
16       end  libraries  lack complete rig support, the basic functions are usu‐
17       ally well supported.  The API may  change  without  publicized  notice,
18       while  an  advancement of the minor version (e.g. 1.1.x to 1.2.x) indi‐
19       cates such a change.
20
21       Please report bugs and provide feedback at the e-mail address given  in
22       the  REPORTING  BUGS  section.   Patches and code enhancements are also
23       welcome.
24

OPTIONS

26       This program follows the usual  GNU  command  line  syntax,  with  long
27       options starting with two dashes (`-').
28
29       Here is a summary of the supported options:
30
31       -m, --model=id
32              Select radio model number. See model list (use 'rigctl -l').
33              NB:  rigmem  (or  third  party software) will use rig model 1901
34              when using rpc.rigd.
35
36       -r, --rig-file=device
37              Use device as the file name of the port the radio is  connected.
38              Often a serial port, but could be a USB to serial adapter.  Typ‐
39              ically /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0, etc.
40
41       -s, --serial-speed=baud
42              Set serial speed to baud rate. Uses maximum  serial  speed  from
43              rig backend capabilities as the default.
44
45       -c, --civaddr=id
46              Use  id  as  the  CI-V address to communicate with the rig. Only
47              useful for Icom rigs.
48              NB: the id is in decimal notation, unless  prefixed  by  0x,  in
49              which case it is hexadecimal.
50
51       -C, --set-conf=parm=val[,parm=val]*
52              Set config parameter.  e.g. stop_bits=2
53              Use -L option of rigctl for a list.
54
55       -x, --xml
56              Use XML format instead of CSV, if libxml2 is available.
57
58       -v, --verbose
59              Set verbose mode, cumulative (see DIAGNOSTICS below).
60
61       -h, --help
62              Show a summary of these options and exit.
63
64       -V, --version
65              Show version of rigmem and exit.
66
67       NOTE!  Some  options may not be implemented by a given backend and will
68       return an error.  This is most likely  to  occur  with  the  --set-conf
69       option.
70

COMMANDS

72       Backup  and  restore  are  supported  for basic CSV file and XML format
73       where available.
74
75       Please note that the backend for the radio to  be  controlled,  or  the
76       radio itself may not support some commands. In that case, the operation
77       will fail with a Hamlib error message.
78
79       Here is a summary of the supported commands:
80
81       save   Save all the content of memory in a CSV (or XML) file  given  as
82              an argument to the command.
83
84       load   Load  the  content  into all the memory from a CSV (or XML) file
85              given as an argument to the command.
86
87       save_parm
88              Save all the parameters of the radio in  a  CSV  (or  XML)  file
89              given as an argument to the command.
90
91       load_parm
92              Load  the parameters of the radio from a CSV (or XML) file given
93              as an argument to the command.
94
95       clear  This is a very DANGEROUS command, as it  will  completely  clear
96              out  everything you have programmed in the memory of your radio.
97              ALL DATA WILL BE LOST. Use at your own risk!
98

DIAGNOSTICS

100       The -v, --version option allows different levels of diagnostics  to  be
101       output  to  stderr  and correspond to -v for BUG, -vv for ERR, -vvv for
102       WARN, -vvvv for VERBOSE, or -vvvvv for TRACE.
103
104       A given verbose level is useful for providing needed debugging informa‐
105       tion  to  the email address below.  For example, TRACE output shows all
106       of the values sent to and received from the radio which is very  useful
107       for  radio  backend  library  development  and  may be requested by the
108       developers.
109

EXIT STATUS

111       rigmem exits with:
112       0 if all operations completed normally;
113       1 if there was an invalid command line option or argument;
114       2 if an error was returned by Hamlib.
115

BUGS

117       This empty section...
118

REPORTING BUGS

120       Report bugs to <hamlib-developer@lists.sourceforge.net>.
121       We are already aware of the bug in the previous section :-)
122

AUTHOR

124       Written by Stephane Fillod and the Hamlib Group
125       <http://www.hamlib.org>.
126

COPYRIGHT

128       Copyright © 2000-2007 Stephane Fillod and the Hamlib Group.
129       This is free software; see the source for copying conditions.  There is
130       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
131       PURPOSE.
132