Difference between revisions of "Unit PlatformRPi"

Latest revision as of 05:10, 23 November 2022

`RPI_VECTOR_TABLE_BASE = $00001000;`	Place the Interrupt Vector Table at 0x00001000 before the code start at 0x00008000
`RPI_VECTOR_TABLE_SIZE = SIZE_64;`	The Interrupt Vector Table is exactly 64 bytes (16 32 bit (4 byte) entries)
`RPI_VECTOR_TABLE_COUNT = 8;`	The Interrupt Vector Table contains 8 entries on an ARMv6 device

RPi CPU count, boot and mask RPI_CPU_*

`RPI_CPU_COUNT = BCM2835_CPU_COUNT;`
`RPI_CPU_BOOT = CPU_ID_0;`
`RPI_CPU_MASK = CPU_AFFINITY_0;`

RPi SWI RPI_SWI_*

`RPI_SWI_COUNT = 256;`	Number of available SWI entries

RPi kernel image name RPI_KERNEL_*

`RPI_KERNEL_NAME = 'kernel.img';`
`RPI_KERNEL_CONFIG = 'config.txt';`
`RPI_KERNEL_COMMAND = 'cmdline.txt';`
`RPI_FIRMWARE_FILES = 'bootcode.bin,start.elf,fixup.dat';`
`RPI_DTB_FILES = 'bcm2708-rpi-b.dtb,bcm2708-rpi-b-plus.dtb,bcm2708-rpi-b-rev1.dtb,bcm2708-rpi-cm.dtb,bcm2708-rpi-zero.dtb,bcm2708-rpi-zero-w.dtb';`

RPi plus GPIO power LED RPIPLUS_GPIO_PWRLED_*

GPIO Power LED constants GPIO Pin 35 - A+/B+ Only
Note: GPIO Pin 35 on the A+/B+ is set on boot to Pull Up/Down Enable which must be cleared before using the pin

`RPIPLUS_GPIO_PWRLED_GPFSEL = BCM2835_GPFSEL3;`	GPFSEL register for PWR LED
`RPIPLUS_GPIO_PWRLED_GPSET = BCM2835_GPSET1;`	GPSET register for PWR LED
`RPIPLUS_GPIO_PWRLED_GPCLR = BCM2835_GPCLR1;`	GPCLR register for PWR LED

`RPIPLUS_GPIO_PWRLED_GPFSHIFT = 15;`	GPFSEL register shift for PWR LED
`RPIPLUS_GPIO_PWRLED_GPFMASK = BCM2835_GPFSEL_MASK;`	GPFSEL register mask for PWR LED

`RPIPLUS_GPIO_PWRLED_GPSHIFT = (35 - 32);`	GPSET/GPCLR register shift for PWR LED
`RPIPLUS_GPIO_PWRLED_GPMASK = BCM2835_GPSET_MASK;`	GPSET/GPCLR register mask for PWR LED

GPIO Pin 35 on A+/B+
See: http://www.raspberrypi.org/forums/viewtopic.php?t=72260
See also for how to control GPPUD etc: http://wiki.osdev.org/Raspberry_Pi_Bare_Bones

RPi GPIO activity LED RPI_GPIO_ACTLED_*

GPIO Pin 16 - A/B Only
Note: GPIO Pin 47 on the A+/B+ is Pull High instead of Pull Low, to turn on the LED use RPIPLUS_GPIO_ACTLED_GPSET instead of RPIPLUS_GPIO_ACTLED_GPCLR

`RPI_GPIO_ACTLED_GPFSEL = BCM2835_GPFSEL1;`	GPFSEL register for ACT LED
`RPI_GPIO_ACTLED_GPSET = BCM2835_GPSET0;`	GPSET register for ACT LED
`RPI_GPIO_ACTLED_GPCLR = BCM2835_GPCLR0;`	GPCLR register for ACT LED

`RPI_GPIO_ACTLED_GPFSHIFT = 18;`	GPFSEL register shift for ACT LED
`RPI_GPIO_ACTLED_GPFMASK = BCM2835_GPFSEL_MASK;`	GPFSEL register mask for ACT LED

`RPI_GPIO_ACTLED_GPSHIFT = 16;`	GPSET/GPCLR register shift for ACT LED
`RPI_GPIO_ACTLED_GPMASK = BCM2835_GPSET_MASK;`	GPSET/GPCLR register mask for ACT LED

RPi plus GPIO activity LED RPIPLUS_GPIO_ACTLED_*

GPIO Pin 47 - A+/B+ Only

`RPIPLUS_GPIO_ACTLED_GPFSEL = BCM2835_GPFSEL4;`	GPFSEL register for ACT LED
`RPIPLUS_GPIO_ACTLED_GPSET = BCM2835_GPSET1;`	GPSET register for ACT LED
`RPIPLUS_GPIO_ACTLED_GPCLR = BCM2835_GPCLR1;`	GPCLR register for ACT LED

`RPIPLUS_GPIO_ACTLED_GPFSHIFT = 21;`	GPFSEL register shift for ACT LED
`RPIPLUS_GPIO_ACTLED_GPFMASK = BCM2835_GPFSEL_MASK;`	GPFSEL register mask for ACT LED

`RPIPLUS_GPIO_ACTLED_GPSHIFT = (47 - 32);`	GPSET/GPCLR register shift for ACT LED
`RPIPLUS_GPIO_ACTLED_GPMASK = BCM2835_GPSET_MASK;`	GPSET/GPCLR register mask for ACT LED

RPi mailbox RPI_MAILBOX_*

`RPI_MAILBOX_TIMEOUT = 100;`	Default timeout to wait for mailbox calls to complete (Milliseconds)
`RPI_MAILBOX_TIMEOUT_EX = 1000;`	Extended timeout to wait for mailbox calls to complete (Milliseconds)

RPi framebuffer RPI_FRAMEBUFFER_*

`RPI_FRAMEBUFFER_DESCRIPTION = 'BCM2835 Framebuffer';`

Type definitions

None defined

Public variables

RPi specific Ultibo variables

`RPiInitialized:Boolean;`

Timer variables

`TimerRegisters:PBCM2835SystemTimerRegisters;`

Mailbox variables

`Mailbox0Registers:PBCM2835Mailbox0Registers;`

`Mailbox1Registers:PBCM2835Mailbox1Registers;`

Interrupt variables

`InterruptRegisters:PBCM2835InterruptRegisters;`

`InterruptEntries:array[0..(BCM2835_IRQ_COUNT - 1)] of PInterruptEntry;`

