LIbrary for Amateur Radio Equipment Control Applications.
 
 
 
 
 
 
Go to file
Stéphane Fillod, F8CFE 382c69b2bd cleaned up static build and flags, introduced lib version 0:0:0
git-svn-id: https://hamlib.svn.sourceforge.net/svnroot/hamlib/trunk@772 7ae35d74-ebe9-4afe-98af-79ac388436b8
2001-12-19 03:31:53 +00:00
alinco cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
aor cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
c++ cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
debian initial release 2001-07-21 13:10:12 +00:00
doc regenerated 2001-10-22 20:34:48 +00:00
dummy cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
icom cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
include merged in hamlib subdir Makefile.am 2001-12-19 03:25:25 +00:00
jrc cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
kachina cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
kenwood cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
lib LIBOBJS cleanup and made libmisc a convenience lib 2001-12-19 03:29:28 +00:00
libltdl update to libtool-1.4.2a 2001-12-09 14:06:49 +00:00
pcr cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
rpcrig cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
src cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
tcl cleanup, more to be done 2001-12-19 03:27:03 +00:00
tentec cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
tests build flags cleanup 2001-12-19 03:28:25 +00:00
uniden cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
winradio merged in linradio subdir Makefile.am 2001-12-19 03:26:06 +00:00
yaesu cleaned up static build and flags, introduced lib version 0:0:0 2001-12-19 03:31:53 +00:00
AUTHORS the more, the merrier 2001-12-16 11:03:12 +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 misc cleanup 2001-12-19 03:20:24 +00:00
Makefile.in regenerated 2001-12-16 20:01:15 +00:00
NEWS 1.1.2 release 2001-09-23 10:37:08 +00:00
PLAN * cosmetic changes 2000-11-01 23:18:11 +00:00
README compiling note 2001-09-20 21:18:30 +00:00
README.developer * outdated doc 2001-03-20 22:17:25 +00:00
THANKS nobody's missing? 2001-09-20 21:19:09 +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 update to autotools-dev 20011108.1 and libtool-1.4.2a 2001-12-09 14:11:53 +00:00
aclocal.m4 update to autotools-dev 20011108.1 and libtool-1.4.2a 2001-12-09 14:11:53 +00:00
compile Initial revision from automake-1.5 2001-12-16 11:04:42 +00:00
config.guess autotools-dev 20010809.1 2001-08-12 23:05:47 +00:00
config.sub autotools-dev 20010809.1 2001-08-12 23:05:47 +00:00
configure regenerated 2001-12-17 22:44:36 +00:00
configure.ac added maintainer mode, LIBOBJS cleanup and made libmisc a convenience lib, added -dlopen force to make dlopen work with static build, and removed some overkill Makefiles 2001-12-19 03:24:20 +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 initial release, untested 2001-08-08 21:40:51 +00:00
hamlib.spec.in minor fixes 2001-09-20 21:19:36 +00:00
install-sh Initial release 2000-10-01 12:52:17 +00:00
ltmain.sh update to libtool-1.4.2a 2001-12-09 14:06:49 +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,2001

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.4-p4
	* libtool  > 1.4.2
	* doxygen
	* cvs and ssh to connect to http://sourceforge.net/

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