Firmware

From SpinetiX Support Wiki

Jump to: navigation, search
"Info"
You should always ensure that your HMP / DiVA device is running the most recent firmware version!

Introduction

The player embedded firmware governs how the SpinetiX device is functioning and provides low-level control, monitoring and data manipulation. The SpinetiX player operating system is built into the firmware. All firmware releases are signed by SpinetiX - any firmware that is not supplied by SpinetiX will not install on the SpinetiX player as the signatures are not identical. This ensures complete security from malicious code and extremely high reliability. The HTTP-based interface to access the player is also included within the firmware.

With every new firmware release, the performance and reliability of the SpinetiX devices is improved; the firmware releases are available for free, therefore it is strongly recommended to update your player firmware as often as possible.

The simplest way to have the latest firmware version on your player is to update the firmware using Control Center, either directly from SpinetiX server or using one of the alternative methods described below.

Firmware releases

See the firmware release notes for more details.

SpinetiX releases several firmware versions every year; one is usually a major release and the rest are minor releases (i.e. mainly with bug fixes). You should always ensure that your HMP / DiVA device is running the most recent firmware version!

The firmware releases are correlated with the software releases; also some software versions require a minimum firmware version on the HMP devices - see Software / firmware compatibility table for more details.

Major releases (e.g., 4.1.0, 3.2.0, 3.1.0, 3.0.0, 2.2.0 etc.) may introduce backward compatibility issues, therefore, if you plan to update the firmware of HMP devices from an existing installation throughout a major release, make sure to update one unit at first, test your content on it and, in case there are no problems, then update the firmware on the rest of the devices. For more details, see:

Download

All the firmware versions are available for download from SpinetiX server.

DiVA, HMP350, HMP300

To download the latest firmware version for HMP350, HMP300, and DiVA models, the following shortcuts:

To download a specific firmware version, use these shortcuts:

HMP200, HMP130, HMP100

To download the latest firmware version for HMP200, HMP130, and HMP100 models, use the following shortcuts:

To download a specific firmware version, use these shortcuts:


Note Notes:

Update the firmware in Control Center

The simplest way to have the latest firmware version on your player is to update the firmware from Control Center, either directly from SpinetiX update server or using one of the alternative methods detailed below.

The advantage of the incremental firmware update, comparing to a installation from scratch, is that the content and configuration settings are preserved on the HMP / DiVA device; the disadvantages are that:

  • it is possible only to update to a newer firmware version, if one is present at the specified source path, but not to downgrade (this is not recommended anyway);
  • it takes usually longer than a full reinstall from Recovery Console - which is faster, but the player settings are reset and any user content removed;
  • the update from a really old firmware may be done in two steps.

Updating via Control Center can take awhile depending on many factors:

  • The difference between the current and the new firmware versions - the greater the gap, the longer the process;
  • Network connection speed in case of updating from an external source, like the SpinetiX server;
  • The content playing on the device while updating - restore the default content to speed up the process.


Note Note:
Optionally, you can enable automatic updates and set at what time the player should check each day the server for updates.

Updating from SpinetiX server

Updating the player firmware from the SpinetiX server only requires the player to have Internet connection and be able to reach the SpinetiX update server. Otherwise, one of the alternative firmware update methods, detailed further down on this page, can be used instead.

Update on DiVA, HMP300, HMP350

Control Center - Updates available

To check if a new firmware version is available and to update to it, follow these steps:

  1. Access and log into the player web interface.
  2. Click on the gear icon from the top bar menu to access Control Center.
    If a firmware update is available, an exclamation mark will be shown in the Firmware summary box on the Control Center home page.
  3. Click on the Firmware summary box.
    Info about the available updates are shown
  4. If there are updates available, press the "Update Now" button to proceed with the firmware update.
    • Make sure that the device is not powered off during the update.
    • During the update, each library is downloaded, uncompressed, verified for integrity and then installed. At the end, the HMP is automatically rebooted.
    • You can monitor this process by pressing "Show" button during the firmware update.


Control Center - Operations - Firmware Update