System call

`SystemCallEntries:array[0..RPI_SWI_COUNT - 1] of TSystemCallEntry;`

IRQ/FIQ

`IRQEnabled:array[0..2] of LongWord;`	3 groups of IRQs to Enable/Disable (See: TBCM2835InterruptRegisters)

`FIQEnabled:LongWord;`	The single IRQ number to Enable as FIQ instead (See: TBCM2835InterruptRegisters)

Watchdog variables

`WatchdogRegisters:PBCM2835PMWatchdogRegisters;`

Function declarations

Initialization functions

procedure RPiInit;

Description: To be documented

Note	None documented

RPi platform functions

procedure RPiBoardInit;

Description: To be documented

Note	None documented

procedure RPiMemoryInit;

Description: To be documented

Note	None documented

procedure RPiClockInit;

Description: To be documented

Note	None documented

procedure RPiPowerInit;

Description: To be documented

Note	None documented

procedure RPiMailboxInit;

Description: To be documented

Note	None documented

procedure RPiInterruptInit;

Description: To be documented

Note	None documented

procedure RPiPeripheralInit;

Description: To be documented

Note	None documented

procedure RPiFramebufferInit;

Description: To be documented

Note	None documented

procedure RPiPageTableInit;

Description: Initialize the Hardware Page Tables before enabling the MMU

Note	See page 6-36 of the ARM1176JZF-S Technical Reference Manual

procedure RPiPowerLEDEnable;

Description: To be documented

Note	None documented

procedure RPiPowerLEDOn;

Description: To be documented

Note	None documented

procedure RPiPowerLEDOff;

Description: To be documented

Note	None documented

procedure RPiActivityLEDEnable;

Description: To be documented

Note	None documented

procedure RPiActivityLEDOn;

Description: To be documented

Note	None documented

procedure RPiActivityLEDOff;

Description: To be documented

Note	None documented

function RPiMailboxReceive(Mailbox,Channel:LongWord):LongWord;

Description: Receive from specified mailbox on specified channel

Note	Data = first 28 bits, Channel = last 4 bits

procedure RPiMailboxSend(Mailbox,Channel,Data:LongWord);

Description: Send to specified mailbox on specified channel

Note	Data = first 28 bits, Channel = last 4 bits

function RPiMailboxCall(Mailbox,Channel,Data:LongWord; var Response:LongWord):LongWord;

Description: Perform a transaction (Send/Receive) to specified mailbox on specified channel

Note	Data = first 28 bits, Channel = last 4 bits Data pointer must be 16 byte aligned to allow for the 4 bit channel number

function RPiMailboxCallEx(Mailbox,Channel,Data:LongWord; var Response:LongWord; Timeout:LongWord):LongWord;

Description: Perform a transaction (Send/Receive) to specified mailbox on specified channel

Note	Data = first 28 bits, Channel = last 4 bits Data pointer must be 16 byte aligned to allow for the 4 bit channel number

function RPiMailboxPropertyCall(Mailbox,Channel:LongWord; Data:Pointer; var Response:LongWord):LongWord;

Description: Perform a property tag transaction (Send/Receive) to specified mailbox on specified channel

Note	Data = first 28 bits, Channel = last 4 bits Data pointer must be 16 byte aligned to allow for the 4 bit channel number

function RPiMailboxPropertyCallEx(Mailbox,Channel:LongWord; Data:Pointer; var Response:LongWord; Timeout:LongWord):LongWord;

Description: Perform a property tag transaction (Send/Receive) to specified mailbox on specified channel

Note	Data = first 28 bits, Channel = last 4 bits Data pointer must be 16 byte aligned to allow for the 4 bit channel number

function RPiMailboxPropertyTag(Tag:LongWord; Data:Pointer; Size:LongWord):LongWord;

Description: Request a property tag (Get/Set) from the mailbox property channel

Data	Data does not need to include mailbox property channel header or footer. Data pointer does not need any specific alignment or caching attributes.
Size	Size must be a multiple of 4 bytes. Size must include the size of the request and response which use the same buffer.

function RPiRequestExIRQ(CPUID,Number:LongWord; Handler:TInterruptHandler; HandlerEx:TInterruptExHandler; Parameter:Pointer):LongWord;

Description: Request registration of the supplied handler to the specified IRQ number

CPUID	CPU to route IRQ to (Ignored on RPi)
Number	IRQ number to register
Handler	Interrupt handler function to register
HandlerEx	Extended Interrupt handler function to register
Note	Only one of Handler or HandlerEx can be specified

function RPiReleaseExIRQ(CPUID,Number:LongWord; Handler:TInterruptHandler; HandlerEx:TInterruptExHandler; Parameter:Pointer):LongWord;

Description: Request deregistration of the supplied handler from the specified IRQ number

Note	None documented

function RPiRequestExFIQ(CPUID,Number:LongWord; Handler:TInterruptHandler; HandlerEx:TInterruptExHandler; Parameter:Pointer):LongWord;

Description: Request registration of the supplied handler to the specified FIQ number

Note	None documented

function RPiReleaseExFIQ(CPUID,Number:LongWord; Handler:TInterruptHandler; HandlerEx:TInterruptExHandler; Parameter:Pointer):LongWord;

Description: Request deregistration of the supplied handler from the specified FIQ number

Note	None documented

function RPiRegisterInterrupt(Number,Mask,Priority,Flags:LongWord; Handler:TSharedInterruptHandler; Parameter:Pointer):LongWord;

Description: Request registration of the supplied handler to the specified interrupt number (Where Applicable)

Note	None documented

function RPiDeregisterInterrupt(Number,Mask,Priority,Flags:LongWord; Handler:TSharedInterruptHandler; Parameter:Pointer):LongWord;

Description: Request deregistration of the supplied handler from the specified interrupt number (Where Applicable)

Note	None documented

function RPiRegisterSystemCallEx(CPUID,Number:LongWord; Handler:TSystemCallHandler; HandlerEx:TSystemCallExHandler):LongWord;

Description: Request registration of the supplied extended handler to the specified System Call number

Note	None documented

function RPiDeregisterSystemCallEx(CPUID,Number:LongWord; Handler:TSystemCallHandler; HandlerEx:TSystemCallExHandler):LongWord;

Description: Request deregistration of the supplied extended handler from the specified System Call number

Note	None documented

function RPiGetInterruptEntry(Number,Instance:LongWord; var Interrupt:TInterruptEntry):LongWord;

Description: Get the interrupt entry for the specified interrupt number and instance

