CLK/OSBindings/Mac/Clock SignalTests/IIgs Memory Map

Apple IIgs Memory Map Tests

Sample test:

{
	"hires": false,
	"lcw": false,
	"80store": true,
	"shadow": 12,
	"state": 183,
	"read": [
	[0, 192, 256, 448],
	[193, 208, 65473, 65488],
	[209, 256, 465, 512],
	[257, 448, 0, 0],
	[449, 464, 65473, 65488],
	[465, 512, 465, 512],
	[513, 57537, 0, 0],
	[57538, 57552, 65474, 65488],
	[57553, 57600, 57553, 57600],
	[57601, 57793, 0, 0],
	[57794, 57808, 65474, 65488],
	[57809, 57856, 57809, 57856],
	[57857, 65536, 0, 0]
	],
	"write": [
		[0, 192, 256, 448],
		[193, 256, 65473, 65536],
		[257, 448, 0, 0],
		[449, 512, 65473, 65536],
		[513, 57537, 0, 0],
		[57538, 57600, 65474, 65536],
		[57601, 57793, 0, 0],
		[57794, 57856, 65474, 65536],
		[57857, 65536, 0, 0]
	],
	"shadowed": [4, 12, 32, 64, 260, 268, 288, 320, 352, 416, 65535],
	"io": [192, 193, 448, 449, 57536, 57537, 57792, 57793, 65535]
}

Application

Perform, in the order listed:

	"hires": false,

If this is true, access IO address 0x57; otherwise access IO address 0x56.

	"lcw": false,

If this is true, access IO address 0x81 twice; otherwise access IO address 0x80 once.

	"80store": true,

If this is true, access IO address 0x01; otherwise access IO address 0x00.

	"shadow": 12,

Store this value to IO address 0x35.

	"state": 183,

Store this value to IO address 0x68.

Test

Only memory areas which are subject to paging are recorded with valid physical addresses.

read and write

Each entry looks like:

[0, 192, 256, 448]

Which is of the form:

[logical start, logical end, physical start, physical end]

Where all numbers are page numbers, i.e. address / 256.

So e.g. the entry above means that between logical addresses $00:0000 and $00:C000 you should find the physical RAM located between addresses $01:0000 and $01:C0000.

If physical end == physical start then the same destination is used for all logical addresses; if that destination is 0 then the area is unmapped.

shadowed and io

An example chain looks like:

[4, 12, 32, 64, 260, 268, 288, 320, 352, 416, 65535]

Starting from a default value of false, that means:

• memory remained un-[shadowed/IO] for until page 4 (i.e. pages 0–3);
• it was then marked as [shadowed/IO] until page 12 (i.e. pages 4–11);
• it was then un-[shadowed/IO] to page 32;
• ...etc.