Package RASCAL.SystemInfo

Description	Collects information about the system - OS and hardware.
Author	bbracke
Date	2005/11/21 20:14:33
Revision	1.1

Clauses

Quick access : Clauses - Generics - Definitions - Subprograms

Context clauses
System.Unsigned_Types

Use clauses
System.Unsigned_Types

Basic Objects

Quick access : Clauses - Generics - Definitions - Subprograms

Basic Objects
*Name*	*Type*	*Default*
Code_Feature_Syncronise	unsigned	1
You must tell the OS when a code area changes (OS_SynchroniseCodeAreas)
Code_Feature_Interrupts	unsigned	2
Enabling then disabling interrupts does not allow them a chance to occur.
Code_Feature_Vectors	unsigned	4
Hardware vectors are only readable in 32 bit mode.
Code_Feature_PC8	unsigned	8
When storing PC, PC+8 is stored (not PC+12)
Code_Feature_FullEarly	unsigned	16
Data aborts occur with 'full early' timing
Code_Feature_32bitOS	unsigned	64
32 bit RISC OS
Code_Feature_No26bit	unsigned	128
26 bit mode is unavailable on this platform

Definitions

Quick access : Clauses - Generics - Definitions - Subprograms

Types
*Name*	*Declaration*
Cache_Status_Type	(On, Off, W, IW)
Version_Info_Type	(Version_Name, Part_Number, Build_Date, Dealer_Name, Registered_To, Registered_Address)
Memory_Info_Type	(DRAM, VRAM, ROM, IO, SoftROM)
CPU_Type	(Old, ARM6_7, StrongARM, New_32bitonly)

Exceptions
unknown_cache_state

Subprograms

Quick access : Clauses - Generics - Definitions - Subprograms

Get_CacheStatus	function
*Return*	Cache_Status_Type
Returns cache status.

Get_WindowManager_Version	function
*Return*	Integer
Returns the version number of the window manager * 100. Returns 200 with RISC OS older than 3.00

Get_OS_Declaration	function
*Return*	String
Returns OS declaration.

Get_OS_Info	function
*Return*	String
Return information about the OS. Returns an empty string on ancient OS versions.

*Parameter name*	*Type*	*Mode*	*Default*
Info	Version_Info_Type	in	Version_Name

Get_Memory_Size	function
*Return*	Integer
Return the size of the memory in bytes. Returns 0 on OS versions older than 3.5

*Parameter name*	*Type*	*Mode*	*Default*
Info	Memory_Info_Type	in

Get_Machine_ID	procedure
Returns the machine id. Returns 0,0 if no suitable chip is fitted to the computer.

*Parameter name*	*Type*	*Mode*	*Default*
Low	Integer	out
High	Integer	out

Get_Machine_ID	function
*Return*	String
Returns the machine id as a string. Returns '00' if no suitable chip is fitted to the computer.

Get_CPU	function
*Return*	CPU_Type
Returns CPU type.

Get_Ethernet_Address	procedure
Returns ethernet address - 0,0 for none.

*Parameter name*	*Type*	*Mode*	*Default*
Low	Integer	out
High	Integer	out

Get_Ethernet_Address	function
*Return*	String
Returns ethernet address as a string - '00' for none.

Report	procedure
Print system info into Reporter window.