Troubleshooting Troubleshooting scenarios and things to try. Blue Pill Controller Showing Unknown If the Blue Pill or Blue Pill Inside controller is showing in the panels sections of the Home screen as Unknown it could be a few issues.  1. Check that the panel's IP address in the device details section is set to HOST. This indicates that the device has the Blue Pill native inside and is not controlled by another device.  2. If it is set correctly but still not registering, delete the panel from the home page and re-add it. It can be deleted by right clicking on the panel name and selecting either Remove panel from configuration or Remove panel and configuration.  It is easily added again by clicking Add Panel and selecting Connect next to the notification about the native panel not being connected.  3. If the panel is still not properly connecting to itself, try rebooting the panel. This can be done by pressing Reboot on the Setting page under System Information.  4. If the panel still does not connect, reset the Hardware Manager settings to default. On the Packages page, click on the Hardware-Manager. At the bottom, click on Reset to Default.  5. The next option, if the others have not worked, is to clear the config directory for the Hardware Manager. On the Packages page in the Hardware Manager package, press Clear Config Directory.  After clearing the config directory, go back to the main Packages page and click on the status next to the Reactor package. This will trigger a pop up with some quick actions. Press Restart.  6. The last option is more of a nuclear option since it will completely wipe clean all configurations, added devices, added panels, and projects. Please contact Skaarhoj support before attempting to see if they can find another solution.  The last resort is to clear the config directory for Reactor. On the Packages page go into the Reactor package and press Clear Config Directory. Then reboot the Blue Pill panel.  Blue Pill panels boot animation during startup. Should my BPI product have an animation during startup ?  Below is a table summarising the status of implementing the boot animations to various products: Controller Status Comments AIRFLY RELEASED   QUICKBAR   RELEASED   AIRFLYPROV2 On hold AIRFLYPROV3 RELEASED  BLUE PILL SERVER RELEASED  COLORFLYV3 RELEASED FRAMESHOTUNO RELEASED HEIREPLAYV2 RELEASED HEISIDECAR RELEASED INLINE10 RELEASED INLINE22V2 RELEASED LIVEFLY RELEASED Nkk version was added in v 0.1.7 MASTERKEYONEV2 RELEASED 2 Versions: single and double bus MINIFLY RELEASED MK48 RELEASED MKA1 TO BE DONE MKA2/PTZ VIEW RELEASED MKA3 TO BE DONE MKA4 | Quickshot RELEASED MKT1A/B |  T-Block R/L RELEASED PTZEXTREMEV2 RELEASED PTZFLY RELEASED PTZPROV2 RELEASED PTZWIZV2 RELEASED RACKCONTROLDUO RELEASED RACKCONTROLUNO RELEASED RACKCTRLXK1 RELEASED RACKCTRLXK2 RELEASED RACKCTRLXK3 RELEASED RACKFLYDUO RELEASED RACKFLYTRIO RELEASED RACKFLYUNO RELEASED RACKFUSIONLIVE RELEASED Nkk added in v0.2.9. RACKPRO1 RELEASED RACKPRO2 RELEASED RACKPRO3 RELEASED RCPPRO RELEASED RCPV2 RELEASED WAVEBOARDV2 RELEASED WAVEBOARD MINI RELEASED XC8S RELEASED XPOINT24 RELEASED Had wrong file, fixed in v0.1.9 XPOINT48V2 RELEASED FRAMESHOTPRO RELEASED REDIRON/ RC-SK5 RELEASED My product is in the list, but I do not see any animation during startup? There are various reasons for this to happen, eventually your controller tried to flash the special firmware to the chip and failed for some reason and as a result it saved a "failed attempt" flag and does not try to do it again as it would happen every time hardware-manager is restarted.  There are 2 ways to try to recover the boot animations. We will start with a simple one: Power the panel. Make sure your panel has "RELEASED" status in table above, update Reactor package to the latest version. Also please make sure panel has latest operating system version as well as hardware-manager package. Find out panels IP address and in your browser go to x.x.x.x/tools. (Substitute x with IP of your Panel) Make sure you see "HW Bootscreen Repair" section. Check the status field. Status Boot Animation at Startup  Comments OK YES Everything is good, no need to do anything OK NO Click on "Reset Hardware Boot Animation Update" and restart hardware-manager when asked Failed to update NO Click on "Reset Hardware Boot Animation Update" and restart hardware-manager when asked Unknown YES/NO This means your panel or specific version of your panel does not have a Bootscreen animation firmware available. If one has clicked "Reset Hardware Boot Animation Update" after restarting hardware manager one should see "Wait Please!" message on all of the screens of the panel! It is crucial not to interfere or power cycle the panel at this stage , as it can "brick" the chip being flashed without the possibility to recover. Once flashing the chip is done one will see a "short"(5 sec) animation and controller will switch to its normal operation.  Try to power cycle your panel - the boot animation should be running the first ~30 seconds while main operating system is booting. Another "walk-around" solution would be the following (might be the way to if your panel does not have Reactor due to Licensing constrains): Make sure your panel has internet access. Panel should have the latest Operating system version or at least V1.1 . So please check the version you have and update if needed. (Also  backup your Reactor projects , as we will perform full file system erase further.) Enable the Advanced Mode. Once Advanced Mode is enabled you should see that "Reset" button appeared. Press and hold "Shift" button on your keyboard and click "Reset" button with the mouse. Check that you triggered the "HARD System Reset" and Confirm if you wish to proceed. In approximately 30-40 seconds panel should restart and one should see "Wait Please!" message on all of the screens of the panel! It is crucial not to interfere or power cycle the panel at this stage , as it can "brick" the chip being flashed without the possibility to recover. Once flashing the chip is done you will see a "short"(5 sec) animation and controller will switch to its normal operation.  Try to power cycle your panel - the boot animation should be running the first ~30 seconds while main operating system is booting. "Customized" tag in Mapping on Home Page Scenario: If the selecting Mapping for the controller has a Yellow "Customized" tag as below: This happens when the selected mapping has been edited away from the default by making edits in the Configuration page.  This is the expected behavior.  Fix: If you do not want to work outside of the default mapping for the controller there are a few options to going back.  1. Create a new project and select the default configuration in the mapping.  2. If you know when the change was made, you can revert the project back to an earlier version before the edit was made. This is done in the project details.   -Select Show Advanced in the project details -Click on the reverse clock icon in the Configuration column -Select the previous save file needed.  Please Note: All changes to the configuration are saved for 24 hours, changes older than 24 hours are saved a 1 file per day. If a file is renamed with a comment or a tag, that specific file will be saved independent of hour/day.  No Lights on Panel If your panel is not lighting up as it should, but everything else seems like it is working as expected, it may be the panel brightness is set too low.  By default a panel is set to inherit the brightness from the panel group it is in.  In the Panel Details, you can deselect Inherit Sleep, dim and brightness from Group.  It is then possible to set the LED and Display brightness per panel If you would all your panels to maintain the same level of brightness without setting them individually, this can be adjusted in the group settings.  To access the group settings, set the Home page to Show Advanced.  Then click into the group details.  From there you can set the default settings for the group.  No Selectable Devices for an Added Device Core On occasion a supported device is not showing up as an option to add to the Blue Pill panel.  In this example I am trying to add a Waterbird Slider but it is not showing as a selectable device.  1. Confirm that we support the device by checking at devices.skaarhoj.com   2. After confirming the device is supported. Try adding the device manually via Add Devices on the Home Page. 3. If it doesn't show up in the devices. Add the device core manually from the packages page. The device core name can be found on devices.skaarhoj.com If you do not have internet access on your Blue Pill device see: https://wiki.skaarhoj.com/books/blue-pill-reactor/page/uploading-device-corespackagesos-from-offline-RId 4. Sometimes after manually adding the package the device still does not show up in the devices section of the home page. In that case, click into the device core package on the packages page and press Clear Config Directory.  5. After clearing the config directory, go back to the main packages page. Click on the status of the Reactor package, then press Restart.  6. The device should now be available to add in devices on the home page.  Panel Not Displaying Connected Switcher If after setting up your controller and connecting it to a switching device, your Skaarhoj panel is not properly showing the connection then it could be that the Device ID does not match the one the panel is looking for.  By default, the Skaarhoj Panel is going to try to connect to Device ID #1 for the specific device core that it is looking for. The device IDs are auto generated and unique per device cores (if you have two different devices cores, each can have a device ID #1).    If you only have a single switching panel, set the device ID to 1 in the Device Details. This will bring the switcher up on the Skaarhoj panel.    If you have multiple of the same device you want to be able to switch between, this can be done by accessing the ENG menu for your device. To find the ENG menu for you panel, please check out the instructions at: https://wiki.skaarhoj.com/books/blue-pill-reactor/page/engineering-menu For most switching panels, the ENG menu is accessed by holding down the SHIFT button on the panel then pressing the FTB button when it turns green.  Once the ENG menu is open you can switch between connected switcher using the Device ID selector button. When the proper device number is selected, the panel should display everything correctly.    PTZ Extreme - Joystick rotated 90° A small batch of PTZ Extreme [BPI] have left factory with joystick rotated 90°. The fix for this is two steps: • add the serial number to our database of 'rotated joysticks' • connect device to internet and update it (it will automatically get a new profile) Known serial numbers In our database, these serial numbers are currently registered for compensation of a rotated joystick: • 449196 • 449195 • 449198 • 449194 • 449192 • 449167 • 449165 • 449139 (didn't have it - > fixed) • 449137 (didn't have it - > fixed) • 449136 (didn't have it - > fixed) • 449134 • 448975 • 448979 • 448978 • 448977 • 448974 • 448929 • 448926 Notes: The three highlighted ones were changed in a customer remote session today from not having rotation to having rotation, so they are confirmed fixes. At least one other serial, 448976, was discovered to have the serial marked as 'rotated' but was a perfectly fine controller until the update screwed it up. This has been fixed. Procedure to handle devices: - Find the serial number Joystick function correct -> Is the serial number on the list? Yes -> DANGER, do NOT update the hardware profile, that will install a hardware profile with a rotated joystick for a controller that doesn't need it. Ask SKAARHOJ to remove that serial number from the list first before you can safely update. No -> No problem, you can update the hardware profile without risk. The controller is "normal" Joystick is rotated ->  Is the serial number on the list? Yes -> Great, just update the hardware profile, enter the Settings tab and refresh a few times while the controller is online (green tower in top corner), go and restart the hardware manager and you should find that the joystick works right again No -> Contact SKAARHOJ and tell them that  this serial needs to be on the list because it has a rotated joystick. After the serial has been confirmed added to the list, you can proceed as with the "Yes" above . Offline devices: The 'rotate' hardware profile is sent from the server to devices with serial numbers on the list. For this reason you should follow the procedure above - and then get the device online. We do not use a downloadable hardware profile file as this could be spread to all devices. Reflash Blue Pill devices If your Blue Pill device has become totally unresponsive - you cannot contact it in any way - the solution may be to 'reflash' the entire system software. NOTE: For this procedure you need the assistance from SKAARHOJ Customer Support ! Please contact: support@skaarhoj.com ALERT: This procedure will ERASE ALL configurations on the device. REQUIREMENTS You need the following software: • BalenaEtcher version 1.18 or later    https://www.balena.io/etcher/   (free download) • skaarOS image file   (this can only be obtained from SKAARHOJ Customer Support) PROCEDURE make sure you have the 'skaarOS' image file ready on your Desktop (you get this file from SKAARHOJ Customer Support) open BalenaEtcher app (remember, this must be version 1.18 or later) click 'Flash from file' > select the 'skaaros_xxxx' image file from the Desktop (pic 1 and 2) click 'Select target' connect Blue Pill device to computer via USB > hold paperclip pressed in the configuration hole on the device > connect power (PSU or PoE) to device (pic 3) when you see 'Compute Module' in BalenaEtcher, remove paperclip select 'Compute Module' > click 'Select' (pic 4) click 'Flash!' > enter computer password > wait approx 5 min (pic 5) after flash procedure is done, quit BalenaEtcher disconnect USB and power from Blue Pill device > connect power again to reboot (will take approx 0,5-1 min) The Blue Pill device should start up, and display the DHCP IP address it can be found at. - For initial setup we recommend a network with DHCP server - OLD INSTRUCTIONS : IF DEVICE NOT FOUND - You will most likely NOT follow these instructions anymore - If the 'Compute Module' is not found in step 6 please follow these steps: quit BalenaEtcher app open SKAARHOJ Updater app press keys '[Shift][Option][Cmd] R' (Mac) or '[Shift][Ctrl][Alt] R' (Win) to enable the 'Reflash BluePill-Inside controllers' mode (pic 1) connect Blue Pill device to computer via USB > hold paperclip pressed in the configuration hole on the device > connect power (PSU or PoE) when you see the device is connected (device x-xx.x is ready) you release the paperclip (pic 2) return to the procedure guide above. Follow all steps, except step 5 and 6, where you insert paperclip and power up device Reset and Reboot Procedures Have you tried turning the device off and on again? Sometimes all that is needed is a reboot. This can be done for the skaarOS / the full Blue Pill / or per package. Blue Pill Reboot On the Settings page, click the Reboot button in the System Information section.  Package Restart You can restart an individual package on the Packages page. Click on the status of the package (being Running or Stopped) to be restarted.  Then click 'Restart' in the pop-up.  Reactor > Clear config directory If a configuration has crashed Reactor, and you can only access the 'Packages' and 'Settings' pages, you may need to erase the content of the cofiguration directory. Note: This will ERASE ALL CONFIGURATIONS on the device. On the Packages pages, click 'Reactor'. Then click 'Clear config directory'. Finally click 'Confirm and restart'. Factory Reset If you really think you messed up the Blue Pill in some way, you can do a full Factory Reset of the unit. Note: This will ERASE EVERYTHING you have done on the Blue Pill device. On the Settings page, enable Advanced Mode In the System Information section there will now be a Reset button. Press it and follow the prompts.  Unable to Login In "If you enter the correct username and password, but are left in a loop on the login screen." Some Blue Pill devices with older software can have a bug, where the login page seems to be stuck. The solution to this is simply to use another web browser - ie. if you use Google Chrome, switch to Safari or Firefox - or vice versa. The bug has been fixed in our later software. So, when you have successfully logged in, please goto the Settings tab and update the software. Follow this guide to update the software: https://wiki.skaarhoj.com/books/blue-pill-reactor/page/update-software Unable to Update Device Cores/Packages/OS Scenario: When trying to do an update or load a new Device Core, Package, or Operating System (update only) an error occurs or the update will not progress.  Fix 1: Check that the BP has proper access to our servers. 1. Check there is internet connection available for your Blue Pill device 2. For updates the Blue Pill needs to be able to access pkg.skaarhoj.com on https to do updates via port 443 (standard) 3. The Blue Pill also uses a https call to https://www.ntppool.org to determine if it can reach the internet, so if that is not possible. 4. The blue Pill also needs to have access to network time via NTP, otherwise it might fail to validate the authenticity of update.           -NTP requires full bidirectional access to the privileged UDP port 123.           -The NTP servers we are using are:                  0.pool.ntp.org                  1.pool.ntp.org                  2.pool.ntp.org                 3.pool.ntp.org Fix 2: Download the cores to load manually onto the Blue Pill from https://devices.skaarhoj.com/   1. 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.  2. To download the core packages and OS that make the Blue Pill work, select  Other Packages  at the top of the page. Both the latest prerelease and stable release are available as options.  The specific version will be in the file name.  3. All of the packages are loaded onto the Blue Pill or Blue Pill Inside device via the Packages page.  At the very bottom is an option to Upload and Install Package 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   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.  UniSketch Panel Displaying Weird in Simulator Tab If your UniSketch panel is displaying weird in the Simulator tab, it may be due to old firmware on the UniSketch panel. For compatibility with Blue Pill, a UniSketch panel needs to be running UniSketch v2.5.14 or later. Starting with UniSketch v2.5.18, there were changes made to the Raw Panel implementation which is used to connect to the Blue Pill. These changes allow for better hardware mapping inside Blue Pill.  Please make sure your UniSketch panel is running the latest UniSketch release version using the Firmware Updater Application.  https://www.skaarhoj.com/support/firmware-updater 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.  2. To download the core packages and OS that make the Blue Pill work, select  Other Packages  at the top of the page. Both the latest prerelease and stable release are available as options.  The specific version will be in the file name.  3. All of the packages are loaded onto the Blue Pill or Blue Pill Inside device via the Packages page.  At the very bottom is an option to Upload and Install Package 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   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.