LIbrary for Amateur Radio Equipment Control Applications.
 
 
 
 
 
 
Go to file
Stéphane Fillod, F8CFE f86968030a fix typo
git-svn-id: https://hamlib.svn.sourceforge.net/svnroot/hamlib/trunk@1194 7ae35d74-ebe9-4afe-98af-79ac388436b8
2002-09-29 20:18:34 +00:00
alinco converted to C99 intialization style 2002-08-16 17:43:02 +00:00
aor converted to C99 intialization style 2002-08-16 17:43:02 +00:00
bindings added error checking through exception 2002-09-16 06:50:13 +00:00
c++ misc fix for picky compilers 2002-09-22 11:41:49 +00:00
debian initial release 2001-07-21 13:10:12 +00:00
doc cleanup doxygen warnings 2002-09-24 21:42:56 +00:00
drake converted to C99 intialization style 2002-08-16 17:43:02 +00:00
dummy WARNING: renamed strmode to strrmode because the symbol is already in use on BSD systems 2002-08-26 21:26:06 +00:00
easycomm converted to C99 intialization style 2002-08-16 17:43:02 +00:00
gnuradio WARNING: renamed strmode to strrmode because the symbol is already in use on BSD systems 2002-08-26 21:26:06 +00:00
icom update (band swapping, pream/att, ..) by Luc LX2GT 2002-09-21 13:54:24 +00:00
include misc fix for picky compilers 2002-09-22 11:41:49 +00:00
jrc converted to C99 intialization style 2002-08-16 17:43:02 +00:00
kachina converted to C99 intialization style 2002-08-16 17:43:02 +00:00
kenwood fix missing initialization, thx goes to Dave WB5NHL 2002-09-21 13:52:09 +00:00
kylix removed autogenerated files, use autogen.sh instead 2002-07-02 18:03:25 +00:00
lib fixed locator and dms conversion and also got rid of trunc usage, fixed misnamed 'bearing' references 2002-08-22 23:42:20 +00:00
libltdl 1) Updated branch_ts2k with respect to HEAD. 2002-07-26 08:53:11 +00:00
pcr patch from Darren G0WCW 2002-08-26 22:33:52 +00:00
perl implemented more calls 2002-08-26 22:31:44 +00:00
rpcrig list verbose levels 2002-09-22 11:39:04 +00:00
rpcrot list verbose levels 2002-09-22 11:39:04 +00:00
src fix typo 2002-09-29 20:18:34 +00:00
tcl WARNING: renamed strmode to strrmode because the symbol is already in use on BSD systems 2002-08-26 21:26:06 +00:00
tentec fixed a segfault bug in init 2002-09-06 14:05:41 +00:00
tests fix for 8 bits cmd IDs 2002-09-24 21:45:37 +00:00
uniden converted to C99 intialization style 2002-08-16 17:43:02 +00:00
winradio converted to C99 intialization style 2002-08-16 17:43:02 +00:00
yaesu converted to C99 intialization style 2002-08-16 17:43:02 +00:00
AUTHORS thanks to all of you guys 2002-05-28 21:43:28 +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 for 1.1.2 2001-09-23 11:03:28 +00:00
INSTALL new install notes, ala autoconf 2000-11-04 21:37:27 +00:00
LICENSE converted to LGPL 2001-07-14 10:16:10 +00:00
Makefile.am check for C99 struct intializer support, and enter bindings/ subdir only if swig is installed 2002-09-11 21:33:52 +00:00
NEWS 1.1.3 release 2002-06-17 20:51:16 +00:00
PLAN * cosmetic changes 2000-11-01 23:18:11 +00:00
README misc update before release 2002-06-17 20:52:48 +00:00
README.betatester mention to run autogen.sh after checkout 2002-09-22 11:39:39 +00:00
README.developer GNU make needed 2002-09-10 06:43:05 +00:00
Segfault-award bug fix with non file oriented rigs 2002-09-29 19:40:56 +00:00
THANKS misc 2002-06-17 20:59:51 +00:00
TODO misc update before 1.1.2 2001-09-23 10:40:26 +00:00
TODO.skeleton Initial revision 2000-07-18 20:55:08 +00:00
acinclude.m4 updated to libtool-1.4.2-6 2002-06-17 20:59:09 +00:00
autogen.sh fixed it 2002-07-03 13:53:20 +00:00
compile Initial revision from automake-1.5 2001-12-16 11:04:42 +00:00
config.guess updated scripts to 20020320.1 2002-05-14 21:53:51 +00:00
config.sub updated scripts to 20020320.1 2002-05-14 21:53:51 +00:00
configure.ac check for C99 struct intializer support, and enter bindings/ subdir only if swig is installed 2002-09-11 21:33:52 +00:00
cvs2cl.pl Initial import for ChangeLog handling 2001-02-01 00:20:12 +00:00
depcomp Initial release 2001-10-07 21:42:13 +00:00
hamlib.m4 cloned from Alsa project, still not thouroughly tested 2002-05-28 21:33:10 +00:00
hamlib.spec.in preliminary work for 1.1.3 release 2002-06-17 21:00:32 +00:00
install-sh Initial release 2000-10-01 12:52:17 +00:00
ltmain.sh updated to libtool-1.4.2-6 2002-06-17 20:59:09 +00:00
missing upgraded to libtool-1.4.2 2001-09-19 21:33:48 +00:00
mkinstalldirs Initial release 2000-10-01 12:52:17 +00:00

README

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

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.libhamlib-yaesu.so will provide connectivity to Yaesu
  FT 747GX Transceiver, FT 847 "Earth Station", etc. via a standard API.

2. libhamlib-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.5
	* libtool  > 1.4.2
	* 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