PiBoy DMG Firmware and Script Updates

PiBoy DMG Firmware and Script Updates

Figure 1: The firmware for the PiBoy can be updated as newer versions are released.

This article covers updating the software on a PiBoy that has already been previously set up correctly. The osd and shutdown scripts should be updated before the firmware is updated.

Updating all of the software on the PiBoy is useful for upgrading to new features in updates released by Experimental Pi. Besides new features, new software releases may also contain fixes for problems that have been found. Follow the instructions below, in order, to update all of the Experimental Pi specific software on your PiBoy.

Update OSD and Shutdown Software

1. Remove the micro SD card from the PiBoy and insert the card in to a computer.
2. Open the card on the computer and you should be in the /boot directory.
3. Download the custom software zip file and unzip it. The software can be downloaded here.
4. Move all of the files in the inner folder to the /boot directory on the sd card. The config.txt file will be overwritten, if prompted allow it.
5. open the cmdline.txt file with a text editor
Remember no newline are allowed in the file, all of the text must be on one line. The text to add can also be found in the README.txt file in the folder unzipped earlier.
6. Add the following text to the end of the first line in the file.
init=/bin/bash -c "mount -t proc proc /proc; mount -t sysfs sys /sys; mount /boot; source /boot/unattended"
7. An internet connection may be necessary for the installation to complete. The easiest way to connect the PiBoy to the internet is to connect an ethernet cable between the PiBoy and your router. However, you can add your wifi credentials to the one-time-script.conf file. Open the file and enter your network name and password in betwen the quotes in the fields labelled "new_wifi_ssid" and "new_wifi_password". Remove the "#" character from in front of each field and then save the changes to the file.
8. Safely eject the sd card from your computer.
9. Insert the sd card in to the PiBoy and turn it on. The PiBoy will go through several boot/reboot cycles before it is ready. This process can take several minutes. If the PiBoy DMG is connected to an external screen via the HDMI out feature you can watch the boot cycling process. Optionally, you can hold down the Start button when turning the PiBoy DMG on to force the display to show the installation process.

Updating Firmware

1. First, download the firmware and update tool from here. The USB driver is also found in this download.
2. Unzip the file in a convenient location.

Figure 2: The software download unzipped.

3. Open the folder and install the USB driver for your system. If you are running a 32-bit version of Windows use the DPinst.exe and if you are running a 64-bit version of Windows use the DPinst64.exe. Double clicking on the file will start the installation process.

Figure 3: Installation of the USB driver.

4. Open the folder and locate the file called PiBoyDMGUtility.exe. Double click on the file to start the firmware updater.
5. Click the comport dropdown and make a note of the comports listed. Once the PiBoy is plugged in a new comport will appear so pay attention to what is listed before the PiBoy is plugged in.

Figure 4: The firmware flashing application started.

6. Make sure the PiBoy's power switch is in the off position.
7. Plug a micro USB cable in to the PiBoy.
8. Press the joystick in until it clicks and hold it down while turning the PiBoy on. Release the joystick button. The power LED should begin to flash red.
9. Plug the other end of the micro USB cable in to the computer being used.
10. In the firmware loader app select the new comport that has shown up in the dropdown. You can also check the Device Manager to see what new comport has been assigned to the PiBoy.

Figure 5: Installation of the USB driver.

11. Click the Start button to begin flashing the firmware.

Figure 6: The comport selected in the loader application and ready for flashing.

12. The progress bar will show that flashing is occurring. Once it disappears the flashing is complete.
13. Close the firmware loader application.
14. The PiBoy will now reboot. Once the PiBoy has finished rebooting turn the PiBoy off and disconnect the microUSB cable. Make sure the PiBoy has fully shutdown before removing the cable.