Note	None documented

function RPiGetSystemCallEntry(Number:LongWord):TSystemCallEntry;

Description: To be documented

Note	Get the system call entry for the specified system call number

function RPiSystemRestart(Delay:LongWord):LongWord;

Description: To be documented

Note	None documented

function RPiSystemShutdown(Delay:LongWord):LongWord;

Description: To be documented

Note	None documented

function RPiSystemGetCommandLine:String;

Description: Get the Command Line from the Mailbox property tags channel

Note	None documented

function RPiCPUGetMemory(var Address:PtrUInt; var Length:UInt64):LongWord;

Description: Get the CPU Memory from the Mailbox property tags channel

Note	None documented

function RPiGPUGetState:LongWord;

Description: To be documented

Note	None documented

function RPiGPUGetMemory(var Address:PtrUInt; var Length:UInt64):LongWord;

Description: Get the GPU Memory from the Mailbox property tags channel

Note	None documented

function RPiBoardGetModel:LongWord;

Description: Get the Board Model from the Mailbox property tags channel

Note	None documented

function RPiBoardGetSerial:Int64;

Description: Get the Board Serial from the Mailbox property tags channel

Note	None documented

function RPiBoardGetRevision:LongWord;

Description: Get the Board Revision from the Mailbox property tags channel

Note	None documented

function RPiBoardGetMACAddress:String;

Description: Get the Board MAC Address from the Mailbox property tags channel

Note	None documented

function RPiFirmwareGetRevision:LongWord;

Description: Get the Firmware Revision from the Mailbox property tags channel

Note	None documented

function RPiFirmwareGetThrottled:LongWord;

Description: Get the Firmware Throttling state from the Mailbox property tags channel

Note	None documented

function RPiPowerGetWait(PowerId:LongWord):LongWord;

Description: Get the Power Wait from the Mailbox property tags channel

Note	None documented

function RPiPowerGetState(PowerId:LongWord):LongWord;

Description: Get the Power State from the Mailbox property tags channel

Note	None documented

function RPiPowerSetState(PowerId,State:LongWord; Wait:Boolean):LongWord;

Description: Set the Power State in the Mailbox property tags channel

Note	Power Lock not required due to Mailbox Property Call serialization

function RPiClockGetCount:LongWord;

Description: Gets the current system clock count (32 least significant bits of total)

Note	On the Raspberry Pi this comes from the System Timer free running counter which runs at 1MHz and therefore overflows every 4295 seconds

function RPiClockGetTotal:Int64;

Description: Gets the total system clock count

Note	On the Raspberry Pi this comes from the System Timer free running counter which runs at 1MHz, the clock interrupt also uses this timer to increment the clock every second and therefore keep time.

function RPiClockGetRate(ClockId:LongWord):LongWord;

Description: Get the Clock Rate from the Mailbox property tags channel

Note	None documented

function RPiClockSetRate(ClockId,Rate:LongWord; Turbo:Boolean):LongWord;

Description: Set the Clock Rate in the Mailbox property tags channel

Note	None documented

function RPiClockGetState(ClockId:LongWord):LongWord;

Description: Get the Clock State from the Mailbox property tags channel

Note	None documented

function RPiClockSetState(ClockId,State:LongWord):LongWord;

Description: Set the Clock State in the Mailbox property tags channel

Note	None documented

function RPiClockGetMinRate(ClockId:LongWord):LongWord;

Description: Get the Clock Min Rate from the Mailbox property tags channel

Note	None documented

function RPiClockGetMaxRate(ClockId:LongWord):LongWord;

Description: Get the Clock Max Rate from the Mailbox property tags channel

Note	None documented

function RPiTurboGetState(TurboId:LongWord):LongWord;

Description: Get the Turbo State from the Mailbox property tags channel

Note	None documented

function RPiTurboSetState(TurboId,State:LongWord):LongWord;

Description: Set the Turbo State in the Mailbox property tags channel

Note	None documented

function RPiVoltageGetValue(VoltageId:LongWord):LongWord;

Description: Get the Voltage Value from the Mailbox property tags channel

Note	None documented

function RPiVoltageSetValue(VoltageId,Value:LongWord):LongWord;

Description: Set the Voltage Value in the Mailbox property tags channel

Note	None documented

function RPiVoltageGetMinValue(VoltageId:LongWord):LongWord;

Description: Get the Voltage Min Value from the Mailbox property tags channel

Note	None documented

function RPiVoltageGetMaxValue(VoltageId:LongWord):LongWord;

Description: Get the Voltage Max Value from the Mailbox property tags channel

Note	None documented

function RPiTemperatureGetCurrent(TemperatureId:LongWord):LongWord;

Description: Get the Temperature Current from the Mailbox property tags channel

Note	None documented

function RPiTemperatureGetMaximum(TemperatureId:LongWord):LongWord;

Description: Get the Temperature Maximum Model from the Mailbox property tags channel

Note	None documented

function RPiGPUMemoryAllocate(Length,Alignment,Flags:LongWord):THandle;

Description: Allocate GPU Memory from the Mailbox property tags channel

Note	None documented

function RPiGPUMemoryRelease(Handle:THandle):LongWord;

Description: Release GPU Memory from the Mailbox property tags channel

Note	None documented

function RPiGPUMemoryLock(Handle:THandle):LongWord;

Description: Lock GPU Memory from the Mailbox property tags channel

Note	None documented

function RPiGPUMemoryUnlock(Handle:THandle):LongWord;

Description: Unlock GPU Memory from the Mailbox property tags channel

Note	None documented

function RPiGPUExecuteCode(Address:Pointer; R0,R1,R2,R3,R4,R5:LongWord):LongWord;

Description: Execute GPU Code from the Mailbox property tags channel

Note	None documented

function RPiDispmanxHandleGet(Resource:THandle):THandle;

Description: Get Dispmanx Memory Handle from the Mailbox property tags channel

Note	None documented

function RPiEDIDBlockGet(Block:LongWord; Buffer:Pointer; Length:LongWord):LongWord;

Description: Get EDID Block from the Mailbox property tags channel

Note	None documented

function RPiFramebufferAllocate(Alignment:LongWord; var Address,Length:LongWord):LongWord;

Description: Allocate Framebuffer from the Mailbox property tags channel

Note	None documented

function RPiFramebufferRelease:LongWord;

Description: Release Framebuffer from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetState(State:LongWord):LongWord;

Description: Set Framebuffer State (Blank Screen) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetDimensions(var Width,Height,Top,Bottom,Left,Right:LongWord):LongWord;

