File	Date	Author	Commit
cmd	2013-04-07	mad	[d98270] makefile-fix
examples	2013-04-06	mad	[48b406] cmdpad
lib	2013-04-07	mad	[981650] include-fix
log	2013-04-07	mad	[d98270] makefile-fix
pad	2013-04-07	mad	[36abca] pad-implicits
Makefile	2013-04-06	mad	[48b406] cmdpad
Makefile.inc	2013-04-07	mad	[d98270] makefile-fix
README.install	2013-04-06	mad	[48b406] cmdpad

Read Me

bc895 scanner control library
Copyright (C) 1999-2013 Mark A. Day (techwhiz@embarqmail.com)

Required libraries

- FTDI usb-serial converter support requires libftd2xx (http://www.ftdichip.com/Drivers/D2XX.htm)
- GUI command-pad requires libxforms (http://xforms-toolkit.org/)

Install

Edit Makefile.inc in this directory and choose either the rs-232
interface or ftdi usb<->serial converter, and choose the default
device special file or ftdi serial number to use.

run a "make install" from the lib directory to build and install
the library first so that the logger and command line interface clients
have a shared library to link against, then cd back to this directory
and "make install" to install the utilities. (default prefix /usr/local).

Create a directory under your home called .bc895 and copy the files from
the examples directory there. Have a look at the example block and bank
files to get an idea of what they should look like. A block file contains
10 lines, each corresponding to one of the bc895's 10 channel banks.

The format of each line of a block file looks like: 

! 001 air.bnk
! 031 rail.bnk
...

The "!" is file magic used for a conventional bank or "@" for a trunk bank,
followed by the priority channel for that bank, and a path to the file to
load. Bank files can be placed in subdirectories, but use paths relative to
the home directory of ~/.bc895.

A bank file starts with a header line that looks like:

! Medical

The "!" is file magic to distinguish it as a bankfile and the rest of the
line is a tag describing what's in the bank. Alpha-tags can be up to 32 characters. 

This is followed by 30 lines that look like "frequency TDLR CTCSS tag"

463.0750 0000 19 MED-4
462.9500 0000 19 MED-9
000.0000 0010 00
...

The TDLR field is used for trunk/delay/lockout/record setting
for each memory channel... ie to set a channel to be locked-out
use "0010". The CTCSS field sets the CTCSS tone frequency to be
used (127.3hz) for that channel, use "00" for no CTCSS tone.

Currently the utility "bc895cmd" loads block files (which reference their
corresponding bank files) but only writes flat ascii files, either all 300
channels or a subset thereof. Bank files with tags and ctcss tones can be
made easily from the data available on http://www.radioreference.com, your
own frequency databases, or have bc895cmd download the memory first, then
divide the resulting flat ascii file up into the proper 30-channel banks.