kopia lustrzana https://github.com/Hamlib/Hamlib
96 wiersze
3.6 KiB
Plaintext
96 wiersze
3.6 KiB
Plaintext
hamlib - (C) Frank Singleton 2000 (vk3fcs@ix.netcom.com)
|
|
and (C) Stephane Fillod 2000-2006
|
|
|
|
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 libraries that greatly simplify
|
|
the application programmer's interaction with radio equipment
|
|
and other controllable devices such as rotators, switches, etc.
|
|
|
|
The shared libs will provide functions for both radio control,
|
|
and data retrieval from the radio.
|
|
|
|
The structure of the libraries will be as follows.
|
|
|
|
(1) There will be 1 frontend library "libhamlib" that
|
|
provides the generic API for user applications.
|
|
|
|
(2) There will be "n" backend libraries that "wrap"
|
|
rig specific communications inside frontend API.
|
|
|
|
(3) Frontend lib will load (on demand) the appropriate
|
|
backend lib as required.
|
|
|
|
Frontend Library
|
|
----------------
|
|
|
|
libhamlib.so - frontend lib that provides generic API
|
|
for all RIG types. This is what Application
|
|
programmers will "see".
|
|
|
|
Backend Examples are:
|
|
---------------------
|
|
|
|
1.hamlib-yaesu.so will provide connectivity to Yaesu
|
|
FT 747GX Transceiver, FT 847 "Earth Station", etc. via a standard API.
|
|
|
|
2. hamlib-xxxx.so will provide connectivity to the Wiz-bang
|
|
moon-melter 101A (yikes..)
|
|
|
|
Hamlib will also enable developers to develop professional looking GUI's
|
|
towards a standard control library API, and they would not have to worry
|
|
about the underlying connection towards physical hardware.
|
|
|
|
Initially serial (RS232) connectivity will be handled, but
|
|
I expect that IP (and other) connectivity will follow afterwards.
|
|
|
|
Recompiling
|
|
-----------
|
|
|
|
Hamlib is entirely developped using GNU tools, under various Linux systems.
|
|
That is, if you want to take part in the development of Hamlib,
|
|
you'll need at least the following tools:
|
|
* autoconf > 2.50
|
|
* automake > 1.7
|
|
* libtool > 1.5
|
|
* doxygen
|
|
* cvs and ssh to connect to http://sourceforge.net/
|
|
|
|
There are also the README.betatester and README.developer files in this
|
|
directory if you feel like 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 publically available so we can legally write and
|
|
distribute Free Software supporting a given device.
|
|
|
|
However, if you just want to recompile the library, please refer
|
|
to the INSTALL file. 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 very interrested 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.
|
|
|
|
Please report in case of problems at hamlib-developer@lists.sourceforge.net
|
|
Patches are welcome too!
|
|
|
|
And for those who were brave enough to read until here, but not lucky enough
|
|
to rebuild the lib, there is good news. The RPM and deb packages are
|
|
available at the sourceforge.net site. Enjoy!
|
|
|
|
Take a look at tests/README for more info on simple examples.
|
|
|
|
Also, take a look at http://sourceforge.net/projects/hamlib/
|
|
Here you will find a mail list, and the latest CVS releases.
|
|
Feedback, questions, etc. about Hamlib are very welcome
|
|
at the mail list: <hamlib-developer@lists.sourceforge.net>
|
|
|
|
Have Fun / Frank S / Stephane F
|
|
|
|
73's de vk3fcs/km5ws / f8cfe
|
|
|