Description: Get Framebuffer Dimensions from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetPhysical(var Width,Height:LongWord):LongWord;

Description: Get Framebuffer Physical size from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetPhysical(var Width,Height:LongWord):LongWord;

Description: Set Framebuffer Physical size from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestPhysical(var Width,Height:LongWord):LongWord;

Description: Test Framebuffer Physical size from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetVirtual(var Width,Height:LongWord):LongWord;

Description: Get Framebuffer Virtual size from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetVirtual(var Width,Height:LongWord):LongWord;

Description: Set Framebuffer Virtual size from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestVirtual(var Width,Height:LongWord):LongWord;

Description: Test Framebuffer Virtual size from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetDepth(var Depth:LongWord):LongWord;

Description: Get Framebuffer Depth (Bits per pixel) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetDepth(var Depth:LongWord):LongWord;

Description: Set Framebuffer Depth (Bits per pixel) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestDepth(var Depth:LongWord):LongWord;

Description: Test Framebuffer Depth (Bits per pixel) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetPixelOrder(var Order:LongWord):LongWord;

Description: Get Framebuffer Pixel Order (RGB) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetPixelOrder(var Order:LongWord):LongWord;

Description: Set Framebuffer Pixel Order (RGB) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestPixelOrder(var Order:LongWord):LongWord;

Description: Test Framebuffer Pixel Order (RGB) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetAlphaMode(var Mode:LongWord):LongWord;

Description: Get Framebuffer Alpha Mode from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetAlphaMode(var Mode:LongWord):LongWord;

Description: Set Framebuffer Alpha Mode from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestAlphaMode(var Mode:LongWord):LongWord;

Description: Test Framebuffer Alpha Mode from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetPitch:LongWord;

Description: Get Framebuffer Pitch (Bytes per line) from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetOffset(var X,Y:LongWord):LongWord;

Description: Get Framebuffer Virtual Offset from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetOffset(var X,Y:LongWord):LongWord;

Description: Set Framebuffer Virtual Offset from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestOffset(var X,Y:LongWord):LongWord;

Description: Test Framebuffer Virtual Offset from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetOverscan(var Top,Bottom,Left,Right:LongWord):LongWord;

Description: Get Framebuffer Overscan from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetOverscan(var Top,Bottom,Left,Right:LongWord):LongWord;

Description: Set Framebuffer Overscan from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestOverscan(var Top,Bottom,Left,Right:LongWord):LongWord;

Description: Test Framebuffer Overscan from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetPalette(Buffer:Pointer; Length:LongWord):LongWord;

Description: Get Framebuffer Palette from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetPalette(Start,Count:LongWord; Buffer:Pointer; Length:LongWord):LongWord;

Description: Set Framebuffer Palette from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestPalette(Start,Count:LongWord; Buffer:Pointer; Length:LongWord):LongWord;

Description: Test Framebuffer Palette from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetLayer(var Layer:LongInt):LongWord;

Description: Get Framebuffer Layer from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetLayer(var Layer:LongInt):LongWord;

Description: Set Framebuffer Layer from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestLayer(var Layer:LongInt):LongWord;

Description: Test Framebuffer Layer from the Mailbox property tags channel

Note	None documented

function RPiFramebufferTestVsync:LongWord;

Description: Test Framebuffer Vertical Sync from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetVsync:LongWord;

Description: Set Framebuffer Vertical Sync from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetBacklight(Brightness:LongWord):LongWord;

Description: Set Framebuffer Backlight Brightness from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetNumDisplays(var NumDisplays:LongWord):LongWord;

Description: Get the number of displays from the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetDisplayId(DisplayNum:LongWord):LongWord;

Description: Get the display id for the specified display number from the Mailbox property tags channel

Note	None documented

function RPiFramebufferSetDisplayNum(DisplayNum:LongWord):LongWord;

Description: Get the display number that all framebuffer requests will refer to using the Mailbox property tags channel

Note	None documented

function RPiFramebufferGetDisplaySettings(DisplayNum:LongWord; var DisplaySettings:TDisplaySettings):LongWord;

Description: Get the display settings for the specified display number from the Mailbox property tags channel

Note	None documented

function RPiFramebufferDisplayIdToName(DisplayId:LongWord):String;

Description: Get the name for the specified display id

Note	None documented

function RPiTouchGetBuffer(var Address:PtrUInt):LongWord;

Description: Get the Touchscreen buffer from the Mailbox property tags channel

Note	None documented

function RPiTouchSetBuffer(Address:PtrUInt):LongWord;

Description: Set the Touchscreen buffer in the Mailbox property tags channel

Note	None documented

function RPiCursorSetDefault:LongWord;

Description: Set Cursor Default (Pixels) from the Mailbox property tags channel

Note	None documented

function RPiCursorSetInfo(Width,Height,HotspotX,HotspotY:LongWord; Pixels:Pointer; Length:LongWord):LongWord;

Description: Set Cursor Info (Pixels) from the Mailbox property tags channel

Note	None documented

function RPiCursorSetState(Enabled:Boolean; X,Y:LongWord; Relative:Boolean):LongWord;

Description: Set Cursor State (Enable, X, Y) from the Mailbox property tags channel

Relative	X, Y is relative to Display (Virtual) not Framebuffer (Physical).

function RPiDMAGetChannels:LongWord;

Description: Get the available DMA Channels from the Mailbox property tags channel

Note	None documented

RPi thread functions

procedure RPiSchedulerInit;

Description: To be documented

Note	None documented

RPi SWI functions

function RPiDispatchSWI(CPUID:LongWord; Thread:TThreadHandle; Request:PSystemCallRequest):TThreadHandle;

Description: Process an SWI request

Note	Called by ARMv6SoftwareInterruptHandler in PlatformARMv6 A DataMemoryBarrier is executed before and after calling this function

RPi clock functions

procedure RPiClockInterrupt(Parameter:Pointer);

Description: Interrupt handler function for the clock interrupt

Note	This schedules another clock interrupt to occur CLOCK_CYCLES_PER_TICK in the future, then updates ClockTicks and ClockSeconds.

procedure RPiClockUpdate(Cycles:LongWord; var Last:LongWord);

Description: Setup a clock interrupt to trigger after the specified number of clock cycles

Cycles	Number of cycles after which the timer interrupt is to be triggered
Note	This refers to native clock cycles as specified by CLOCK_FREQUENCY

RPi scheduler functions

function RPiSchedulerInterrupt(CPUID:LongWord; Thread:TThreadHandle; Parameter:Pointer):TThreadHandle;

