RISC OS Direct 5.31 upgrade for Raspberry Pi
============================================

This zip contains everything you need to update an existing RISC OS 5.28
or RISC OS 5.29 edition of RISC OS Direct to the 2024 RISC OS 5.31 edition.

** This update should only be used with an existing copy of RISC OS **
** Direct for Raspberry Pi.  It is not tested nor recommended to be **
** installed on any other computer / system.  For other systems,    **
** please contact your supplier to obtain upgrades.                 **
**                                                                  **
** RISC OS Developments cannot be held responsible for any use or   **
** misuse of this update.                                           **

This is a large update because a lot of software has been enhanced and
improved in the interim, and this new edition contains a lot of new
functionality - most notably wireless networking support, a modern
web browser with HTML5/CSS/Javascript and video playback for MP4, MKV
and DVD movies.  It also includes the new Pinboard 2.0 desktop.

The update will preserve your data and settings wherever possible.
In the handful of cases where this isn't practical, backups are made
for your convenience.

Installation Overview
---------------------

There are essentially three steps to the upgrade, and they can (and
probably should) be done one after another, in the same session.
These steps can be summarised as:

  * Run the Prepare script to make sure your existing RISC OS
    Direct is ready to be upgraded

  * Copy the updated disc image on top of your existing RISC OS
    Direct files to update them

  * Run the RISC OS Direct 5.31 ROM installation program to
    update the OS ROM and supporting files.

Note - if this sounds too complex, remember that you can also
download a fresh RISC OS Direct 5.31 disc image which comes
ready to use.  However, you would lose any data you have on
the disc you write the new image on to.

Detailed Installation Instructions
----------------------------------

You can conduct the upgrade from the zip on your main drive,
although we recommend that the ROM update be unpacked to
RAM disc (or other drive) - we'll talk about that when we
get to it.


1) Start by double clicking on the Prepare obey file.  This
will run it and open a white window with text in.  This
will prepare your main drive to be updated, and back up
some files to a folder on your desktop.

Note - this folder won't be visible immediately - it utilises
a feature of Pinboard 2.0 which will become active after
the upgrade.

Once the script completes, you'll see the message:

 Preparations complete - you may now go ahead and update
 your copy of RISC OS Direct


2) Open the Disc folder by double clicking on it in this
zip.  Inside you'll find things like !Boot, Apps and so
on.  We'll call this "Window A".  Drag Window A to one side
of your screen, then open your main drive (which should
also have things like !Boot and Apps).  We'll call this
"Window B".

Now, press Menu (middle) mouse button over Window A and
pick "Select all" (or do Ctrl-A).  Drag the selected
items onto Window B (your main drive).

Note - this assumes that you haven't altered the names/
layout of the folders on the disc.  If you have, you'll
need to copy the elements from Window A (the zip) one
by one, to match whatever customisations you made.


3) Finally we need to update the ROM.  Open the ROM
folder in this zip - you should see !OSupgrade.  We
recommend that you drag that to your RAM disc, and
run it from there.  It may well be fine running it
from the zip, but our advice would be to copy to RAM
disc first.  Double click !OSupgrade to run it.

The !OSupgrade program will tell you about some of
the new features in RISC OS 5.31.  It will then
have buttons to Upgrade the OS, or Revert to the
previous version (if you have any problems).

Click "Upgrade OS" to begin updating the ROM.  When
the process is complete, it'll prompt you to click
forwards, then suggest you reboot your computer.

4) You can now shutdown and restart your computer,
or simply do a Ctrl-Break.  Your computer will
now reboot into RISC OS 5.31 with all the new
software and features.


What to Expect After Rebooting
------------------------------

When you reboot, you'll see the RISC OS Direct First
Time Setup screen appear.  This will guide you through
things like altering mouse behaviour and setting up Wifi.

If this doesn't run, you can find !1stDirect in the
Utilities folder, and run it from there.

You can double check that the upgrade has been applied
correctly by pressing Menu (middle) mouse button over
the RISC OS Direct logo in the bottom right of the
screen, and going to Info.  It should report version
5.31 (21-Jul-24).

Finally, go to the Utilities folder and run !ChangeFSI.
Press Menu (middle) mouse button over it on the iconbar
and go to Info.  It should report version 1.70 (10-Jul-23).


Questions & Answers
-------------------

1) Where did my pinboard and/or startup apps go?

As part of the upgrade process, it is necessary to
replace some of the existing startup files with new
versions.  To ease the transition, we have backed up
your old copies to the "Direct Backups" folder on
your desktop.

In the case of the pinboard, you can probably just
run that file to re-add your icons.  In the case
of startup apps, we suggest shift-double clicking
on the old "Desktop" file and reading it for a
reminder of what you used to run, and then re-add
them by double-clicking !Boot on your main drive,
then going to "Boot", then "Run at Startup".

2) What is Iris that has appeared on my desktop?

Iris is the new HTML 5 / CSS / JavaScript web browser
developed by RISC OS Developments Ltd in partnership
with Lee Noar.  It is powered by the WebKit browser
engine.  More info can be found in the Network.Iris
folder.

3) How do I connect to Wifi?

Assuming you completed the First Time Setup process,
you will have been prompted about networking.  If
you picked the first option - NetManager & Wifi -
your computer should have rebooted, and you now
have a Wifi icon on your iconbar (assuming Pi 3 or
later).  You can press menu over it to pick your
Wifi network, then sign in to it.

If you wish to auto-connect in future, click the
NetManager icon next to the Wifi icon, and edit
your profile.  Go to the Wifi interface and
set up a Wifi network to connect automatically.

4) What is Pinboard 2 that was mentioned earlier?

Pinboard 2 is the "desktop" - the rest of the screen
that isn't the iconbar (although Pinboard 2 can
improve the iconbar too).  The new version adds
many features found on other operating systems such
as the ability to save files to the desktop, set
up carousels of wallpapers, add sticky notes and
so on.

If you have full screen wallpapers, you can also
enable a transparent iconbar effect, so that the
wallpaper is partially visible through the iconbar.

A full manual can be found in Documents.Manuals.Pinbaord2



