Updating Software & Licenses

Follow this guide to update system software and packages

Installing a license on your SKAARHOJ controller

If the controller is online

If your controller is online and has internet access through its network, it will automatically detect and apply any assigned licenses. You can confirm that your controller is connected to the internet by looking for a green tower icon in the upper right corner next to the SKAARHOJ logo.

image.png

Please navigate to the Settings tab and refresh the page once or twice. After doing so, you should see the license displayed in the license drop-down menu.

image.png

 

If the controller is offline

You can obtain a license in the form of a file, which you can upload via the Packages tab. If you haven't received your license file and need it for installation, contact support@skaarhoj.com for assistance.

To upload a license file, use the Upload button located at the bottom of the Packages tab, similar to how you would upload a software update on offline controllers.

image.png

Rolling Back Updates

Online Method

Rolling back firmware package updates can be down via the Packages page if your device has connection to the internet. 

To roll back Skaar OS operating system, please see Offline Method. SkaarOS can only be rolled back using the offline method. 

In the drop down next to the device core package you can select from previously released versions. 

Screenshot 2023-07-13 at 1.10.01 PM.png

Once selected, click Install

Screenshot 2023-07-13 at 1.14.24 PM.png

To select from a previous pre-released version of the package, in the upper right corner, enable the Show pre-release toggle. 

Screenshot 2023-07-13 at 1.10.31 PM.png

Offline Method

If internet connection is not an option, it is possible to download the latest stable release and prerelease version from our site devices.skaarhoj.com 

Navigate to the device core package you need based on the device you are trying to control. Then select either the Pre or Stable version. 

Main Blue Pill firmware packages and the operating system can be found under Other Packages:
https://devices.skaarhoj.com/otherpackages

Screenshot 2023-07-13 at 1.21.13 PM.png

For some select packages it is possible to download more versions offline. Packages with that option will have an All Versions option.

Screenshot 2023-07-13 at 1.10.53 PM.png

Select the desired version then download. 

Screenshot 2023-07-13 at 1.11.39 PM.png

The .ipks package can then be uploaded to the Blue Pill device from the bottom of the Packages page. 

Screenshot 2023-07-13 at 1.25.27 PM.png

Update Software

Follow this guide to update the Blue Pill software.

If Blue Pill is unable to communicate with our server, please read the troubleshooting chapter:
https://wiki.skaarhoj.com/books/blue-pill-reactor/page/unable-to-update-device-corespackagesos


Update SkaarOS system software

First, open the 'Settings' page. Here you see 'System Information' in the page top.

Click the orange 'Update' button to open the update pop-up.

Select the latest stable version for update. To update using the latest pre-release version, enable 'Show Pre-Releases' and select the latest version from the list. Please note, we can only fully support the latest stable release versions and pre-releases may have some bugs. 

Click 'Update'. It will automatically download, install, and reboot the device.

settings-page.png

Update 3 necessary packages

Open the 'Packages' page.
Locate the 3 lines: 'hardware-manager' / 'system-manager' / 'reactor'
If a green 'Update' button is displayed to the right of any of them, this means there is an update available.
If so, please click the 'Update' button for each of them.
( After the update, if they do not display 'Running' you must click the 'Stopped' text and select 'Restart'. )

You can also update other packages here, such as individual device cores.

packages-page.png


Update Pre-Release Versions

Show Pre-Release must be enabled to see pre-release versions on the Packages page.
This is done by clicking on the toggle at the top of the Packages page.
( This only affect the current web browser in the current session. It will be off next time you log in. )

Show PreRelease.png

White list our server URL's

In order to download software, Blue Pill must have network access to these 3 domains:

https://pkg.skaarhoj.com
https://init.skaarhoj.com
https://lb1.skaarhoj.com


Uploading Device Cores/Packages/OS from Offline

All device cores, packages, and SkaarOS can be loaded from offline onto the Blue Pill. The individual package files are all available at https://devices.skaarhoj.com/ and are loaded via your Blue Pill device's web interface. 

1. For connected device related device cores, on https://devices.skaarhoj.com/, navigate to the device you are trying to control. Click on STABLE or PRE  will download the latest stable or prerelease version, as indicated in the version number within the parenthesis. 

Screenshot 2024-02-06 at 11.35.31 AM.png

2. To download the core packages and OS that make the Blue Pill work, select Other Packages at the top of the page.  

Screenshot 2024-02-06 at 11.38.43 AM.png


Both the latest prerelease and stable release are available as options. 

Screenshot 2024-02-06 at 11.39.49 AM.png


The specific version will be in the file name. 
version name.png

3. All of the packages are loaded onto the Blue Pill or Blue Pill Inside device via the Packages page. 
packages page redo.png
At the very bottom is an option to Upload and Install Package
manually load.png
Then select the package from your computer for uploading. All packages will be .ipks files except for SkaarOS which will be a .raucb file. If the file names do not have the proper file type extension please and therefor fail to load, please contact support@skaarhoj.com 
select package.png
confirm upload.png

Please note: Blue Pill devices running Skaar OS v0.11 or earlier and/or init v0.1.23  or earlier may have trouble loading packages from offline. Please contact support if you experience any difficulty.