Description: Interrupt handler function for the scheduler interrupt

Note	This schedules another scheduler interrupt to occur SCHEDULER_CLOCKS_PER_INTERRUPT in the future, then checks for threads to wakeup and the next thread to schedule.

procedure RPiSchedulerUpdate(Cycles:LongWord; var Last:LongWord);

Description: Setup a scheduler interrupt to trigger after the specified number of clock cycles

Cycles	Number of cycles after which the scheduler interrupt is to be triggered
Note	This refers to native clock cycles as specified by CLOCK_FREQUENCY

procedure RPiSchedulerSystemCall(Request:PSystemCallRequest);

Description: System Call handler for the scheduler

Note	This is registered to receive requests for the SYSTEM_CALL_CONTEXT_SWITCH and will perform a context switch from within an SWI

RPi framebuffer functions

function RPiFramebufferDeviceAllocate(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;

Description: Allocate a framebuffer using the Mailbox Property Tags

Note	None documented

function RPiFramebufferDeviceAllocateAlt(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;

Description: Allocate a framebuffer using a simple Mailbox Call

Note	None documented

function RPiFramebufferDeviceRelease(Framebuffer:PFramebufferDevice):LongWord;

Description: To be documented

Note	None documented

function RPiFramebufferDeviceBlank(Framebuffer:PFramebufferDevice; Blank:Boolean):LongWord;

Description: To be documented

Note	None documented

function RPiFramebufferDeviceCommit(Framebuffer:PFramebufferDevice; Address:PtrUInt; Size,Flags:LongWord):LongWord;

Description: To be documented

Note	None documented

function RPiFramebufferDeviceSetBacklight(Framebuffer:PFramebufferDevice; Brightness:LongWord):LongWord;

Description: To be documented

Note	None documented

RPi helper functions

procedure RPiWait; assembler; nostackframe;

Description: To be documented

Note	None documented

procedure RPiLongWait; assembler; nostackframe;

Description: To be documented

Note	None documented

procedure RPiShortWait; assembler; nostackframe;

Description: To be documented

Note	None documented

procedure RPiSlowBlink; assembler; nostackframe;

Description: To be documented

Note	None documented

procedure RPiFastBlink; assembler; nostackframe;

Description: To be documented

Note	None documented

procedure RPiBootBlink; assembler; nostackframe;

Description: Blink the Activity LED without dependency on any other RTL setup

Note	This currently only works for RPiA+/B+

procedure RPiBootOutput(Value:LongWord);

Description: Output characters to UART0 without dependency on any other RTL setup

Note	This function is primarily intended for testing QEMU boot because it doesn't initialize the UART and won't work on real hardware. Based on hexstrings() function by dwelch67 (https://github.com/dwelch67)

procedure RPiBootConsoleStart;

Description: To be documented

Note	None documented

procedure RPiBootConsoleWrite(const Value:String);

Description: To be documented

Note	None documented

procedure RPiBootConsoleWriteEx(const Value:String; X,Y:LongWord);

Description: To be documented

Note	None documented

function RPiBootConsoleGetX:LongWord;

Description: To be documented

Note	None documented

function RPiBootConsoleGetY:LongWord;

Description: To be documented

Note	None documented

function RPiConvertPowerIdRequest(PowerId:LongWord):LongWord;

Description: Convert Ultibo Power Id to BCM2835 Power Id

Note	None documented

function RPiConvertPowerStateRequest(PowerState:LongWord):LongWord;

Description: Convert Ultibo Power State to BCM2835 Power State

Note	None documented

function RPiConvertPowerStateResponse(PowerState:LongWord):LongWord;

Description: Convert BCM2835 Power State to Ultibo Power State

Note	None documented

function RPiConvertClockIdRequest(ClockId:LongWord):LongWord;

Description: Convert Ultibo Clock Id to BCM2835 Clock Id

Note	None documented

function RPiConvertClockStateRequest(ClockState:LongWord):LongWord;

Description: Convert Ultibo Clock State to BCM2835 Clock State

Note	None documented

function RPiConvertClockStateResponse(ClockState:LongWord):LongWord;

Description: Convert BCM2835 Clock State to Ultibo Clock State

Note	None documented

function RPiConvertVoltageIdRequest(VoltageId:LongWord):LongWord;

Description: Convert Ultibo Voltage Id to BCM2835 Voltage Id

Note	None documented

function RPiConvertTemperatureIdRequest(TemperatureId:LongWord):LongWord;

Description: Convert Ultibo Temperature Id to BCM2835 Temperature Id

Note	None documented

Return to Unit Reference

`RPI_PAGE_TABLE_BASE = $00004000;`	Place the first level Page Table after the interrupt vectors at 0x00001000 and before the code start at 0x00008000
`RPI_PAGE_TABLE_SIZE = SIZE_16K;`	ARM1176 first level Page Table is exactly 16KB in size (4096 32 bit (4 byte) entries)

Difference between revisions of "Unit PlatformRPi"

Latest revision as of 05:10, 23 November 2022

Contents

Description

Constants

Type definitions

Public variables

Function declarations

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools

@@ Line 5: / Line 5: @@
 ----
-'''Ultibo Platform interface unit for Raspberry Pi'''
+'''Ultibo Platform Interface unit for Raspberry Pi'''
 The RPi A+/B+ have the Power LED connected to GPIO Pin 35 (Activity LED is now on GPIO Pin 47 instead of Pin 16 in model A/B).
@@ Line 13: / Line 14: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi ARM physical to VC IO mapping constants''' <code> RPI_VCIO_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi ARM physical to VC IO mapping''' <code> RPI_VCIO_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 24: / Line 25: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi ARM physical to VC bus mapping constants''' <code> RPI_VCBUS_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi ARM physical to VC bus mapping''' <code> RPI_VCBUS_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 35: / Line 36: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi address of StartupHandler on reset constants''' <code> RPI_STARTUP_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi address of StartupHandler on reset''' <code> RPI_STARTUP_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
 | <code>RPI_STARTUP_ADDRESS = $00008000;</code>
-| style="width: 50%;"|&nbsp;
+| Address of StartupHandler on Reset (Obtain from linker)
 |-
 |}
@@ Line 46: / Line 47: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi page table address and size constants''' <code> RPI_PAGE_TABLE_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi page table address and size''' <code> RPI_PAGE_TABLE_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 60: / Line 61: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi vector table address and size constants''' <code> RPI_VECTOR_TABLE_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi vector table address and size''' <code> RPI_VECTOR_TABLE_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 77: / Line 78: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi CPU count, boot and mask constants''' <code> RPI_CPU_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi CPU count, boot and mask''' <code> RPI_CPU_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 94: / Line 95: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi SWI constants''' <code> RPI_SWI_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi SWI''' <code> RPI_SWI_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 105: / Line 106: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi kernel image name constants''' <code> RPI_KERNEL_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi kernel image name''' <code> RPI_KERNEL_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 117: / Line 118: @@
 | <code>RPI_KERNEL_COMMAND = 'cmdline.txt';</code>
 | &nbsp;
+|-
+|colspan="2"|<code>RPI_FIRMWARE_FILES = 'bootcode.bin,start.elf,fixup.dat';</code>
+|-
+|colspan="2"|<code>RPI_DTB_FILES = 'bcm2708-rpi-b.dtb,bcm2708-rpi-b-plus.dtb,bcm2708-rpi-b-rev1.dtb,bcm2708-rpi-cm.dtb,bcm2708-rpi-zero.dtb,bcm2708-rpi-zero-w.dtb';</code>
 |-
 |}
@@ Line 122: / Line 127: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi plus GPIO power LED constants ''' <code> RPIPLUS_GPIO_PWRLED_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi plus GPIO power LED''' <code> RPIPLUS_GPIO_PWRLED_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 169: / Line 174: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi GPIO activity LED constants ''' <code> RPI_GPIO_ACTLED_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi GPIO activity LED''' <code> RPI_GPIO_ACTLED_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 208: / Line 213: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi plus GPIO activity LED constants''' <code> RPIPLUS_GPIO_ACTLED_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi plus GPIO activity LED''' <code> RPIPLUS_GPIO_ACTLED_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 245: / Line 250: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RPi mailbox constants''' <code> RPI_MAILBOX_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RPi mailbox''' <code> RPI_MAILBOX_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 254: / Line 259: @@
 | <code>RPI_MAILBOX_TIMEOUT_EX = 1000;</code>
 | Extended timeout to wait for mailbox calls to complete (Milliseconds)
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
+<div style="font-size: 14px; padding-left: 12px;">'''RPi framebuffer''' <code> RPI_FRAMEBUFFER_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>RPI_FRAMEBUFFER_DESCRIPTION = 'BCM2835 Framebuffer';</code>
+| style="width: 50%;"|&nbsp;
 |-
 |}
