Skip to content

LiveSectional is software to run a Live Aviation Weather Map. This software provides many different configurations for the map builder. Visit www.livesectional.com for build instructions and example build techniques.

License

markyharris/livesectional

Repository files navigation

LiveSectional.com

This code has been updated to 4.5xx which uses the new FAA API. A new image will be uploaded to www.livesectional.com that encorporates this change. Visit https://www.livesectional.com/community/postid/1377/ for information on fixing the outage caused by FAA on 10/18/2023. Code here will be updated.

Version v4 of LiveSectional adds many new features for builders to take advantage of. Visit livesectional.com for build and software installation instructions.

  • Updated to run under Python 3.7
  • Added the ability to display TAF (Terminal Aerodrome Forecasts).
  • Added the ability to display MOS (Model Output Statistics). Only available for the United States and its Territories.
  • Added the ability to decode METARs from weather stations not located on airports, such as KMYP - Monarch Pass, CO. (Thank you Nick C.)
  • Heat Map was added to display what airports have been landed at, and how often. Home airport can be designated.
  • Added the ability to install a rotary switch so viewer can select what data to display, METAR's, TAF's, MOS or Heat Map.
  • If rotary switch is not installed, the software can set a default data to display. i.e. METAR's.
  • Sleep Timer - The Map can be put to sleep at night (or anytime) if desired. Pressing a pushbutton will turn on temporarily.
  • Reload the config settings automatically. The map will restart and reload the settings when new settings are saved.
  • Map builder has the ability to use both types of LED's, either RGB and/or GRB color encoding on same map.
  • Decodes the airport ID to show City and State. If international airports are used, it will show Site and Country.
  • Will display IP address if an LCD/OLED display is used.
  • Logging capabilities were added to help with diagnosing issues.
  • The builder can now download and backup the config file, airports file, Heat Map file and logfile.
  • The builder can import a config file and airports file to make maintenance and upgrading easier.
  • Wind direction can now be displayed using an arrow or numbers in degrees and includes Gusts as well.
  • The user interface was improved to optimize for mobile applications.
  • Config Profiles available to load to help start the configuration process.
  • Many new Transitional Wipes were added for when the FAA weather is being updated. Some are still a work in process.
  • Ability to setup wifi remotely through the use of Android or IPhone app thanks to Berrylan.org.
  • A System Information page was added to help with diagnosis if necessary.
  • A Phone App was added to allow the casual user to control the data displayed on the map if a Rotary Switch was not installed. (Thank you Lance B.)
  • To help the casual user to access the App, a 'Create QR Code' feature was added to Utilities to display next to the map.
  • Added the ability to set the RPI's Time Zone without needing to enter the command line.
  • Added the ability to expand RPI's file system without needing to enter the command line.
  • Added the ability to rotate OLED display 180 degrees, and to reverse the position order of OLED's due to build constraints.
  • Added a Map Layout page that will provide a graphical representation of the map design and LED routing.
  • Added ability for more than 300 airports on a single map. Thank you Daniel.
  • Increased the max number of airports from 500 to 3000 in 'Basic Settings'


Browser Compatibility: The following browsers have been tested and found to work (4-2020).

  • Windows 10
    • Chrome: Recommended, as most development was done using Chrome.
    • Microsoft Edge: All functions work.
    • Firefox: All functions work.
    • Internet Explorer: All functions work, (except range sliders on Heat Map Editor).
    • Opera: All functions work.
  • IPAD - IOS 13
    • Chrome: All functions work.
    • Safari: All functions work.
  • Android 9
    • Chrome: All functions work.
    • Miren Browser: All functions work.
  • Mac 10.15 Catalina
    • Safari: All functions work.
    • Chrome: All functions work.
    • Firefox: All functions work.
    • Opera: All functions work.


There are 3 editors that will help set up the software for the map;

  • Settings Editor - Use this editor to set up all the settings for the builder's map.
  • Airports Editor - Use to create the airports file specific to the builder's map.
  • Heat Map Editor - Use this to set which airports have been landed at, and how often.


There are 2 other menus;

  • Map Functions
    • Turn On Map - Turn's on the map and displays.
    • Turn Off Map - Turn's off the map and displays.
    • Reboot RPI - Will force the Raspberry Pi to reboot.
    • Shutdown RPI - Will power down the Raspberry Pi.
    • Map Layout - Displays the airports layed out on a map.
  • Map Utilities
    • Homepage - Will bring up the Home page.
    • Set RPI Timezone - Allows the user to set their Time Zone without the command line.
    • Expand File System - Allows RPI to utilize the entire amount of memory on the microSD Card.
    • Download Config File - Allows the builder to backup the config file to another computer.
    • Download Airports File - Allows the builder to backup the airports file to another computer.
    • Download Heat Map File - Allows the builder to download Heat Map file for diagnostic purposes.
    • Download Logfile File - Allows the builder to download logfile for diagnostic purposes.
    • Run LED Test Script - Run a basic test script to check all the LED's.
    • Run OLED Test Script - Run a basic test script to check the OLED displays.
    • Web Remote App - Setup for the casual user to control the type of weather data displayed on the map.
    • Create QR Code for Web Remote - Creates a QR Code to display for users to run phone app.
    • View Schematics - Opens new web page with access to the various Schematics helpful for building.
    • System Information - Opens new web page and displays information about the system, RPI and OS.
    • Update History - Lists the various versions along with the updates made.
    • Help - Opens a new web page and loads the Help page of LiveSectional.com.


The software was written to provide a myriad of build combinations. Below is a short list of combinations.

  • Basic LED Map
    • Basic LED Map Only - No other hardware other than an RPI and LED string.
    • Basic LED Map with Pushbuttons - Add up to 3 pushbuttons for reboot/power-off, data refresh and power-on.
    • Basic LED Map with Pushbuttons and Rotary Switch - The addition of the rotary switch gives the viewer the ability to choose what to display, METAR data, TAF data, MOS data or Heat Map.
  • LED Map with Display
    • LED Map with LCD display - Use a 16x2 LCD to display Wind Speed and Direction information.
    • LED Map with single OLED display - Use a single SSD1306 OLED display to show the same information.
    • LED Map with multiple OLED displays - Use up to 8 SSD1306 OLED displays to create a great display of data.
    • LED Map with display and Rotary Switch - The addition of the rotary switch gives the viewer the ability to choose what to display, METAR data, TAF data, MOS data or Heat Map. Displays will show what data is being displayed, along with local and zulu time if desired.
  • Map with Legend - Legend can be added on any of the above maps if desired.
    • Basic Legend - Will use 5 LED's to demonstrate VFR, MVFR, IFR, LIFR and No Weather reported.
    • High Winds and Lightning Legend - Will add 2 more LED's demonstrating High Winds and Lightning.
    • Reported Weather Legend - Will require up to 5 more LED's to demonstrate reported weather including; Rain, Freezing Rain, Snow, Dust/Ash/Sand, Fog.
  • Map with Light Sensor - An ambient light sensor can be added to any of the builds above and will dim LED's when room lights are turned off.


Modified MIT License

Copyright (c) 2022, 2023 Bill Bryson III and Mark Harris

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the Software), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The software may NOT be sold or distributed on its own, or with other products for sale without express permission from the author. Visit; http://www.livesectional.com/contact/ to contact the author.

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

LiveSectional is software to run a Live Aviation Weather Map. This software provides many different configurations for the map builder. Visit www.livesectional.com for build instructions and example build techniques.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published