ASL 2.0 Documentation

From AllStarLink Wiki
Revision as of 01:29, 1 March 2021 by KK9ROB (talk | contribs)
Jump to navigation Jump to search

Rough draft 2021-02-09 by KK9ROB

Flashing

For all operating systems, we recommend downloading and installing balenaEtcher. It's available for macOS, Windows, and Linux. If you're flashing for RaspberryPi, an SD card reader is required.

Download balenaEtcher

USB Thumbdrive (PC/Pi4)

1. Follow the directions below, but use a USB thumbdrive instead.

SD Card (Pi2-Pi4)

1. Open balenaEtcher

2. Insert your SD card into your SD card reader

3. Press "Select Image" and locate the downloaded image (e.g. ASL_1.01-20180228-armhf-raspbian-stretch-image)

Flashing balenaEtcher.jpg

4. If your SD card is ready to flash, you can simply press the "Flash!" button:

Flashing balenaEtcher Flash.jpg

5. Insert your SD card into your Raspberry Pi and boot it up!

Auto-connecting to WiFi

To auto-connect to WiFi after the first boot, you can place a file called "wpa_supplicant.conf" in the boot directory of the USB/SD card.

  • Generate a wpa_supplicant.conf file here:

https://www.allstarlink.org/wifi-builder.php

  • After flashing, remove the USB or SD card and re-insert.
  • A volume "boot" will now be available. Place the wpa_supplicant.conf in this directory.

New Features

  • Runs on Raspberry Pi 2, 3 and 4 as well as Intel-AMD.
  • One OS and code base across all platforms.
  • Survives kernel updates
  • Boots on modern EFI systems (Intel/AMD)
  • Allmon and Supermon included by default
  • New cli> command rpt lookup <node#> (ala HamVoIP) to resolve IP address of any node.
  • Most of the C code has been refactored to compile with current compiler.
  • Http registration with failover to IAX2.
  • Multi-threaded
  • Use libcurl for statpost instead of shell call to wget
  • Stats posting enabled by default
  • Update startup/shutdown scripts to query systemctl for service status
  • Clean up output from cli>rpt local nodes
  • Updates to asterisk service management convenience scripts
  • Fix compiler warnings, perhaps better system stability
  • Collect perceived ip, port and refresh time from http registration
  • Add libi2c-dev to list of build dependencies
  • Add registerhttp and registeriax directives to chan_iax2
  • Inclusion of systemd service file for updatenodelist
  • Implementation of console command rpt lookup
  • Fix ASTDATADIR location
  • Implement http(s) registration
  • Include app_rpt in the build package
  • Merge in telemetry ducking
  • Merge in upstream alignment
  • Merge in simple voter
  • Merge in http registration
  • Change naming convention to asl-asterisk
  • Depend on new asl-dahdi packages
  • Compile with modern gcc
  • Repackage various AllStar pieces into new Debian packages

HTTP Registration HOWTO

HTTP Registration replaced IAX registration by default in the new ASL Beta 2 image. If you're trying to debug registration, make sure to look at requests on port 80 and 443 instead of 4569 UDP. If you wish to use the legacy IAX registration, you can change your register line from:

register=

to

registeriax=