@@ Line 267: / Line 283: @@
 ----
-''To be documented''
+'''RPi specific Ultibo variables'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>RPiInitialized:Boolean;</code>
+| style="width: 40%;"|
+|-
+|}
+'''Timer variables'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>TimerRegisters:PBCM2835SystemTimerRegisters;</code>
+| style="width: 40%;"|
+|-
+|}
+'''Mailbox variables'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>Mailbox0Registers:PBCM2835Mailbox0Registers;</code>
+| style="width: 40%;"|
+|-
+|}
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>Mailbox1Registers:PBCM2835Mailbox1Registers;</code>
+| style="width: 40%;"|
+|-
+|}
+'''Interrupt variables'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>InterruptRegisters:PBCM2835InterruptRegisters;</code>
+| style="width: 40%;"|
+|-
+|}
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>InterruptEntries:array[0..(BCM2835_IRQ_COUNT - 1)] of PInterruptEntry;</code>
+| style="width: 40%;"|
+|-
+|}
+'''System call'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>SystemCallEntries:array[0..RPI_SWI_COUNT - 1] of TSystemCallEntry;</code>
+| style="width: 40%;"|
+|-
+|}
+'''IRQ/FIQ'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>IRQEnabled:array[0..2] of LongWord;</code>
+| style="width: 40%;"|3 groups of IRQs to Enable/Disable (See: TBCM2835InterruptRegisters)
+|-
+|}
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>FIQEnabled:LongWord;</code>
+| style="width: 40%;"|The single IRQ number to Enable as FIQ instead (See: TBCM2835InterruptRegisters)
+|-
+|}
+'''Watchdog variables'''
+{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
+|-
+| <code>WatchdogRegisters:PBCM2835PMWatchdogRegisters;</code>
+| style="width: 40%;"|
+|-
+|}
+<br />
 === Function declarations ===
@@ Line 281: / Line 378: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 296: / Line 393: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 308: / Line 405: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 320: / Line 417: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 332: / Line 429: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 344: / Line 441: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 356: / Line 453: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 368: / Line 465: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 380: / Line 477: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 392: / Line 489: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | See page 6-36 of the ARM1176JZF-S Technical Reference Manual
 |-
@@ Line 404: / Line 501: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 416: / Line 513: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 428: / Line 525: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 440: / Line 537: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 452: / Line 549: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 464: / Line 561: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 476: / Line 573: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Data = first 28 bits, Channel = last 4 bits
 |-
@@ Line 488: / Line 585: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Data = first 28 bits, Channel = last 4 bits
 |-
@@ Line 500: / Line 597: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Data = first 28 bits, Channel = last 4 bits
 Data pointer must be 16 byte aligned to allow for the 4 bit channel number
@@ Line 513: / Line 610: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Data = first 28 bits, Channel = last 4 bits
 Data pointer must be 16 byte aligned to allow for the 4 bit channel number
@@ Line 526: / Line 623: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Data = first 28 bits, Channel = last 4 bits
 Data pointer must be 16 byte aligned to allow for the 4 bit channel number
@@ Line 539: / Line 636: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Data = first 28 bits, Channel = last 4 bits
 Data pointer must be 16 byte aligned to allow for the 4 bit channel number
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiMailboxPropertyTag(Tag:LongWord; Data:Pointer; Size:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Request a property tag (Get/Set) from the mailbox property channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Data
+| Data does not need to include mailbox property channel header or footer. Data pointer does not need any specific alignment or caching attributes.
+|-
+! Size
+| Size must be a multiple of 4 bytes. Size must include the size of the request and response which use the same buffer.
 |-
 |}
@@ Line 552: / Line 664: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''CPUID'''
+! CPUID
 | CPU to route IRQ to (Ignored on RPi)
 |-
-! '''Number'''
+! Number
 | IRQ number to register
 |-
-! '''Handler'''
+! Handler
 | Interrupt handler function to register
 |-
-! '''HandlerEx'''
+! HandlerEx
 | Extended Interrupt handler function to register
 |-
-! '''Note'''
+! Note
 | Only one of Handler or HandlerEx can be specified
 |-
@@ Line 576: / Line 688: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''CPUID'''
+! Note
-| CPU to route IRQ to (Ignored on RPi)
+| None documented
-|-
-! '''Number'''
-| IRQ number to deregister
-|-
-! '''Handler'''
-| Interrupt handler function to deregister
-|-
-! '''HandlerEx'''
-| Extended Interrupt handler function to deregister
-|-
-! '''Note'''
-| Only one of Handler or HandlerEx can be specified
 |-
 |}
