LIbrary for Amateur Radio Equipment Control Applications.
 
 
 
 
 
 
Go to file
(no author) 4db523b3b7 This commit was manufactured by cvs2svn to create tag 'HAMLIB-1-2-1'.
git-svn-id: https://hamlib.svn.sourceforge.net/svnroot/hamlib/tags/HAMLIB-1-2-1@1745 7ae35d74-ebe9-4afe-98af-79ac388436b8
2004-05-19 09:17:35 +00:00
alinco Added checking of return string from rig on set (non-retrieval) commands. 2004-03-15 04:02:08 +00:00
aor Added initial AR7030 support (set_freq) 2004-04-16 19:58:10 +00:00
bindings Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
c++ follow frontend ABI version 2004-02-09 22:05:51 +00:00
debian sync with latest debian package and add tcl, c++, python and perl bindings 2004-05-11 15:48:21 +00:00
doc add event.c, misc tuning 2003-06-22 19:58:59 +00:00
drake fixed basic functions, added many more support 2004-03-10 23:33:48 +00:00
dummy Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
easycomm include fixup, stdio.h is not included by rig.h anymore 2003-10-01 19:32:04 +00:00
flexradio Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
fodtrack * reworked parallel port access: invert logic to make it more natural 2003-09-28 15:34:44 +00:00
gnuradio Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
icom added IC-751 initial suppport 2004-05-18 06:55:06 +00:00
include Try to make rig.h more MS-VC++ friendly 2004-05-19 09:11:34 +00:00
jrc patch from Mark J. Fine, plus generic code and fixes of mine 2004-05-19 08:57:50 +00:00
kachina converted RIG_LEVEL_STRENGTH to RIG_LEVEL_RAWSTR. RIG_LEVEL_STRENGTH is then derived from calibration table 2003-11-16 17:14:44 +00:00
kenwood fixes 2004-05-17 21:01:03 +00:00
kit Initial release 2004-04-16 20:29:51 +00:00
kylix removed autogenerated files, use autogen.sh instead 2002-07-02 18:03:25 +00:00
lib gr_pwin32.m4/config.h fixes 2003-11-16 22:15:38 +00:00
libltdl libtool post fix --SF 2004-02-08 21:19:22 +00:00
lowe include fixup, stdio.h is not included by rig.h anymore 2003-10-01 19:32:04 +00:00
macros libtool 1.5.2-1 upgrade 2004-02-08 17:21:02 +00:00
microtune need for stdc++ 2004-01-15 23:03:24 +00:00
pcr Prepare eventual move from freq_t as a "long long" to a "double" type. 2003-10-20 22:15:02 +00:00
perl deprecated, use swig bindings/ instead 2002-11-05 21:33:16 +00:00
rft added skelton for new backends: tapr(DSP10) and rft(EKD500). 2003-10-07 22:15:49 +00:00
rotorez include fixup, stdio.h is not included by rig.h anymore 2003-10-01 19:32:04 +00:00
rpcrig Fixed same bug in rigctl_get_parm. 2004-03-15 03:30:26 +00:00
rpcrot VPATH building, again 2004-01-15 22:48:29 +00:00
sartek include fixup, stdio.h is not included by rig.h anymore 2003-10-01 19:32:04 +00:00
src generate .DEF file on Win32 systems, needed for MSVC import lib 2004-05-17 22:03:10 +00:00
tapr added skelton for new backends: tapr(DSP10) and rft(EKD500). 2003-10-07 22:15:49 +00:00
tentec Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
tests Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
uniden added BC245 skelton 2004-02-08 16:59:48 +00:00
winradio Added G303 support 2004-04-16 20:08:08 +00:00
yaesu Prefixed misc str* and parse_* calls with rig_ to export them in rig.h 2004-05-17 21:09:45 +00:00
AUTHORS added Berndt 2004-02-08 17:48:37 +00:00
COPYING file creation, basically scratch notes 2000-09-14 00:48:00 +00:00
COPYING.LIB converted to LGPL 2001-07-14 10:16:10 +00:00
ChangeLog regenerated, release update 2003-04-28 06:56:36 +00:00
INSTALL Win32 notes 2004-02-08 17:39:38 +00:00
LICENSE converted to LGPL 2001-07-14 10:16:10 +00:00
Makefile.am Added 'kit' backend, enable winradio build under non-Linux systems 2004-04-16 20:31:04 +00:00
NEWS work done for 1.2.1 2004-05-19 09:15:51 +00:00
PLAN * cosmetic changes 2000-11-01 23:18:11 +00:00
README updates before release 2003-04-28 06:34:58 +00:00
README.betatester more info on autogen.sh, moved cvs checkout info from README.betatester to README.developer 2002-10-29 22:14:58 +00:00
README.developer port status update 2004-02-08 17:40:55 +00:00
Segfault-award typo fixed 2002-09-30 14:55:25 +00:00
THANKS misc 2002-06-17 20:59:51 +00:00
TODO misc 2004-02-16 21:44:37 +00:00
TODO.skeleton Initial revision 2000-07-18 20:55:08 +00:00
autogen.sh grr 2002-11-28 22:45:10 +00:00
configure.ac 1.2.1 release 2004-05-19 09:17:34 +00:00
cvs2cl.pl Initial import for ChangeLog handling 2001-02-01 00:20:12 +00:00
hamlib.m4 cloned from Alsa project, still not thouroughly tested 2002-05-28 21:33:10 +00:00
hamlib.pc.in initial release 2002-10-07 21:37:40 +00:00
hamlib.spec.in Added 'kit' backend 2004-04-16 20:34:05 +00:00
ltmain.sh libtool 1.5.2-1 upgrade 2004-02-08 17:21:02 +00:00
missing libtool 1.5.2-1 upgrade 2004-02-08 17:21:02 +00:00
mkinstalldirs updated to automake-1.7 2002-10-29 22:38:04 +00:00

README

hamlib - (C) Frank Singleton 2000 (vk3fcs@ix.netcom.com)
and (C) Stephane Fillod 2000-2003

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 programmers interaction with radio equipment.
 

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's also a README.betatester and README.developer files in this directory
if you feel like hacking hamlib.

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 then, but not lucky enough
to rebuild the lib, there're 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