This guide explains the steps to prepare an OpenPV display with the firmware and low-level tools needed to begin development with a Windows computer.
A condensed guide is available HERE.
To prepare an OpenPV display for development:
Establish and Verify a Connection
➤ Verify the display has functional power supplied by powering it on and making sure the logo or installer screen appears.
➤ Connect the display panel to Development Computer via USB-C cable and listen for the USB connect sound.
There should be no need to change any network addresses in Windows - OpenPV communicates with the display at its default address of 192.168.7.1, and this should not need to be changed. On Windows 11 it will appear in Network Connections as a "Remote NDIS Compatible Device" except when it is in DFU mode, which does not use networking.
Power must be supplied to both the battery pin and the ignition pin for the display to power on.
Boot Display into DFU Flash Mode
➤ Remove power from the display.
➤ Place small high-powered magnet to the triangle/circle icon on the back of the display in the area below the USB port as shown in diagram below.
➤ Supply power to the display while keeping the magnet in place.
NOTE: Magnet placement as well as orientation may affect the strength of the magnetic field on the boot-mode sensor. Multiple attempts may be needed.
Successful engagement of DFU Flash Mode will be indicated by a USB Connect tone on the Development Computer very quickly after powering on the display. The display screen will remain completely black.
If the display screen lights up, the attempt failed. Remove power to the display, adjust magnet placement/orientation, and supply power again.
➤ Once the USB Connect tone has been heard and the display screen remains black, the magnet can be removed and the unit will remain in DFU mode.
Install Firmware on Display
➤ Start the OpenPV Developer Toolkit.
➤ Click the Displays button in the Main Toolbar. (1)
Verify the correct display is selected. (2)
Verify the correct model of display is selected. (3)
➤ Click the Flash Distribution button in the Actions side panel. (4)
A console window will display the status of the firmware flash process and then close.
Upon completion, reopen the console message window by clicking the Console button in the main toolbar. (1)
➤ Verify “Image Installed and device ready for Prep” is shown at the end of the journal. (2)
If errors are encountered, copy the entire journal to the clipboard by clicking the Copy icon near the upper right corner of the Console window. (3)
Exit the Console installation journal by clicking the X in the upper right corner.
Exit DFU Flash Mode
➤ Exit the flash mode by cycling the power to the Display. After reapplying power, please wait approximately 2 minutes for the installation to complete.
Upon re-supplying power the first time after flashing, the Display will remain completely blank for around 50 seconds. A series of USB connect/disconnect tones should be heard, and then the Helios Logo will appear on the display screen.
Once the display has fully booted, it is ready to Prep.
Install Platform Support files for the Display
➤ Make sure the display unit has been power cycled and has finished booting to the Helios logo screen.
If it is not already running, start the OpenPV Developer Toolkit
➤ Click the Displays button.
Verify the correct display is selected. (1)
Verify the correct model of display is selected. (2) <-- This is critical during Prep
➤ Click the Prep Display button in the Actions side panel. (3)
The Console will open and show the current status of the Prep process.
Upon completion, the console window will close and the display will begin a reboot.
If a copy of the journal is desired, click Console in the main toolbar and click on the copy icon to place the contents on the clipboard.
Once the display reboot has completed, the display will show the Ahsoka.Installer.UI application screen with two circular icons or a QR code.
In the OpenPV toolkit, the current display connection and running application will show in the bottom left corner of the window. If it does not show the connection after about a minute, close and restart the OpenPV toolkit.
The display is now ready to Load an .OPV file or Load a Demo Project.