Skip to content

GitLab

Commit ab43c964 authored by Robert Sprowson's avatar Robert Sprowson
Browse files

Sync ReadMe's with eachother 

Some close relatives had become out of sync.
OMAP4 install script was trying to run SCSIForm.
Imported softload directory for IOMDHAL.
Some typos in the documentation ammended.

Version 0.48. Tagged as 'ABRelease-0_48'
parent 6e9292f1
Hide whitespace changes
Inline Side-by-side
Showing with 242 additions and 71 deletions
Docs/ReadMe
View file @ ab43c964
......@@ -7,7 +7,7 @@ that they can more fully interact with the Autobuild system.
HOW IT WORKS
The ABRelease component will run a build-specifiy script (obey file) for each
The ABRelease component will run a build-specific script (obey file) for each
phase of the build process to allow any special behaviour to take place. To
do this, it will invoke the script by running it from a specific path, which
includes (in this order) the following Resources subdirectories:
......@@ -79,9 +79,9 @@ some environment variables before looking for and runnnig the script for a
given build phase (if it exists):
ab_res$dir - the Autobuild resource directory (e.g. Resources.TungstenDev)
ab_red$path - the Resources path, as described above
ab_res$path - path equivalent for convenience
ab_build$dir - the directory on the Autobuild server to upload into
ab_build$path - path to ab_build$dir - for convenience
ab_build$path - path equivalent for convenience
ab_zip$file - the name of the zipfile to create on the Autobuild server (if any)
Note: some types of build might upload something other than a single zipfile
......
Makefile
View file @ ab43c964
......@@ -14,7 +14,7 @@
#
# Makefile for Autobuild
#
# This component should be placed into (disc) builds as the final component
# This component should be placed into (any type of) builds as the final component
# so that it can perform any final installation tasks, such as copying files
# into archives, adding pre-built binaries, etc.
#
......
Resources/IOMDHAL/ReadMe.txt
View file @ ab43c964
RISC OS Open Release Archive
============================
This is the IOMD (A7000 and RiscPC) development ROM image. It is a
This is the Risc PC/A7000/A7000+ development ROM image. It is a
bleeding-edge build which comes from the latest revisions of all the relevant
sources in our source code repository and is completely untested.
Softloading this ROM image should only be done if you are confident that you
know what you are doing and have a good backup strategy in place! It is
likely to be incomplete and only partially functional.
Softloading it should only be done if you are confident that you know what
you are doing and have a good backup strategy in place!
Some components in this archive are released under the licence (included in
this archive as Licence_v1_1.pdf), or see:
......
Resources/IOMDHAL/clean,feb 0 → 100644
View file @ ab43c964
| Copyright 2013 Castle Technology Ltd
|
| Licensed under the Apache License, Version 2.0 (the "License");
| you may not use this file except in compliance with the License.
| You may obtain a copy of the License at
|
| http://www.apache.org/licenses/LICENSE-2.0
|
| Unless required by applicable law or agreed to in writing, software
| distributed under the License is distributed on an "AS IS" BASIS,
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
| See the License for the specific language governing permissions and
| limitations under the License.
|
| Set up and/or override some system variables
Set ab_local$zip rom-iyo/zip
Set ab_local$soft soft-iyo/zip
Set ab_soft$dir <ab_res$dir>.soft.!Boot.Choices.Boot.PreDesk.!!SoftLoad
| Remove any old crud from our resources directory
x Wipe <ab_res$dir>.zip ~cfr~v
Remove <ab_res$dir>.<ab_local$zip>
Remove <ab_res$dir>.<ab_local$soft>
Remove <ab_res$dir>.soft.Licence_v1_1/pdf
Remove <ab_soft$dir>.riscos
\ No newline at end of file
Resources/IOMDHAL/release_autobuild,feb 0 → 100644
View file @ ab43c964
| Copyright 2013 Castle Technology Ltd
|
| Licensed under the Apache License, Version 2.0 (the "License");
| you may not use this file except in compliance with the License.
| You may obtain a copy of the License at
|
| http://www.apache.org/licenses/LICENSE-2.0
|
| Unless required by applicable law or agreed to in writing, software
| distributed under the License is distributed on an "AS IS" BASIS,
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
| See the License for the specific language governing permissions and
| limitations under the License.
|
| If there is no ROM image (e.g. the build failed), exit here
IfThere <Build$Dir>.Images.<Build$ImageName> Then Else Obey
| Run our clean script
Run <ab_res$dir>.clean
| Create an empty directory to hold the files that will be zipped up
CDir <ab_res$dir>.zip
| Copy the Castle licence file into the zip directory
Copy ab_res:Licence_v1_1/pdf <ab_res$dir>.zip.Licence_v1_1/pdf ~cf~r~v
| Copy the ReadMe for this build into the zip directory
Copy ab_res:ReadMe/txt <ab_res$dir>.zip.ReadMe/txt ~cf~r~v
| Compress the ROM image into the zip directory
Do rompress -vZps 4M <Build$Dir>.Images.<Build$ImageName> <ab_res$dir>.zip.riscos
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
| Create a zip archive with the required files in it
Do zip -9qr ^.<ab_local$zip> *
| Return the CSD to its original state
Back
| Create the softload zipfile
Copy ab_res:Licence_v1_1/pdf <ab_res$dir>.soft.Licence_v1_1/pdf ~cf~r~v
Copy <ab_res$dir>.zip.riscos <ab_soft$dir>.riscos ~cf~r~v
Dir <ab_res$dir>.soft
Do zip -9qr <ab_res$dir>.<ab_local$soft> *
SetType <ab_res$dir>.<ab_local$soft> &A91
Back
| Delete any pre-existing ROM build zip archive on the autobuild server
Remove <ab_zip$file>
| Copy the ROM build zip archive onto the autobuild server
SetType <ab_res$dir>.<ab_local$zip> &A91
Copy <ab_res$dir>.<ab_local$zip> <ab_zip$file> ~cfr~v
Access <ab_zip$file> rw/r
\ No newline at end of file
Resources/IOMDHAL/soft/!Boot/Choices/Boot/PreDesk/!!SoftLoad/!Run,feb 0 → 100644
View file @ ab43c964
| Copyright 2013 Castle Technology Ltd
|
| Licensed under the Apache License, Version 2.0 (the "License");
| you may not use this file except in compliance with the License.
| You may obtain a copy of the License at
|
| http://www.apache.org/licenses/LICENSE-2.0
|
| Unless required by applicable law or agreed to in writing, software
| distributed under the License is distributed on an "AS IS" BASIS,
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
| See the License for the specific language governing permissions and
| limitations under the License.
|
| >!Boot.Choices.Boot.PreDesk.!Run
| Copyright 2010, RISC OS Open
| All rights reserved.
|
| RISC OS ROM softload utility
| Set up environment, start the process...
Set SoftLoad$Dir <Obey$Dir>
| Check OS version and run user prompt...
RMEnsure UtilityModule 5.19 Run <SoftLoad$Dir>.Prompt
\ No newline at end of file
Resources/IOMDHAL/soft/!Boot/Choices/Boot/PreDesk/!!SoftLoad/Loader,feb 0 → 100644
View file @ ab43c964
| Copyright 2013 Castle Technology Ltd
|
| Licensed under the Apache License, Version 2.0 (the "License");
| you may not use this file except in compliance with the License.
| You may obtain a copy of the License at
|
| http://www.apache.org/licenses/LICENSE-2.0
|
| Unless required by applicable law or agreed to in writing, software
| distributed under the License is distributed on an "AS IS" BASIS,
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
| See the License for the specific language governing permissions and
| limitations under the License.
|
| >!Boot.Choices.Boot.PreDesk.!!SoftLoad.Loader
| Copyright 2010, RISC OS Open
| All rights reserved.
|
| RISC OS ROM softload utility
| Ensure that !System is available...
SetEval SoftLoad$Sys 0
If "<System$Dir>" = "" Then SetEval SoftLoad$Sys 1
If SoftLoad$Sys Then Set System$Dir Boot:Resources.!System
If SoftLoad$Sys Then Run <System$Dir>.SysPaths
| Load the SharedCLibrary if we need to...
RMEnsure SharedCLibrary 5.46 RMLoad System:Modules.CLib
RMEnsure SharedCLibrary 5.46 Error The softloader requires SharedCLibrary 5.46 or later
| Softload the new ROM and reboot into it...
Run <Softload$Dir>.SoftLoad -v -m 12M <Softload$Dir>.riscos .NONE.
\ No newline at end of file
Resources/IOMDHAL/soft/ReadMe.txt 0 → 100644
View file @ ab43c964
This is a ROM softloader patch for RiscPC and A7000 machines. It includes a
development release of the RISC OS ROM image which can be installed into
your boot sequence as follows:
* Ensure you have an up to date !System containing SharedCLibrary 5.46 or
later. An updated !System for 26 bit operating systems is available from
http://www.riscosopen.org/content/downloads/other-zipfiles
follow the instructions inside the archive to install this.
Remember that although RISC OS 5 runs in 32 bit mode, the early part of
the softloading is on the original 26 bit host operating system.
* Open your main hard disc (left click on the hard disc iconbar icon)
* Run the configure application by left double-clicking '!Boot'
* Left click on the 'Boot' icon to open the "Boot sequence" configuration
window
* Left click on the 'Install' icon to open the "Boot Merge" window
* Drag the !Boot directory from this zip file to the merge window
* Click on the 'Merge' button to install the softloader
You can now reboot in order to try the latest development version of RISC OS
for the RiscPC/A7000. You will be prompted when the machine boots as to
whether you would like to softload or continue booting with your normal
(installed) version of RISC OS. Press 'y' or 'n' on the keyboard to indicate
your choice when asked.
Please note: this is a development release of the operating system and is
supplied in an entirely untested state. The softload tool is also largely
untested at present so please send a report of any problems you encounter to
info@riscosopen.org.
For a list of known issues with this ROM image, please see the ROOL wiki:
http://www.riscosopen.org/wiki/documentation/show/Software%20information:%20IOMD%20ROM
Thanks!
-- The ROOL Team
\ No newline at end of file
Resources/IOMDHALDev/ReadMe.txt
View file @ ab43c964
RISC OS Open Release Archive
============================
This is the IOMD (A7000 and RiscPC) development ROM image. It is a
This is the Risc PC/A7000/A7000+ development ROM image. It is a
bleeding-edge build which comes from the latest revisions of all the relevant
sources in our source code repository and is completely untested.
Softloading this ROM image should only be done if you are confident that you
know what you are doing and have a good backup strategy in place! It is
likely to be incomplete and only partially functional.
Softloading it should only be done if you are confident that you know what
you are doing and have a good backup strategy in place!
Some components in this archive are released under the licence (included in
this archive as Licence_v1_1.pdf), or see:
......
Resources/IOMDHALDev/soft/ReadMe.txt
View file @ ab43c964
This is a ROM softloader patch for RiscPC and A7000 machines. It includes a
development release of the RISC OS ROM image which can be installed into
This is a ROM softloader patch for RiscPC/A7000/A7000+ machines. It includes
the softload tool and respective RISC OS ROM image which can be installed into
your boot sequence as follows:
* Ensure you have an up to date !System containing SharedCLibrary 5.46 or
......@@ -22,21 +22,11 @@ your boot sequence as follows:
* Click on the 'Merge' button to install the softloader
You can now reboot in order to try the latest development version of RISC OS
for the RiscPC/A7000. You will be prompted when the machine boots as to
whether you would like to softload or continue booting with your normal
(installed) version of RISC OS. Press 'y' or 'n' on the keyboard to indicate
your choice when asked.
Please note: this is a development release of the operating system and is
supplied in an entirely untested state. The softload tool is also largely
untested at present so please send a report of any problems you encounter to
info@riscosopen.org.
For a list of known issues with this ROM image, please see the ROOL wiki:
http://www.riscosopen.org/wiki/documentation/show/Software%20information:%20IOMD%20ROM
You can now reboot in order to try out this version of RISC OS.
You will be prompted when the machine boots as to whether you
would like to softload or continue booting with your ROM installed (in the
flash ROM memory chip on the motherboard) version of RISC OS.
Press 'y' or 'n' on the keyboard to indicate your choice when asked.
Thanks!
......
Resources/OMAP3Dev/ReadMe.txt
View file @ ab43c964
......@@ -5,7 +5,7 @@ This is the OMAP (Beagle Board) development ROM image. It is a bleeding-edge
build which comes from the latest revisions of all the relevant sources in
our source code repository and is completely untested.
Using this ROM image in your Beagle should only be done if you are confident
Using this ROM image in your board should only be done if you are confident
that you know what you are doing! It is likely to be functionally incomplete
and probably unstable in various ways.
......@@ -46,7 +46,10 @@ conjunction with the installation steps given on the above page.
An important note about CMOS RAM
================================
The OMAP port of RISC OS now supports saving configuration settings in a CMOS memory chip so that they are kept when the power is turned off. This requires a small carrier board to be plugged in, which you can obtain for a few pounds from your favourite supplier.
The OMAP port of RISC OS now supports saving configuration settings in a CMOS
memory chip so that they are kept when the power is turned off. This
requires a small carrier board to be plugged in, which you can obtain for
a few pounds from your favourite supplier.
If this carrier board is not detected it is possible to have 'read only' settings in one of two ways
......
Resources/OMAP4Dev/InstallHD4,fd6
View file @ ab43c964
......@@ -12,8 +12,7 @@ basic
100MOV PC,R14
110]
120CALL code%
RUN
*changedynamicarea -ramfssize 32m
*changedynamicarea -ramfssize 48M
*ram
SAVE"RAM::RamDisc0.$.AOff"
10REM Turn on alignment exceptions on ARMv7 machines
......@@ -43,7 +42,7 @@ NEW
1040DATA" note its drive number on the icon bar."
1050DATA"2. Unplug the FAT formatted device you used to get"
1060DATA" to this point, if you wish."
1070DATA"3. To reformat this new device, run SCSIForm from"
1070DATA"3. To reformat this new device, run HForm from"
1080DATA" its shortcut placed on the Pinboard."
1090DATA"4. In the RAM::RamDisc0.$.HardDisc4 directory"
1100DATA" display, click Menu -> Select all."
......@@ -60,14 +59,17 @@ RUN
NEW
10REM Run self-extracting HardDisc4 image
20REM which provides the !Boot sequence and
30REM SCSI ADFS formatter
30REM FileCore formatter
40:
50REM Assumes a RAM disc of minimum size 32MB is present
50REM Assumes a RAM disc of minimum size 48MB is present
60:
70*copy SCSI::0.HardDisc4/util RAM::RamDisc0.$.HD4 ~c
61DIM drive% 32
62SYS"OS_GBPB",5,,drive%:REM Read current drive name
63?(drive%+1+?drive%)=13
70OSCLI"copy SCSI::"+$(drive%+1)+".HardDisc4/util RAM::RamDisc0.$.HD4 ~c"
80*dismount :0
90*settype RAM::RamDisc0.$.HD4 &ffc
100*key0|m*delete RAM::RamDisc0.$.HD4|m*pin RAM::RamDisc0.$.HardDisc4.Utilities.USB-Mass.!SCSIForm 32 152|m*filer_opendir RAM::RamDisc0.$|m*filer_opendir RAM::RamDisc0.$.HardDisc4|m*filer_run RAM::RamDisc0.$.HD4instruct|m
100*key0|m*delete RAM::RamDisc0.$.HD4|m*pin RAM::RamDisc0.$.HardDisc4.Utilities.Caution.!HForm 32 152|m*filer_opendir RAM::RamDisc0.$|m*filer_opendir RAM::RamDisc0.$.HardDisc4|m*filer_run RAM::RamDisc0.$.HD4instruct|m
110*key1|m|m|m|m|m|mREM **********************|mREM * Finished. *|mREM * You may safely *|mREM * CLOSE this window. *|mREM **********************|m|mQUIT|mshellcli_taskquit|m
120*fx15,0
130*fx138,0,128
......
Resources/OMAP4Dev/ReadMe.txt
View file @ ab43c964
......@@ -46,14 +46,21 @@ conjunction with the installation steps given on the above page.
An important note about CMOS RAM
================================
The OMAP port of RISC OS now has the ability to use CMOS settings that are
saved to the SD card alongside the ROM image. However, RISC OS currently
lacks the ability to write updated settings back to the card. Therefore if
you make any configuration changes that will affect CMOS RAM (e.g. switching
to boot from drive 4 instead of 0) then you must make sure you manually save
the settings using *SaveCMOS and copy the new file onto the SD card. For more
information about how the CMOS file is handled, please see the !SDCreate help
file.
-- RISC OS Open
\ No newline at end of file
The OMAP port of RISC OS now supports saving configuration settings in a CMOS
memory chip so that they are kept when the power is turned off. This
requires a small carrier board to be plugged in, which you can obtain for
a few pounds from your favourite supplier.
If this carrier board is not detected it is possible to have 'read only' settings in one of two ways
* Add a CMOS file to the SD card
Make any configuration settings changes desired than use the *SaveCMOS
command to capture them in a file, put this file on the SD card alongside
the RISC OS ROM image.
For more information about how the CMOS file is handled, please see
the !SDCreate help file.
* Do nothing
If the hardware is not present, and you haven't put a CMOS file on the
SD card, you'll get the built in defaults.
-- RISC OS Open
Resources/Tungsten/ReadMe.txt
View file @ ab43c964
RISC OS Open Release Archive
============================
This is the IYONIX (codename Tungsten) development ROM image. It represents
the last ROOL build of the IYONIX ROM image, but does not always
correspond with a formal ROM release. Because ROOL don't perform regular
builds and testing of ROM releases, this ROM is likely to contain components
which are quite a lot older than in the TungstenDev build.
This is the IYONIX (codename Tungsten) development ROM image. It is a
bleeding-edge build which comes from the latest revisions of all the relevant
sources in our source code repository and is completely untested.
You MUST NOT attempt to program this into the flash of your IYONIX - even
softloading it should only be done if you are confident that you know what
......
Resources/Tungsten/soft/!Boot/Choices/Boot/PreDesk/!!SoftLoad/!Run,feb
View file @ ab43c964
......@@ -22,4 +22,4 @@
Set SoftLoad$Dir <Obey$Dir>
| Check OS version and run user prompt...
RMEnsure UtilityModule 5.16 Run <SoftLoad$Dir>.Prompt
\ No newline at end of file
RMEnsure UtilityModule 5.18 Run <SoftLoad$Dir>.Prompt
\ No newline at end of file
Resources/Tungsten/soft/ReadMe.txt
View file @ ab43c964
......@@ -21,10 +21,6 @@ would like to softload or continue booting with your normal (installed)
version of RISC OS. Press 'y' or 'n' on the keyboard to indicate your choice
when asked.
Please note: this is a development release of the softload tool which is
largely untested at present to please send a report of any problems you
encounter to info@riscosopen.org.
Thanks!
-- The ROOL Team
Resources/TungstenDev/ReadMe.txt
View file @ ab43c964
......@@ -3,8 +3,9 @@ RISC OS Open Release Archive
This is the IYONIX (codename Tungsten) development ROM image. It is a
bleeding-edge build which comes from the latest revisions of all the relevant
sources in our source code repository and is completely untested. As such,
you MUST NOT attempt to program this into the flash of your IYONIX - even
sources in our source code repository and is completely untested.
You MUST NOT attempt to program this into the flash of your IYONIX - even
softloading it should only be done if you are confident that you know what
you are doing and have a good backup strategy in place!
......
Resources/TungstenDev/soft/ReadMe.txt
View file @ ab43c964
This is a ROM softloader patch for the IYONIX pc. It includes a development
release of the RISC OS ROM image which can be installed into your boot
sequence as follows:
This is a ROM softloader patch for the IYONIX pc. It includes the latest
Castle-approved formal release of the RISC OS ROM image, version 5.16, which
can be installed into your boot sequence as follows:
* Open your main hard disc (left click on the hard disc iconbar icon)
......@@ -15,17 +15,12 @@ sequence as follows:
* Click on the 'Merge' button to install the softloader
You can now reboot in order to try the latest development version of RISC OS
You can now reboot in order to try the latest 'official' version of RISC OS
for the IYONIX. You will be prompted when the machine boots as to whether you
would like to softload or continue booting with your normal (installed)
version of RISC OS. Press 'y' or 'n' on the keyboard to indicate your choice
when asked.
Please note: this is a development release of the operating system and is
supplied in an entirely untested state. The softload tool is also largely
untested at present so please send a report of any problems you encounter to
info@riscosopen.org.
Thanks!
-- The ROOL Team
\ No newline at end of file
-- The ROOL Team
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment