2007-10-15 00:52:59 +00:00
|
|
|
Hamlib - (C) Frank Singleton 2000 (vk3fcs@ix.netcom.com)
|
2011-01-13 12:08:12 +00:00
|
|
|
(C) Stephane Fillod 2000-2011
|
|
|
|
(C) The Hamlib Group 2000-2011
|
2010-01-28 22:44:56 +00:00
|
|
|
|
|
|
|
The purpose of this project is to provide stable, flexible, shared libraries
|
|
|
|
that enable quicker development of Amateur Radio Equipment Control
|
|
|
|
Applications.
|
|
|
|
|
|
|
|
Many Amateur Radio Transceivers come with serial interfaces that allows
|
|
|
|
software to control the radio. This project will endeavour to provide shared
|
2011-02-01 16:31:20 +00:00
|
|
|
libraries that greatly simplify the application programmer's interaction
|
|
|
|
with radio equipment and other controllable devices such as rotators,
|
|
|
|
switches, etc.
|
2010-01-28 22:44:56 +00:00
|
|
|
|
|
|
|
Supported Radios
|
|
|
|
----------------
|
|
|
|
|
|
|
|
The Hamlib Wiki page, Supported Radios, contains a snapshot of the supported
|
|
|
|
radio at the time of the last Hamlib release. Go to http://www.hamlib.org
|
|
|
|
to reach the Wiki.
|
|
|
|
|
|
|
|
Hamlib Design
|
|
|
|
-------------
|
2000-09-24 02:15:52 +00:00
|
|
|
|
2000-07-18 20:55:08 +00:00
|
|
|
The shared libs will provide functions for both radio control,
|
|
|
|
and data retrieval from the radio.
|
2010-01-28 22:44:56 +00:00
|
|
|
|
2000-09-24 02:15:52 +00:00
|
|
|
The structure of the libraries will be as follows.
|
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
(1) There will be 1 frontend library "libhamlib" that
|
|
|
|
provides the generic API for user applications.
|
2000-09-24 02:15:52 +00:00
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
(2) There will be "n" backend libraries that "wrap"
|
|
|
|
rig specific communications inside frontend API.
|
2000-09-24 02:15:52 +00:00
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
(3) Frontend lib will load (on demand) the appropriate
|
|
|
|
backend lib as required.
|
2000-09-24 02:15:52 +00:00
|
|
|
|
|
|
|
Frontend Library
|
|
|
|
----------------
|
|
|
|
|
|
|
|
libhamlib.so - frontend lib that provides generic API
|
2010-01-28 22:44:56 +00:00
|
|
|
for all RIG types. This is what Application
|
|
|
|
programmers will "see".
|
2000-09-24 02:15:52 +00:00
|
|
|
|
|
|
|
Backend Examples are:
|
|
|
|
---------------------
|
2010-01-28 22:44:56 +00:00
|
|
|
|
2003-04-28 06:34:58 +00:00
|
|
|
1.hamlib-yaesu.so will provide connectivity to Yaesu
|
2001-09-20 21:18:30 +00:00
|
|
|
FT 747GX Transceiver, FT 847 "Earth Station", etc. via a standard API.
|
2000-07-18 20:55:08 +00:00
|
|
|
|
2003-04-28 06:34:58 +00:00
|
|
|
2. hamlib-xxxx.so will provide connectivity to the Wiz-bang
|
2000-07-18 20:55:08 +00:00
|
|
|
moon-melter 101A (yikes..)
|
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
Hamlib will also enable developers to develop professional looking GUI's
|
|
|
|
towards a standard control library API, and they would not have to worry
|
2006-07-10 16:15:12 +00:00
|
|
|
about the underlying connection towards physical hardware.
|
2010-01-28 22:44:56 +00:00
|
|
|
|
|
|
|
Initially serial (RS232) connectivity will be handled, but we expect that IP
|
|
|
|
(and other) connectivity will follow afterwards. Connection via a USB port
|
|
|
|
is accomplished via the Linux kernel support. USB to serial converters are
|
|
|
|
well supported. Other such devices may be supported as long as they present
|
|
|
|
a serial (RS-232) interface to Hamlib.
|
2000-07-18 20:55:08 +00:00
|
|
|
|
2001-09-20 21:18:30 +00:00
|
|
|
Recompiling
|
|
|
|
-----------
|
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
Hamlib is entirely developed using GNU tools, under various Linux systems.
|
2011-02-01 16:31:20 +00:00
|
|
|
That is, if you want to take part in the development of Hamlib, you'll need
|
2010-01-28 22:44:56 +00:00
|
|
|
at least the following tools:
|
|
|
|
* autoconf > 2.54
|
|
|
|
* automake > 1.7
|
|
|
|
* libtool > 1.5|2.2.6
|
|
|
|
* doxygen
|
|
|
|
* svn and ssh to connect to http://sourceforge.net/
|
|
|
|
|
|
|
|
There are also the README.betatester and README.developer files in this
|
2011-02-01 16:31:20 +00:00
|
|
|
directory if you feel like testing or hacking Hamlib. Otherwise,
|
|
|
|
contributions of rig specifications and protocol documentation are highly
|
|
|
|
encouraged. Do keep in mind that in some cases the manufacturer may not
|
|
|
|
provide complete control information or it is only available under a
|
|
|
|
Non-Disclosure Agreement (NDA). Any documentation *must* be publicly
|
|
|
|
available so we can legally write and distribute Free Software supporting a
|
|
|
|
given device.
|
2010-01-28 22:44:56 +00:00
|
|
|
|
2011-02-01 16:31:20 +00:00
|
|
|
However, if you just want to recompile the library, please refer to the
|
|
|
|
INSTALL and README.betatester files.
|
2010-01-28 22:44:56 +00:00
|
|
|
|
|
|
|
IMPORTANT: If autoconf or automake are installed on your system, make sure
|
|
|
|
they are matching *at least* the version shown above. The Hamlib team is
|
2011-02-01 16:31:20 +00:00
|
|
|
very interested to hear from you, how Hamlib builds and works on your
|
|
|
|
system, especially on non-Linux system or non-PC systems. We try to make
|
|
|
|
Hamlib as portable as possible.
|
2006-07-10 16:15:12 +00:00
|
|
|
|
2001-09-20 21:18:30 +00:00
|
|
|
Please report in case of problems at hamlib-developer@lists.sourceforge.net
|
2011-02-01 16:31:20 +00:00
|
|
|
Patches in unified diff format are welcome too!
|
2001-09-20 21:18:30 +00:00
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
Most distributions have the latest Hamlib release in their testing or alpha
|
|
|
|
versions of their distribution. Check your package manager for the Hamlib
|
|
|
|
version included in your distribution.
|
2001-09-20 21:18:30 +00:00
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
Take a look at tests/README for more info on simple programming examples and
|
|
|
|
test programs.
|
2000-08-20 21:52:27 +00:00
|
|
|
|
2011-02-01 16:31:20 +00:00
|
|
|
Also, take a look at http://sourceforge.net/projects/hamlib/ Here you will
|
|
|
|
find a mail list, and the latest releases. Feedback, questions, etc. about
|
|
|
|
Hamlib are very welcome at the mail list:
|
2010-01-28 22:44:56 +00:00
|
|
|
<hamlib-developer@lists.sourceforge.net>
|
2000-08-20 21:52:27 +00:00
|
|
|
|
2010-01-28 22:44:56 +00:00
|
|
|
Have Fun / Frank S / Stephane F / The Hamlib Group
|
2000-07-18 20:55:08 +00:00
|
|
|
|
2001-09-20 21:18:30 +00:00
|
|
|
73's de vk3fcs/km5ws / f8cfe
|
2000-10-07 20:52:22 +00:00
|
|
|
|