Alternatively you can manually check for firmware update using the Control Center > Operations page:

  1. Go to the "Firmware Update" section
    1. Ensure that the "Update source" is set to SpinetiX server - depending on the HMP model this could be:
      • DiVA-> http://download.spinetix.com/diva/updates/
      • HMP350 -> http://download.spinetix.com/hmp350/updates/
      • HMP300 -> http://download.spinetix.com/hmp300/updates/
      • Major releases are not published right away on the mainstream update channel; but they are available at http://download.spinetix.com/hmp-next/updates/ .
    2. If the update URI is not set to SpinetiX server go to Control Center > Advanced Applications > Firmware to configure the Server URI.
  2. Click on the "Check Now" button.
  3. At the end of the check, the page reports the status, which can be:
    • X updates available: Firmware version 4.1.x (build 1.x.xxxxx).
    • No updates available: The HMP is using the latest version.
    • Update failed or Fatal Error: See the Troubleshooting section for more details.
  4. If there are updates available, press the "Update Now" button to proceed with the firmware update.
    • Make sure that the device is not powered off during the update.
    • During the update, each library is downloaded, uncompressed, verified for integrity and then installed. At the end, the HMP is automatically rebooted.
    • You can monitor this process by pressing "Show update log" during the firmware update.

Update on HMP200, HMP130, and HMP100

Control Center - Firmware
Firmware available for update

To check if a new firmware version is available and to update to it, follow these steps:

  1. Open HMP Control Center and click on the "Firmware Update" link (under the "Administration" menu on the left).
  2. Go to the "Settings" tab
    1. Ensure that the "Server URI" is set to SpinetiX server - depending on the HMP model this could be:
      • HMP200 -> http://download.spinetix.com/hmp200/updates/
      • HMP130 -> http://download.spinetix.com/hmp130/updates/
      • HMP100 -> http://download.spinetix.com/hmp100/updates/
      • Major releases are not published right away on the mainstream update channel; but they are available at http://download.spinetix.com/hmp-next/updates/ .
    2. If the update URI is not set to SpinetiX server, click on the "Reset to Default" button to restore the default URI.
  3. Go back to the "Firmware" tab, and set the update source to "From server".
  4. Click on the "Check for Update" button.
  5. While checking, a progress bar will be displayed. At the end of the check, the page reports the status, which can be:
    • X updates available: Updating now would install firmware version 3.3.x (build 1.x.xxxxx).
    • No updates available: The HMP is using the latest version.
    • Update failed or Fatal Error: See the Troubleshooting section for more details.
  6. If there are updates available, press the "Update Now" button to proceed with the firmware update.
    • Make sure that the device is not powered off during the update.
    • During the update, each library is downloaded, uncompressed, verified for integrity and then installed. At the end, the HMP is automatically rebooted.
    • You can monitor this process by pressing "Show update log" during the firmware update.

Alternative methods to update the firmware

When updating from SpinetiX server is not an option, for bandwidth saving, network security or any other reasons, you can update the firmware via your local web server (works best for multiple HMP devices) or using a USB flash drive (when setting up a local web server is too much of a hassle).

Updating from a USB drive

To update the firmware from a USB flash drive, follow these steps:

  1. Download the relevant spinetix-***-updates.zip file to your PC.
  2. Make sure that the USB drive is formatted as FAT (as NTFS is not supported).
  3. Extract this zip archive file into the root of the USB drive - a folder named "updates" is created. The directory structure must not be modified.
  4. Connect the USB drive to the HMP and wait few seconds for the USB device to be recognized.
  5. Open the Control Center of that player.
  6. Check that the USB drive is correctly detected:
  7. Check for update
    • for HMP350 and HMP300 devices: Open the Operations > Firmware Update page, change the "Update source" to "USB Key" and press the "Check Now"
    • for HMP200, HMP130, and HMP100 devices: Open the "Firmware Update" page, change the "Update source" to "From USB Key" and press the "Check for Update" button.
  8. You will see a message informing you of which updates are available.

Updating from a local web server

Note
This section does not apply to DiVA players.
Firmware update settings
Firmware Update > Settings tab

