3.4.1

This is an optional bug fix release that contains a few fixes for issues encountered by users.

Updates

• "Play" button can be used to jump directly to a song/sequence in the playlist while the playlist is running

Bug Fixes:

• Crash when using the "Remap channels" playlist items
• Crash when configured output ranges are completely outside the ranges provided by the FSEQ file
• In remote mode, starting a Test can take several seconds before lights start
• In remote mode, lights are left on at end of sequences

Upgrade Instructions:

If you have a system running 3.4, you can go to the FPP about page (about.php) and click on the "Manual Update" button. It should only take a minute or two to upgrade.

For older version, it's recommended to grab the 3.4 image from the bottom of https://github.com/FalconChristmas/fpp/releases/tag/3.4 , install that, and then hit the "Manual Update" button on the about page.

3.4

New user installation instructions

For new users, you need to download the appropriate image from the links below. Then follow the instructions found at https://falconchristmas.com/forum/index.php/topic,9372.0.html to "burn" the image on to an SD card. Just extracting/copying the file to a blank SD card will NOT work.

New Features:

• New "Generic SPI" output

Enhancements:

• Collect individual channel ranges for outputs instead of one large range to allow xLights to create smaller sparse FSEQ files
• Enable multisync send/receive on interfaces that may come up or restart after FPPD has been started
• Reduce the delay between sequences
• Display media name and fseq name that is playing on status page along with playlist

Bug fixes:

• Make sure fppcapedetect is run AFTER /home/fpp/media is mounted so the information about the detected cape is not overwritten
• Fix regression where EVENT environment variables were not set
• Add event control channels to range of channels to load from fseq files
• Fix BBB panels "Output by row" not displaying fades correctly
• Fix "zombie" processes being left from running scripts and events
• MQTT sending wrong "secondsTotal" when only media is being played
• Fix blanking of channels when stopped
• Pi - fix matrix outputs should require all 3 chains to be equal length

Upgrade Instructions:

The best way to upgrade from FPP 2.x is to re-image the device. The full OS upgrade to Debian Buster requires a re-image.

If you have a system running 3.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. It will take a long time to upgrade. Likely 20-30 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

3.3

New user installation instructions

For new users, you need to download the appropriate image from the links below. Then follow the instructions found at https://falconchristmas.com/forum/index.php/topic,9372.0.html to "burn" the image on to an SD card. Just extracting/copying the file to a blank SD card will NOT work.

New Features:

• ArtNet support for input/bridge universes
• Pin maps for PB16 board

Enhancements:

• Button to create UDEV rules to force current network device names to be persistent
• Option for remote video to ignore sync packets and just play without slowdowns/speedups
• Option for master to specify a delay between sending the Open command and the Start command to allow remotes time to process the video/sequence
• Add Stop Now and Stop Gracefully to OLED playlist page
• Split fppd boot service into two parts to allow fppd to start later which allows IP address to display on screen

Bug fixes:

• Fix GPIO initialization on Raspberry Pi that kept GPIO/PWM outputs from working reliably
• Allow 8M channels on DisplayTesting page
• MQTT - resubscribe after disconnect/reconnect
• Fix omxplayer starting twice causing ghosting
• Fix Stop Gracefully button not enabling
• Fix sound card detection at boot if sound card is removed/changed

Upgrade Instructions:

The best way to upgrade from FPP 2.x is to re-image the device. The full OS upgrade to Debian Buster requires a re-image.

If you have a system running 3.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. It will take a long time to upgrade. Likely 20-30 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

3.2

New user installation instructions

For new users, you need to download the appropriate image from the links below. Then follow the instructions found at https://falconchristmas.com/forum/index.php/topic,9372.0.html to "burn" the image on to an SD card. Just extracting/copying the file to a blank SD card will NOT work.

New Features:

• Link to PDF FPP manual in the Help menu

Enhancements:

• Use libgpiod for GPIO inputs to avoid polling, integrates into normal event loop as events
• Change to using hostapd for Wifi tethering, should be more reliable
• Allow "If no connection" tether setting on BBB as hostapd tethering does not interfere with USB tethering

Bug fixes:

• FPD page not showing if FPD detected
• Fix a few issues with the Docker builds no including all the required apache modules
• Fix start channel for VirtualMatrix
• Fix some problems with gradients on the BBB panels not looking correct, colors off, etc...
• Reset mixer device to default if the configured mixer device doesn't exist anymore
• Fix the "stop" command for omxplayer to stop correctly and not pause for 20-30 seconds (or until video ends)
• Scan various font directories for "ttf" files for fonts to use for Overlays.
• "Outdoor" panels on BBB not displaying correctly
• Playlist script entries hang