@@ Line 600: / Line 700: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''CPUID'''
+! Note
-| CPU to route FIQ to (Ignored on RPi)
+| None documented
-|-
-! '''Number'''
-| FIQ number to register
-|-
-! '''Handler'''
-| Interrupt handler function to register
-|-
-! '''HandlerEx'''
-| Extended Interrupt handler function to register
-|-
-! '''Note'''
-| Only one of Handler or HandlerEx can be specified
 |-
 |}
@@ Line 624: / Line 712: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''CPUID'''
+! Note
-| CPU to route FIQ to (Ignored on RPi)
+| None documented
 |-
-! '''Number'''
+|}
-| FIQ number to deregister
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiRegisterInterrupt(Number,Mask,Priority,Flags:LongWord; Handler:TSharedInterruptHandler; Parameter:Pointer):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Request registration of the supplied handler to the specified interrupt number (Where Applicable)</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Handler'''
+! Note
-| Interrupt handler function to deregister
+| None documented
 |-
-! '''HandlerEx'''
+|}
-| Extended Interrupt handler function to deregister
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiDeregisterInterrupt(Number,Mask,Priority,Flags:LongWord; Handler:TSharedInterruptHandler; Parameter:Pointer):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Request deregistration of the supplied handler from the specified interrupt number (Where Applicable)</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Only one of Handler or HandlerEx can be specified
+| None documented
 |-
 |}
@@ Line 648: / Line 748: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''CPUID'''
+! Note
-| The CPU ID to register the System Call against (Ignored on RPi)
+| None documented
-|-
-! '''Number'''
-| The System Call number to be registered
-|-
-! '''Handler'''
-| The handler function to be registered
-|-
-! '''HandlerEx'''
-| The extended handler function to be registered
-|-
-! '''Note'''
-| Only one of Handler or HandlerEx can be specified
 |-
 |}
@@ Line 672: / Line 760: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''CPUID'''
+! Note
-| The CPU ID to deregister the System Call from (Ignored on RPi)
+| None documented
-|-
-! '''Number'''
-| The System Call number to be deregistered
-|-
-! '''Handler'''
-| The handler function to be deregistered
-|-
-! '''HandlerEx'''
-| The extended handler function to be deregistered
-|-
-! '''Note'''
-| Only one of Handler or HandlerEx can be specified
 |-
 |}
@@ Line 691: / Line 767: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiGetInterruptEntry(Number:LongWord):TInterruptEntry;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiGetInterruptEntry(Number,Instance:LongWord; var Interrupt:TInterruptEntry):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the interrupt entry for the specified interrupt number</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the interrupt entry for the specified interrupt number and instance</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 708: / Line 784: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Get the system call entry for the specified system call number
 |-
@@ Line 720: / Line 796: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 732: / Line 808: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 744: / Line 820: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 751: / Line 827: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiCPUGetMemory(var Address:PtrUInt; var Length:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiCPUGetMemory(var Address:PtrUInt; var Length:UInt64):LongWord;</pre>
 <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the CPU Memory from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 768: / Line 844: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 775: / Line 851: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiGPUGetMemory(var Address:PtrUInt; var Length:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiGPUGetMemory(var Address:PtrUInt; var Length:UInt64):LongWord;</pre>
 <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the GPU Memory from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 792: / Line 868: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 804: / Line 880: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 816: / Line 892: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 828: / Line 904: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 840: / Line 916: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiFirmwareGetThrottled:LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the Firmware Throttling state from the Mailbox property tags channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
 | None documented
 |-
@@ Line 852: / Line 940: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 864: / Line 952: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 876: / Line 964: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Power Lock not required due to Mailbox Property Call serialization
 |-
@@ Line 888: / Line 976: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | On the Raspberry Pi this comes from the System Timer free running counter which runs at 1MHz and therefore overflows every 4295 seconds
 |-
@@ Line 900: / Line 988: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | On the Raspberry Pi this comes from the System Timer free running counter which runs at 1MHz, the clock interrupt also uses this timer to increment the clock every second and therefore keep time.
 |-
@@ Line 912: / Line 1,000: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 924: / Line 1,012: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 936: / Line 1,024: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 948: / Line 1,036: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 960: / Line 1,048: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 972: / Line 1,060: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 984: / Line 1,072: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 996: / Line 1,084: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,008: / Line 1,096: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,020: / Line 1,108: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,032: / Line 1,120: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,044: / Line 1,132: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,056: / Line 1,144: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,068: / Line 1,156: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,080: / Line 1,168: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,092: / Line 1,180: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,104: / Line 1,192: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,116: / Line 1,204: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,128: / Line 1,216: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,140: / Line 1,228: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,152: / Line 1,240: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,164: / Line 1,252: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,176: / Line 1,264: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,188: / Line 1,276: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,200: / Line 1,288: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,212: / Line 1,300: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,224: / Line 1,312: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,236: / Line 1,324: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,248: / Line 1,336: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,260: / Line 1,348: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,272: / Line 1,360: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,284: / Line 1,372: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,296: / Line 1,384: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,308: / Line 1,396: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,320: / Line 1,408: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,332: / Line 1,420: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,344: / Line 1,432: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,356: / Line 1,444: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,368: / Line 1,456: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,380: / Line 1,468: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,392: / Line 1,480: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,404: / Line 1,492: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,416: / Line 1,504: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,428: / Line 1,516: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,440: / Line 1,528: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,452: / Line 1,540: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,464: / Line 1,552: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,476: / Line 1,564: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,488: / Line 1,576: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,500: / Line 1,588: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferGetLayer(var Layer:LongInt):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get Framebuffer Layer from the Mailbox property tags channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferSetLayer(var Layer:LongInt):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Framebuffer Layer from the Mailbox property tags channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferTestLayer(var Layer:LongInt):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Test Framebuffer Layer from the Mailbox property tags channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
 | None documented
 |-
@@ Line 1,512: / Line 1,636: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,524: / Line 1,648: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,536: / Line 1,660: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,543: / Line 1,667: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiTouchGetBuffer(var Address:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferGetNumDisplays(var NumDisplays:LongWord):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the Touchscreen buffer from the Mailbox property tags channel</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the number of displays from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,555: / Line 1,679: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiCursorSetDefault:LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferGetDisplayId(DisplayNum:LongWord):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Cursor Default (Pixels) from the Mailbox property tags channel</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the display id for the specified display number from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,567: / Line 1,691: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiCursorSetInfo(Width,Height,HotspotX,HotspotY:LongWord; Pixels:Pointer; Length:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferSetDisplayNum(DisplayNum:LongWord):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Curson Info (Pixels) from the Mailbox property tags channel</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the display number that all framebuffer requests will refer to using the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,579: / Line 1,703: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiCursorSetState(Enabled:Boolean; X,Y:LongWord; Relative:Boolean):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferGetDisplaySettings(DisplayNum:LongWord; var DisplaySettings:TDisplaySettings):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Cursor State (Enable, X, Y) from the Mailbox property tags channel</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the display settings for the specified display number from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Relative'''
+! Note
-| X, Y is relative to Display (Virtual) not Framebuffer (Physical)
+| None documented
 |-
 |}
