Upgrading your Raspberry Pi to the latest development beta of RISC OS (changes)

Showing changes from revision #4 to #5: Added | Removed | Changed

Introduction

This page details the process for upgrading an already-working RISC OS installation on a Raspberry Pi to RISC OS 5.29. 5.31.¹

Please note: RISC OS 5.29 5.31 is a development release that contains untested, work-in-progress software. Some components may be unfinished and/or contain serious bugs: that is what development is about! You should only useRISC OS 5.29 5.31 if you are willing to accept the risks involved and have a suitable backup strategy in place.

Having said that, many development builds ofRISC OS 5.29 do work well. It may simply be a matter of trying a few different nightly builds until you find one that meets your needs.

¹ If you wish to upgrade to the latest stable release (5.28) (5.30) please seeRISC OS Upgrade instead.

Prerequisites Before you start

You will need to download the following software:

• The Beta ROM image from the Raspberry Pi downloads page.
• The Beta HardDisc4 image from the Miscellaneous downloads page.
• Updated Raspberry Pi firmware suitable for RISC OS 5.29. 5.31.

If you are upgrading from 5.24, 5.28 5.25, 5.26 or 5.27, 5.29, you will also need:

• The Stable HardDisc4 image from the Miscellaneous downloads page.

A certain level of RISC OS knowledge is assumed, including how to use the command line, how to usethe command line, how to use the !Configure application and how to edit text files.

• RISC OS 5.28Use the “Boot merge” facility (!Configure > Boot > Install) to install the new version of !Boot from the Beta HardDisc4 image. Reboot and fix anything that’s broken.²
• RISC OS 5.24, 5.25, 5.26 or 5.27 (including RC16)
• RISC OS 5.19, 5.21 or 5.23 (RC15 or earlier)

• Replace all the ordinary applications (i.e. the contents of every directory except !Boot) from the Beta HardDisc4 image. Simply delete the old application of the same name (e.g. !Maestro) and copy the new application across.

^{4 2} “Boot Merge” saves all replaced files in the !Boot.Backup directory – this will allow you to retrieve any changes you may have made to !Boot components (e.g. amendments to a built-in monitor definition file) if they have been overwritten.

At ³RISC OS 5.29, two The build date is mentioned immediately below the download link itself. Although listed as nightly builds, the average build frequency is closer to “once every 3-4 days”.CMOS RAM configuration settings – “MonitorType” and “WimpMode” – must hold valid information. Releases up to RISC OS 5.26 are rather forgiving of unusual values in these two fields, but from RISC OS 5.28 they must be correct or the monitor may not display a picture.

Preparing for the upgrade

• Edit the file called CMDLINE/TXT inside !Boot.Loader (if it doesn’t already exist, create it) so that the text disable_gamma appears on the first line of the file.
  For example, if the file already contains “disable_mode_changes”, you would edit the first line to read:
  disable_mode_changes disable_gamma

• Check that CONFIG/TXT (inside !Boot.Loader) contains – at minimum – the following lines:
  fake_vsync_isr=1
framebuffer_swap=0
gpu_mem=64
init_emmc_clock=100000000
ramfsfile=CMOS
ramfsaddr=0x508000
kernel=RISCOS.IMG
  If any lines are missing, you should add them. Do not remove any entries at this stage.

• If you want to use the build on a Pi 4, make sure that the following three 4 lines appear at thebeginning of CONFIG/TXT:
  [pi4]
enable_gic=1
[all]
arm_64bit=0
  It’s probably best to insert these lines even if you aren’t using a Pi 4 – that way you won’t be caught out if you subsequently start using a Pi 4.

• Copy Create an “OldFiles” directory inside !Boot.Loader, then copy the existing versions ofRISCOS/IMG, BOOTCODE/BIN, START/ELF and FIXUP/DAT from (for !Boot.Loader to another location, in case you need to regress to the old Pi 4, copy START4/ELF and FIXUP4/DAT as well) into “OldFiles”. This will allow you to regress to the old ROM version. version if necessary.

Installing the 5.29 5.31ROM