Upgrade Instructions:

The best way to upgrade from FPP 2.x is to re-image the device. The full OS upgrade to Debian Buster requires a re-image.

If you have a system running 3.0 or 3.1, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. It will take a long time to upgrade. Likely 20-30 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

3.1

New user installation instructions

For new users, you need to download the appropriate image from the links below. Then follow the instructions found at https://falconchristmas.com/forum/index.php/topic,9372.0.html to "burn" the image on to an SD card. Just extracting/copying the file to a blank SD card will NOT work.

New Features:

• BBB String capes can have their expansion ports set to either standard or differential. Differential expansions can now support Smart Receivers
• Many BBB Panel cape (Octoscroller/PocketScroller) improvements including:
  • Options for 9-12 bit color to provide much better image quality (at expense of refresh rate)
  • Option to allow output by row (more compatible, but more flicker) or by bit (less flicker)
  • Faster data output resulting in higher refresh

Enhancements:

• C++ plugins can wire file descriptors into the main select event loop
• C++ plugins can wire callbacks into the MultiSync process
• Implement an "open" command for MultiSync to allow remotes to start opening the files sooner
• BBB capes can have any number of DMX outputs from 1-8 instead of just 1, 4, or 8
• Setting to allow "script" PlayList entries to wait for the script to complete
• On multi-core Pi's, pass "-j 4" to make to allow it to build/upgrade faster
• Report the Pi/BBB serial number on about page
• Upgrade FPP proxy to use proxy_html to hopefully allow updating/fixing HTML returned from controllers
• Speed up setting the number of universes on e1.31 input and output pages.

Bug fixes:

• LOGDIR is exported to plugins so debug logs will not appear in /
• FPD dongle detection and data not working
• Move FPD/PiFace setup to later in boot to allow SPI to have more time to startup
• Yellow/Blue OLEDs with multiple networks configured would drop to only one network line
• fpp -g and -G commands now accept the older "comma separated" list for compatibility
• PixelOverlay models not working properly unless they are "Top left/Horizontal"
• Changing tether selection from OLED should prompt for reboot to activate
• Don't trigger a wifi scan while trying to associate. Seems to cause kernel/driver issues on Kernel 4.19
• Enable CORS headers in /api to allow API's to be called from other locations
• Fix clone/delete of universes not moving descriptions
• Fix build of USB/DMX outputs

Upgrade Instructions:

The best way to upgrade from FPP 2.x is to re-image the device. The full OS upgrade to Debian Buster requires a re-image.

If you have a system running 3.0, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. It will take a long time to upgrade. Likely 20-30 minutes. You will need to reboot after the upgrade is complete to finish the upgrade process.

3.0

New user installation instructions

For new users, you need to download the appropriate image from the links below. Then follow the instructions found at https://falconchristmas.com/forum/index.php/topic,9372.0.html to "burn" the image on to an SD card. Just extracting/copying the file to a blank SD card will NOT work.

New Features:

• Support for Raspberry Pi 4 (*)
• Updated images to Debian 10 Buster (*)
• Support for 1.5" SSD1327 OLED screens
• Ability to "proxy" controllers behind FPP
• Add support for .mov, .wav, .mpg
• Ability to write plugins in C++ (experimental)
• BBB - Smart Receiver support for BBB cape differential outputs
• BBB - Add ability to turn off/control the various BBB leds
• Support for higher bitrate audio
• Docker images on DockerHub

Enhancements:

• Updated to support up to 8M channels (from 1M)
• Conversion of some boot stuff to C++ to boot faster
• BBB - Also look on I2C1 for OLED/temperature sensors
• Upgrade to latest jquery version
• Pi - don't show FPD page unless FPD detected
• Default volume to 70% to avoid overdriving SoundBlaster and other cards
• Pi - CPU temperature displayed with other sensor information
• New internal architecture to only load outputs that are actually configured/used. Reduces memory usage.

Bug fixes:

• Bunch of fixes to get omxplayer video output to not leak memory and cause crashes/lockups
• Setting UI Password now doesn't break everything

Upgrade Instructions:

The best way to upgrade is to re-image the device. The full OS upgrade to Debian Buster requires a re-image.

If you have a system running 2.7.2, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. It will take a long time to upgrade. Likely 20-30 minutes. You will get all the improvements above except those marked with the "requires re-imaging" notes on the release notes. However, this does NOT upgrade the underlying OS to "Debian Buster". At this point, we do not know how many more releases we will continue to support building on "Debian Stretch".

2.7.2

Updates:

