Getting started with the Balluff Update Platform (BUP)¶

Welcome to the Balluff Update Platform (BUP) documentation. Here you’ll find an overview of BUP, its features, and step-by-step instructions for getting started and managing updates efficiently.

This getting started guide will help you to find and download artifacts that are associated with your Balluff product, such as firmware updates or configuration files.

Prerequisites¶

Please ensure you have the following information before proceeding:

• The 7 digit order code or the type code of your Balluff product.
  This information is printed on the device or can be seen on various interfaces like Balluff Engineering Tool or BNI/Network Block Module.

• The hardware version of your product, if applicable.
  This information can usually be found on the device label or in the product documentation.

Find and download product artifacts¶

To find and download product artifacts, follow these steps.

1. Access the Balluff Update Platform. To do so, open your web browser and navigate to https://update.balluff.systems. You will be redirected to the Products menu.

   

2. To find entries for your product, enter the seven digit order code or the type code in the search field. From the previewed results, click on your product to open its dedicated product page.

   

   The product page opens and shows information about the latest available release for your product.

   

3. To navigate to the desired release, open the dropdown box showing the currently selected release and select the needed version. The downloadable files are presented in the table below.

   

   Check if the listed files match your products hardware version. The information is displayed on the right side, next to the release notes.

   

   Note

   When compatible hardware includes versions like

   • 1.*.* then the release is compatible to all versions beginning with major version 1.

   • 1.1.* then the release is compatible to all versions beginning with major and minor version 1.1.

   When there is no compatible text, the release is valid for all devices containing this order code.

4. (Optional) To get a bookmark of the newest release you need to save the URL without the filter after the order code.

5. (Optional) You may want to verify artifact file information before download, see Information of release files

6. To download a file, click on the download icon on the right side of the respective file row.

   

   Warning

   Do only install firmware on compatible hardware versions.

Filter for artifacts¶

To filter the available artifacts for specific types:

1. Navigate to the desired product release, see Product page.

2. To open the filter options for artifact types, click on the filter icon on the right side of the release field.

3. A new box for Artifact Types appears. To select the filter conditions, click on the checkboxes of the desired artifact types. To confirm your selection, click outside of the box.

   

Release Notes¶

To view the release notes of a selected release:

1. Navigate to the desired product release, see Product page.

2. Click on the Release Notes button right of the release field. The release notes will be displayed on the right side.

   

3. To close the release notes, click outside the release notes drawer.

Information of release files¶

To see additional information about a file:

1. Navigate to the desired product page, see Product page. A Table with available release artifacts is displayed.

2. Verify the artifact you want to download:

   • Artifact Type is correct one.

   • Artifact Name matches your needs.

   

3. Click on Information icon in the artifact line.

   Verify the file information:

   • Check Description if available.

   • Review remaining information.

   

   Hint

   The integrity of a downloaded file can be checked by comparing the SHA256 hash with the one shown in File information window

4. Click outside of the File information window to close it.