To update the firmware from your local server, follow these steps:

  1. Download the relevant spinetix-***-updates.zip file to your PC.
  2. Extract this zip archive file into a folder on your local web server (e.g. ~/public_html/hmp/), accessible via HTTP.
  3. Open Control Center and go to
  4. Set the "Server URI" to the address of your server (e.g. http://myupdateserver/hmp/updates/).
    • Optionally, you can enable automatic updates and set at what time the HMP should daily check your local server for updates.
  5. Click on the "Apply" button to save the modifications.
  6. To check for updates, open
  7. You will see a message informing you of which updates are available.


Note Note:
There is a known incompatibility about using IIS 7 as firmware update server, because it does not allow certain characters in file names, some of which are included in the paths of the update files.

Troubleshooting

Update failed

The most probable source of this error is that the player could not contact the update server. Check that the network settings are correct and it has Internet connection. Then check out the error message reported in the update log against the ones detailed below:

  • failed parsing repository URI
    The updates website is temporarily unavailable or a proxy server / ISP warning page is being returned instead of the SpinetiX site page. Check the Server URI in a browser on a PC running the same network configuration.
  • failed retrieving repository path 'repodata/repomd.xml' (could not connect to server)
    There is a problem with the player connection to the Internet. Fix the connection issue and try again.
  • failed fetching 'repodata/repomd.xml' (404 Not Found)
    The update server name is most likely misspelled. Reset to the default SpinetiX server and try again.
  • failed fetching 'repodata/repomd.xml' (server or proxy hostname lookup failed)
    Make sure that a network gateway and DNS servers are correctly configured and that the player is connected to the network.
  • failed fetching 'repodata/repomd.xml' (403 Forbidden)
    Most probably the player is configured to use a proxy for Internet access and the proxy is returning the 403 error; either remove the proxy or change the settings on the proxy server to allow the access to our server.
    Otherwise, it could be a transparent proxy or firewall in between that forbids this file - a possible workaround is to use HTTPS instead of HTTP.
  • failed fetching '{Filename}.rpm' (400 Bad Request)
    This can happen when using a proxy to connect to the Internet. The download of the repomd.xml was successful, but the *.rpm files are blocked by the proxy. Contact your network administrator or use an alternative firmware update method.
  • authentication failed on server
    In this case, contact SpinetiX Support and provide a report from the player.

Fatal error

This is usually the result of a firmware update being stopped during the process, leaving the player in a non-stable state; in this case see how to install the firmware in Recovery mode.

Install the firmware in Recovery mode

The process of installing the player firmware from the Recovery Console works as follow:

  1. The internal storage is formatted, so the existing firmware files (including the configuration settings) and the user content are completely removed.
  2. The selected firmware version is installed from scratch.

Installing the player firmware is necessary in case of firmware corruption, but can also be used when wanting to downgrade the firmware or when the firmware update would take too long.


Note Note: Before reinstalling the player firmware, you might want to generate a configuration backup and make sure you have a copy of the content.

Reverting to factory default firmware

The factory default firmware is permanently stored on the player, regardless of the current installed firmware. If needed, the player can be reverted to the factory default firmware, by following these steps:

  1. Boot the HMP into Recovery mode.
  2. On the "Main" page, under "Install new firmware" section, check if the factory installed system firmware is present.
  3. If so, click on the "Install Factory Image" button.


Note Notes:
  • The device is restored to the same state as when it left the factory - this could mean that the firmware is not the latest one, therefore you might need to update to / install the latest one afterwards.
  • In case the factory firmware got corrupted, then use the installation procedure based on PKG files, as detailed below.
  • To restore the factory default settings without reinstalling firmware, see the Reset to factory default settings page.
  • This functionality is not available on the HMP100 with serial number below 001d500000d7.

Installing a specific firmware

You can install a specific firmware version (the latest one recommended) using the corresponding PKG file that can be downloaded from SpinetiX server.

Procedure

To install a specific firmware version, follow these steps:

  1. Download the relevant PKG file (e.g., fw-spinetix-hmp350-***.pkg, prod-fs-spinetix.hmp200-***.pkg etc.) onto your PC.
  2. Boot the HMP into Recovery mode.
  3. On the first page of the Recovery Console ("Main" page), click on the "Browse" button (next to the "Firmware image package:" field).
    • The "Browse" button might be translated into your language by the browser.
  4. Select the PKG file that you have downloaded from SpinetiX site from your PC.
  5. Click on the "Upload and install this image" button.
  6. Wait for the installation process to complete.
  7. (Optional) If you need to set a static IP or to avoid loosing the one previously set, follow the procedure below.
  8. Reboot the player into normal operating mode.

Avoid resetting the static IP

If you need the player to use a specific IP address after a firmware installation from the Recovery Console, follow the procedure below:

  1. Do not reboot at the end of the installation process.
  2. Open the "Diagnostics" page.
  3. Go to the "System configuration" / "Change configuration" / "Add configuration change" section.
    • The name of the section is different depending on the hardware revision of your player.
  4. Set the IP configuration and click on the "Set change" button.
  5. Reboot the device.

Error messages concerning firmware

  • "tar: gzip: Cannot write: Broken pipe"
    The PKG file is corrupted. Download the file again after clearing your browser's cache.
  • "Could not recover firmware image package file"
    If you receive this error when trying to update from a PKG file, attempt to install the factory default firmware.
    If you receive this error when installing the factory firmware, then contact SpinetiX Support.
This page was last modified on 8 December 2017, at 11:22.