• Update cape detection on Raspberry Pi to account for the Pi booting too fast so EEPROMs are not yet available.
• Check i2c1 for OLED's on BBB in addition to normal i2c2
• Allow script installer to check for max versions in addition to just min version (so obsolete scripts can not be shown)
• Slightly faster boot on BBB (uboot bootdelay setting reduced) (requires re-imaging)
• Faster Raspberry Pi OLED (increase i2c bus speed to 400khz from 100khz) (requires re-imaging)

Bug Fixes:

• On WHITE OLED displays, vendor logos were being cut off by one pixel
• BBB GPIO PWM output causing crash due to latest BBB kernel changes
• Problem with Front/Back setting on LED Panel page mixing up panels and wiring
• Prevent saving playlists with no name
• Don't show options on LED Panel page that are not applicable to installed cape

Upgrade Instructions:

If you have a system running 2.7, you can go to the FPP about page (about.php) and click on the "Manual Update" button. It should only take a few minutes to upgrade.

If you have a system running 2.4-2.6, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. You will get all the improvements above except those marked with the "requires re-imaging" notes on the release note for all the versions is upgrading through. Note: there are a LOT of changes in this release. The "Upgrade" button will take several minutes. BeagleBones should take about 15 minutes. Newer Pi 3's are about 10 minutes. Single core Pi's may take over 30 minutes.

2.7.1

Updates:

• Detect the new Raspberry Pi 3A+ and provide a logo for it
• Detect "Unknown" capes as "Unknown" instead of "Unsupported"

Bug Fixes:

• Fix bug where older plugins were being installed into the wrong directory and thus not working.
• Troubleshooting page was unable to provide details on I2C bus on BeagleBone's
• Fix problem in the 2.7 Pi image where omxplayer was not fully installed or working thus preventing mp4 videos from playing. Fixing this does require using the new 2.7.1 image for the Pi.

Upgrade Instructions:

If you have a system running 2.7, you can go to the FPP about page (about.php) and click on the "Manual Update" button. It should only take a minute or two to upgrade.

If you have a system running 2.4-2.6, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. You will get all the improvements above except those marked with the "requires re-imaging" notes on the release note for all the versions is upgrading through. Note: there are a LOT of changes in this release. The "Upgrade" button will take several minutes. BeagleBones should take about 15 minutes. Newer Pi 3's are about 10 minutes. Single core Pi's may take over 30 minutes.

2.7

New Features:

• Bootup enhancements:
  • Based on latest OS releases. 2019-04-08-raspbian-stretch-lite for the Pi and bone-debian-9.9-console-armhf-2019-04-28 for the BeagleBones. (requires re-imaging)
  • New "Boot Delay" advanced setting for systems that startup too fast and network isn't fully available.
  • Faster boot by separating various FPP services into separate systemd services that can run in parallel.
• New Plugin management screen and supporting code. Plugins themselves can provide much of the metadata that used be in FPP's repo
• I2C OLED display support
  • Supports SSD1306 (both 64x128 and 32x128 sizes) and SH1106 OLED's
  • Default display shows network information, FPPD status, and information about currently playing sequence/media
  • For new Capes, can use EEPROM information to provide push button actions for menus, tests, sensor information, etc..
• VirtualDisplay and VirtualMatrix Enchancements:
  • Add ability to show a background image in the Virtual Display
  • Add support for 16bpp framebuffers in both channel outputs
• Allow capes that only provide certain functionality to "hide" functionality they don't provide.
• Channel Tester Updates:
  • New "Cycle" test modes on Display Testing page
  • Move RGB test modes to the top above single channel test modes
• Input/Output updates
  • LED Panels page supports flipping from "front view" to "back view".
  • Add "Universe count" for e1.31 input/output to easily define large numbers of universes that need to go to the same place.
  • Add support to configure internal pullups for GPIO inputs
• Playlist/Player/Scheduler updates:
  • New "Image" playlist entry to display a static image on the HDMI output
  • New sunset/sunrise options (need to set longitude and latitude)
  • Add "Even/Odd" settings for scheduler to schedule playlists on alternating days
• MultiSync/Discovery updates:
  • Much faster loading of MultiSync UI page.
    • No longer uses AVAHI by default.
    • Load remote host info via AJAX calls instead of on the web server in PHP.
  • Remove entries from internal cache if not seen for more than an hour.
  • Much faster discovery API's for xLights to use
• Event updates:
  • Add ability to use raw event ID values in control channels instead of using 10x the event ID value.
• REST API updates:
  • Status response now contains sensor readings (temperature/voltage). Displayed on OLED and status page.
  • API for inserting items into Playlists
  • New API for PixelOverlays so no need to use the Perl API
  • New API for Models
  • New REST API for managing/installing plugins
  • New REST API for managing/installing generic config files
  • New REST API for querying available sequences
  • New REST API for querying cape information
