################################################################################
#This file is part of Ham Arch Linux (HAL).
# Copyright 2015 Mitch Winkle, AB4MW
#
# HAL is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# HAL is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with HAL (COPYING text file). If not, see http://www.gnu.org/licenses
################################################################################
HAL Digital Project
FILENAME: README.txt
VERSION: Beta 1
DATE : 10 July 2015
AUTHOR: Mitch Winkle, AB4MW
!!! NOTE: THE MOST UP TO DATE INFORMATION IS FOUND IN THE WIKI !!!
HAL is a framework which is used to systematically install, configure, start and
stop an AX.25 system. Please read all script files carefully before using them.
They WILL change your system significantly. These scripts should NEVER
be run on an system that has not been staged by HAL. Very unpredicatable
results could occur.
!!!!@@@@ WARNING @@@@!!!!!: Alpha/A1 and Alpha/A2 is largely abandoned code as
I have moved to Beta 1 now.
Current Installation and Setup Method for Beta 1 Code :
1. Read the Wiki.
2. For the Raspberry Pi v2 ONLY at this time, download HALBeta1.img.gz. This is an
image file that you will write to an SD card of at least 8 Gb in size.
# wget https://sf.net/projects/haldigital/files/Beta/HALRpi2Beta1.img.gz
# gunzip HALRpi2Beta1.img.gz
This should leave you with a HALRpi2Beta1.img file of approximately 8 Gb.
3. Using the "dd" tool on another Linux computer, write the image to your SD
card.
Example :
# sudo dd bs=4M if=HALRpi2Beta1.img of=/dev/<yourSDdeviceName>
For more indepth help for burning an SD card image, please see:
-- LINUX USERS --
https://www.raspberrypi.org/documentation/installation/installing-images/linux.md
For burning an SD card image with Windows or Mac, please see:
-- WINDOWS USERS --
https://www.raspberrypi.org/documentation/installation/installing-images/windows.md
-- MAC USERS --
https://www.raspberrypi.org/documentation/installation/installing-images/mac.md
4. This will create (after a few agonizing minutes) a current Raspbian image on
the SD card. Insert the SD card into the Pi and power it up.
5. The login is the Raspbian default for the "pi" user, though you SHOULD change
it right away using the "passwd" tool at the command line.
6. After a successful boot and login it is suggested that you run:
sudo apt-get update && sudo apt-get upgrade
There should be very few packages to upgrade if any. If there are a large number of
packages to upgrade, this is either a very old copy of the image or ???
7. If you need to change locale, time zone, and/or keyboard settings or make
any other system adjustments such as extending the SD card partition to fill the
entire SD card, please use the RaspiConfig tool.
sudo raspi-config
8. Get the latest HAL Scripts and Templates:
sudo /usr/local/bin/hal_update.sh
This will download and install the very latest scripts and staging files for the
HAL system. It's a very small file and it takes only a few seconds to do.
9. Start the HAL Menu :
From any terminal window on the Pi, type:
HAL <Enter>
The first two menu entries are for a complete Server system or for a complete
Client system. These will trash all HAL and AX.25 configs and start from scratch.
The 0-7 items in the menu are used to update various modules as indicated.
Other menu items include setting the ALSA settings of your sound card(s),
re-configuring ax25d, choosing modem types per radio port, and starting,
stopping, restarting or viewing the current status of the AX.25 sub-
system.
SO THE SHORT STORY IS,
!!!!!!!!!!!!!!!!! START WITH the Server or Client menu item !!!!!!!!!!!!!!!!!!!
to do your configuration and testing of Beta1.
10. You may, at any time, use :
sudo /usr/local/bin/hal_update.sh
-- OR --
the "Update" HAL menu item,
to get the very latest scripts and any changes to template files.
This is ** Beta ** software and is guaranteed to disappoint you eventually.
Please be aware of this and DO NOT USE this for a production system. Doing so
is at your own risk and this software will receive no support. Your bug reports
are welcome, however, at: https://sourceforge.net/p/haldigital/tickets
LICENSE: Gnu GPL V3.0 License and all that entails. Read the COPYING file for
a full license disclosure. It is located at /etc/hal/COPYING of the image or
can be found on the HALDigital Sourceforge Files area.
Short version: If you use this code and it dorks up your computer it's on YOU.