@@ Line 1,591: / Line 1,715: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiDMAGetChannels:LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferDisplayIdToName(DisplayId:LongWord):String;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the available DMA Channels from the Mailbox property tags channel</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the name for the specified display id</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,602: / Line 1,726: @@
 </div></div>
 <br />
-'''RPi tthread functions'''
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">procedure RPiSchedulerInit;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiTouchGetBuffer(var Address:PtrUInt):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the Touchscreen buffer from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,617: / Line 1,738: @@
 </div></div>
 <br />
-'''RPi IRQ functions'''
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiDispatchIRQ(CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiTouchSetBuffer(Address:PtrUInt):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Process any pending IRQ requests</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the Touchscreen buffer in the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Called by ARMv6IRQHandler in PlatformARMv6
+| None documented
-A DataMemoryBarrier is executed before and after calling this function
 |-
 |}
@@ Line 1,634: / Line 1,751: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiHandleIRQ(Number,CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiCursorSetDefault:LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Call the handler function for an IRQ that was received, or halt if it doesn't exist</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Cursor Default (Pixels) from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,645: / Line 1,762: @@
 </div></div>
 <br />
-'''RPi FIQ functions'''
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiDispatchFIQ(CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiCursorSetInfo(Width,Height,HotspotX,HotspotY:LongWord; Pixels:Pointer; Length:LongWord):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Process any pending FIQ requests</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Cursor Info (Pixels) from the Mailbox property tags channel</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Called by ARMv6FIQHandler in PlatformARMv6
+| None documented
-A DataMemoryBarrier is executed before and after calling this function
 |-
 |}
@@ Line 1,662: / Line 1,775: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiHandleFIQ(Number,CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiCursorSetState(Enabled:Boolean; X,Y:LongWord; Relative:Boolean):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Call the handler function for an FIQ that was received, or halt if it doesn't exist</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Cursor State (Enable, X, Y) from the Mailbox property tags channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Relative
+| X, Y is relative to Display (Virtual) not Framebuffer (Physical).
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiDMAGetChannels:LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the available DMA Channels from the Mailbox property tags channel</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+'''RPi thread functions'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">procedure RPiSchedulerInit;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,682: / Line 1,822: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Called by ARMv6SoftwareInterruptHandler in PlatformARMv6
 A DataMemoryBarrier is executed before and after calling this function
@@ Line 1,698: / Line 1,838: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | This schedules another clock interrupt to occur CLOCK_CYCLES_PER_TICK in the future, then updates ClockTicks and ClockSeconds.
 |-
@@ Line 1,710: / Line 1,850: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Cycles'''
+! Cycles
 | Number of cycles after which the timer interrupt is to be triggered
 |-
-! '''Note'''
+! Note
 | This refers to native clock cycles as specified by CLOCK_FREQUENCY
 |-
@@ Line 1,728: / Line 1,868: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | This schedules another scheduler interrupt to occur SCHEDULER_CLOCKS_PER_INTERRUPT in the future, then checks for threads to wakeup and the next thread to schedule.
 |-
@@ Line 1,740: / Line 1,880: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Cycles'''
+! Cycles
 | Number of cycles after which the scheduler interrupt is to be triggered
 |-
-! '''Note'''
+! Note
 | This refers to native clock cycles as specified by CLOCK_FREQUENCY
 |-
@@ Line 1,755: / Line 1,895: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | This is registered to receive requests for the SYSTEM_CALL_CONTEXT_SWITCH and will perform a context switch from within an SWI
 |-
@@ Line 1,770: / Line 1,910: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,782: / Line 1,922: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,794: / Line 1,934: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,806: / Line 1,946: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,813: / Line 1,953: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferDeviceCommit(Framebuffer:PFramebufferDevice; Address,Size,Flags:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferDeviceCommit(Framebuffer:PFramebufferDevice; Address:PtrUInt; Size,Flags:LongWord):LongWord;</pre>
 <div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,830: / Line 1,970: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| None documented
-|-
-|}
-</div></div>
-<br />
-<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function RPiFramebufferDeviceSetProperties(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
-<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
-{| class="wikitable" style="font-size: 14px; background: white;"
-|-
-! '''Note'''
 | None documented
 |-
@@ Line 1,857: / Line 1,985: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,869: / Line 1,997: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,881: / Line 2,009: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,893: / Line 2,021: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,905: / Line 2,033: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,917: / Line 2,045: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | This currently only works for RPiA+/B+
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">procedure RPiBootOutput(Value:LongWord);</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Output characters to UART0 without dependency on any other RTL setup</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| This function is primarily intended for testing QEMU boot because it doesn't initialize the UART and won't work on real hardware.
+Based on hexstrings() function by dwelch67 (https://github.com/dwelch67)
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">procedure RPiBootConsoleStart;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">procedure RPiBootConsoleWrite(const Value:String);</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">procedure RPiBootConsoleWriteEx(const Value:String; X,Y:LongWord);</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiBootConsoleGetX:LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
+|-
+|}
+</div></div>
+<br />
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
+<pre style="border: 0; padding-bottom:0px;">function RPiBootConsoleGetY:LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| None documented
 |-
 |}
@@ Line 1,929: / Line 2,130: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,941: / Line 2,142: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,953: / Line 2,154: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,965: / Line 2,166: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,977: / Line 2,178: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,989: / Line 2,190: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 2,001: / Line 2,202: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 2,013: / Line 2,214: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-