• MQTT updates:
  • support for stopNow and stopGraceful
  • bunch of new topics for manipulating playlists
• BBB specific:
  • Don't configure all the pins for GPIO output on boot (faster boot). Configure when needed.
  • Allow BBB string capes to use both PRU's to optimize output if DMX/Pixelnet is not needed
  • Allow loading of cape port -> GPIO/Pin mapping from Cape EEPROM
  • Support for a newly discovered 1:4 P10 panel with a new interleave setting.
• Pi specific:
  • Update rpi_ws281x library to new version to support Pi 3A+
  • GPIO input page lists all the proper wiring pi pins.
  • Support for "spixel" library for controlling APA102/LPD6803/WS2801 pixels from multiple outputs
• Miscellaneous updates:
  • Removed old fppconvert binary and UI parts.
  • Removed old unused code in E1.31 bridge mode
  • Add 'Images' tab to File Manager
  • Allow a FPP instance to serve its git clone to other FPP instances so all systems do not need internet access to pull in updates.
  • Add i2cdetect to Troubleshooting Commands output
  • Update Makefile to allow building binaries in a separate subdir
  • Send test email to configured email address instead of root@localhost
  • Update max LOR controller ID to 240

Bug Fixes:

• Hide files that start with a . from playlist editor
• Hide 169.254.* IP's from FPP systems list (invalid)
• Fix some cases where omxplayer existing causing crashes
• Don't show ttyUSB0 as potential serial output if it doesn't exist
• Flash to eMMC is not available if filesystem has been expanded
• Fix start channel auto-set between BBB string grouped sections
• Fix problems if eseq start channel is 0
• Fix some problems trying to configure various types of RTC's
• Fixes some problems with special characters in WIFI networks and passwords
• Fixes some problems with special characters in playlists
• Cleanup non-looping effects when they finish
• Miscellaneous bug fixes in new v2.x playlist code.
• Fix email setup

Upgrade Instructions:

If you have a system running 2.4-2.6, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. You will get all the improvements above except those marked with the "requires re-imaging" notes on the release note for all the versions is upgrading through. Note: there are a LOT of changes in this release. The "Upgrade" button will take several minutes. BeagleBones should take about 15 minutes. Newer Pi 3's are about 10 minutes. Single core Pi's may take over 30 minutes.

2.6

New Features:

• Support for new FSEQ file format (requires updates to xLights/Vixen to generate new format):
  • Compression - v2 files are about 10% the size of older fseq files
  • Sparse data - xLights/Vixen can generate fseq files that only contains the channel data needed for that specific FPP instance greatly reducing the size of the files
• Several Playlist enhancements:
  • Ability to pass arguments to scripts in Playlist Editor and for Event scripts
  • Add ability to use playlists within playlists
  • Update PlaylistEntryDynamic class to allow multiple entries in the dynamic playlist
  • Add ability to call plugin on another host from master from Dynamic Playlist
  • Reload playlist in fppd when it is changed on disk
• Multisync enhancements:
  • Multicast "All Remotes" option instead of broadcast to work better with Wifi based remotes
  • Ability to specify what types of files (sequences, media, events, scripts, etc...) to sync to remotes
  • New discovery mechanism for detecting FPP instances (to be used by xLights as well)
• New "boot" callback for UserCallbackHook for plugins to do things at boot time
• "FPP After Hours" plugin available from plugin list (internet radio stations)
• Allow reversing channel data when using Remap Output Processor
• New "Compact" status page for running from cell phones
• Allow channel remap output processor to reverse RGBW pixels
• More information added to system information json (to be used by xLights)
• New framework for REST API, start adding some REST API's for playlists

Bug Fixes:

• Update volume in UI when changed on system
• Fix problems in scheduler if the time jumps forward (ex: NTP kicks in)
• Fix problems with playlists scheduled across Saturday midnight
• Fix problem with e1.31 packet that use a non-0 start code
• Fix problem with BBB ws2811 strings on GPIO0 ports causing flicker/random data
• Fix problem where the currently running playlist would not be properly stopped when a new playlist was started

Upgrade Instructions:

If you have a system running 2.4 or 2.5.x, you can go to the FPP about page (about.php) and click on the "Manual Update" button. At that point, a big green "Upgrade" bar should appear. You will get all the improvements above except those marked with the "requires re-imaging" notes on the release note for all the versions is upgrading through. Note: there are a LOT of changes in this release. The "Upgrade" button will take several minutes. BeagleBones should take about 15 minutes. Newer Pi 3's are about 10 minutes. Single core Pi's may take over 30 minutes.

At this point, there are no images for 2.6. You need to install the latest 2.5 image and do the "Manual Update" steps above.