• Enter the *Unplug command. This should report “No modules are unplugged”. If it does list any unplugged modules, enter *RMInsert commands for each unplugged module.
  For example, if the GPIO module is unplugged, you should enter:
  *RMInsert GPIO
  Please note that you must RMInsert every unplugged module, module as the order of modules in the new⁴, as the order of modules in the new ROM may be different (which could cause the wrong module to be unplugged at the next boot).

• Check that !Boot.Loader contains a file called “CMOS”. If it doesn’t exist, use the *SaveCMOS command to create it:
  *SaveCMOS !Boot.Loader.CMOS

• Install the updated firmware (BOOTCODE/BIN, START/ELF, FIXUP/DAT ) into !Boot.Loader. If you’re using a Pi 4, you will also need to install START4/ELF and FIXUP4/DAT.

• Install the Beta ROM (RISCOS/IMG) into !Boot.Loader.

• Wait Close all Filer windows, wait 15 seconds, then press shut Ctrl-Break down to reboot. If your keyboard doesn’t have a Break key, shutdown and power restart off then power on again.RISC OS.

After rebooting on RISC OS 5.29 5.31

• Go Make to a !Boot.Choices.Boot.Predesk backup and copy delete of the your !!ZeroPain directory (if present). If you want to continue using ZeroPain, install the latest version from the Bonus Binaries archive (available on theMiscellaneous downloadsCMOS page). settings Note (either that via “ RISC CMOS OS > 5.29 Save” will under run !Configure, happily or without by ZeroPain. using *SaveCMOS) as some of the settings may have changed during the upgrade.⁵

• If !Boot.Choices.Boot.Predesk you contains want a to file unplug called BootFX “Alarm”, again, delete it. The Alarm application now stores its settings elsewhere, so this file is no your longer chance required. to do so.

Common problems with the upgrade

• The Monitor mouse doesn’t pointer display is a visible picture but the rest of the screen is black (either on boot or when selecting a 256-colour screen mode)
  You upgraded the EITHERROM: You didn’t upgrade some (or all) of the firmware, but didn’t upgrade the firmware (bootcode.bin, start.elf, fixup.dat).
  OR: you didn’t put “disable_gamma” on the first line of cmdline.txt.

• Desktop is displayed at a lower resolution than usual
  Use “Configure > Screen” to change the monitor settings. To use EDID, choose a monitor type of “Auto(your-monitor-name-here)” (e.g. “Auto(L225W)”) and a resolution of “Native”.

• Configuration changes don’t survive a reboot
  (1)
  • CONFIG/TXT (inside !Boot.Loader) may be missing the lines that load the CMOS file on boot. Check that the following lines are present:
    ramfsfile=CMOS
ramfsaddr=0x508000
  • Alternatively, the CMOS file (inside !Boot.Loader) is missing/corrupted/read-only, or another file called CMOS also exists in the root directory of the Filecore partition (i.e. you have a file called $.CMOS in addition to $.!Boot.Loader.CMOS). Delete any wayward file(s), then issue:
    *SaveCMOS !Boot.Loader.CMOS
  CONFIG/TXT (inside !Boot.Loader) may be missing the lines that load the CMOS file on boot. Check that the following lines are present:
  ramfsfile=CMOS
ramfsaddr=0x508000
  (2) The CMOS file (inside !Boot.Loader) is missing/corrupted/read-only, or another file called CMOS also exists in the root directory of the Filecore partition (i.e. you have a file called $.CMOS in addition to $.!Boot.Loader.CMOS). Delete any wayward file(s), then issue:
  *SaveCMOS !Boot.Loader.CMOS

• Unexpected behaviour “ in applications after installing the 5.29 ROM SWI not found” messages during boot-up
  
  • This can happen if you installed the ROM without upgrading !Boot (or perhaps the attempted upgrade of !Boot didn’t go as well as you had hoped).
  • Alternatively, one or more modules are unplugged (enter *Unplug to check status). If any modules are unplugged, use *RMReinit to reinstate them (e.g. you would use *RMReinit GPIO to reinstate the GPIO module).
  • There may be a bug in the specific ROM build you chose. Check the forums to see if anyone else has reported a problem; if necessary replace the ROM with another 5.29 nightly build to see if that is any better.
  This usually indicates that one or more modules are unplugged. Enter *Unplug and issue *RMReinit commands for each of the modules on the list (e.g. you would use *RMReinit GPIO to reinstate the GPIO module).