Programming Tool User Guide

This document provides detailed instructions on how to set up, use, and troubleshoot the programming tool.

Getting Started

Follow these steps to set up and use the programming tool to update the firmware on a Controller Display:

1. Install the STM Tools and Drivers

  1. Download, unzip and install either the x64 or x86 installer depending on what type of system you have.

    SetupSTM32CubeProgrammer_win32.zip

    SetupSTM32CubeProgrammer_win64.zip

  2. Follow the on-screen instructions to complete installation and install drivers.

  3. Plug in ST-LINK Programmer, and ensure there are no driver errors in the Device Manager

<aside> ❓

This step only needs to be done once on first setup

</aside>

2. Prepare Programming Tool and Firmware

  1. Download and unzip the Controller Programming Tool

    ControllerProgrammingTool.zip

  2. Copy the provided firmware files (flash_b1_vx.x.x.x.bin, qspi_b1_vx.x.x.x.bin) into the unzipped folder (i.e. the same directory as the ControllerProgrammingTool.exe)

<aside> ❓

Up to two different firmware files may be provided. The flash_b1_vx.x.x.x.bin file contains the control application, and the qspi_b1_vx.x.x.x.bin file contains the screen UI graphics. Please contact CranePower for these files if they are not provided, or for advice on which firmware version should be installed onto your hardware.

</aside>

Programming

Steps for programming a screen with new firmware:

  1. IMPORTANT: Starting with the control system powered down (screen off), change the UPS timer from 1 min to 5 min. This will keep the screen controller power on during the update. If you don’t do this step, the screen may power off during the update. This is not an issue, but will required you to restart the update process.

    image.png

  2. While the screen is powered, connect ST-LINK Programmer to computer, and plug the 6-pin connector onto the SWD port on the back of the screen controller.

    image.png

  3. Check the required firmware files (flash_b1_vx.x.x.x.bin, qspi_b1_vx.x.x.x.bin) are present in the same directory as the ControllerProgrammingTool.exe program.

  4. Run the ControllerProgrammingTool.exe program, and check that the files have been detected in the file paths at the top of the window. If the files have been renamed, you will need to select them.

    image.png

  5. Click Program to begin the programming sequence. This may take several minutes, especially if updating the graphics firmware file.