Difference between revisions of "Unit PlatformRPi3"

Revision as of 05:21, 3 April 2017 (view source) Ultibo (Talk | contribs) ← Older edit		Latest revision as of 05:09, 23 November 2022 (view source) Ultibo (Talk | contribs)
(15 intermediate revisions by the same user not shown)
Line 5:		Line 5:
	----		----
−	'''Ultibo Platform interface unit for Raspberry Pi 3'''	+	'''Ultibo Platform Interface unit for Raspberry Pi 3'''
−	The RPi3 B has the Activity LED connected to the GPU, access is via a Virtual GPIO (Power LED appears to be unavailable).	+	The RPi3 B has the Activity LED connected to the GPU, access is via a Virtual GPIO (Power LED is only accessible via the GPIO expander driver).
		+
		+	The RPi3 B+ has the Activity LED connected to GPIO Pin 29 (Power LED is only accessible via the GPIO expander driver).
	=== Constants ===		=== Constants ===
Line 41:		Line 43:
	|-		|-
	| <code>RPI3_SECURE_BOOT = $00000001;</code>		| <code>RPI3_SECURE_BOOT = $00000001;</code>
−	| If 1 then startup will attempt to switch back to secure world during boot process	+	| If 1 then startup will attempt to switch back to secure world during boot process (Moved to ARMSecureBoot)
		+	|-
		+	| <code>RPI3_SECURE_BOOT_OFFSET = $000000D4;</code>
		+	| The address of the Secure Boot marker in the ARM boot stub
		+	|-
		+	| <code>RPI3_SECURE_BOOT_MARKER = $58495052;</code>
		+	| The Secure Boot marker (ASCII "RPIX")
	|-		|-
	|}		|}
Line 52:		Line 60:
	|-		|-
	| <code>RPI3_STARTUP_ADDRESS = $00008000;</code>		| <code>RPI3_STARTUP_ADDRESS = $00008000;</code>
−	| style="width: 50%;"|&nbsp;	+	| Address of StartupHandler on Reset (Obtain from linker)
	|-		|-
	|}		|}
Line 177:		Line 185:
	| <code>RPI3_KERNEL_COMMAND = 'cmdline.txt';</code>		| <code>RPI3_KERNEL_COMMAND = 'cmdline.txt';</code>
	| &nbsp;		| &nbsp;
		+	|-
		+	|colspan="2"|<code>RPI3_FIRMWARE_FILES = 'bootcode.bin,start.elf,fixup.dat,armstub32-rpi3.bin,armstub64-rpi3.bin';</code>
		+	|-
		+	|colspan="2"|<code>RPI3_DTB_FILES = 'bcm2710-rpi-2-b.dtb,bcm2710-rpi-3-b.dtb,bcm2710-rpi-3-b-plus.dtb,bcm2710-rpi-cm3.dtb,bcm2710-rpi-zero-2.dtb,bcm2710-rpi-zero-2-w.dtb';</code>
	|-		|-
	|}		|}
Line 202:		Line 214:
	| <code>RPI3_LOCAL_MAILBOX_TIMEOUT = 100;</code>		| <code>RPI3_LOCAL_MAILBOX_TIMEOUT = 100;</code>
	| Default timeout to wait for local mailbox calls to complete (Milliseconds)		| Default timeout to wait for local 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;">'''RPi3 framebuffer''' <code> RPI3_FRAMEBUFFER_* </code></div>
		+	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
		+	{| class="wikitable" style="font-size: 14px; background: white;"
		+	|-
		+	| <code>RPI3_FRAMEBUFFER_DESCRIPTION = 'BCM2837 Framebuffer';</code>
		+	| style="width: 50%;"|&nbsp;
	|-		|-
	|}		|}
Line 221:		Line 244:
	|-		|-
	| <code>RPi3Initialized:Boolean;</code>		| <code>RPi3Initialized:Boolean;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 227:		Line 250:
	|-		|-
	| <code>RPi3CNTVOFFLow:LongWord = 0;</code>		| <code>RPi3CNTVOFFLow:LongWord = 0;</code>
−	| style="width: 65%;"|The low 32 bits of the Virtual Counter Offset register at boot time (CPU0 only) (Set by Startup). Must be initialized to remain in .data or else rewritten to zero with .bss	+	| style="width: 40%;"|The low 32 bits of the Virtual Counter Offset register at boot time (CPU0 only) (Set by Startup). Must be initialized to remain in .data or else rewritten to zero with .bss
	|-		|-
	|}		|}
Line 233:		Line 256:
	|-		|-
	| <code>RPi3CNTVOFFHigh:LongWord = 0;</code>		| <code>RPi3CNTVOFFHigh:LongWord = 0;</code>
−	| style="width: 65%;"|The high 32 bits of the Virtual Counter Offset register at boot time (CPU0 only) (Set by Startup). Must be initialized to remain in .data or else rewritten to zero with .bss	+	| style="width: 40%;"|The high 32 bits of the Virtual Counter Offset register at boot time (CPU0 only) (Set by Startup). Must be initialized to remain in .data or else rewritten to zero with .bss
	|-		|-
	|}		|}
Line 242:		Line 265:
	|-		|-
	| <code>TimerRegisters:PBCM2837SystemTimerRegisters;</code>		| <code>TimerRegisters:PBCM2837SystemTimerRegisters;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 251:		Line 274:
	|-		|-
	| <code>Mailbox0Registers:PBCM2837Mailbox0Registers;</code>		| <code>Mailbox0Registers:PBCM2837Mailbox0Registers;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
		+	|-
		+	|}
		+	{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
		+	|-
		+	| <code>Mailbox1Registers:PBCM2837Mailbox1Registers;</code>
		+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 260:		Line 289:
	|-		|-
	| <code>InterruptRegisters:PBCM2837InterruptRegisters;</code>		| <code>InterruptRegisters:PBCM2837InterruptRegisters;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
	{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"		{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
	|-		|-
−	| <code>InterruptEntries:array[0..(BCM2837_GPU_IRQ_COUNT + BCM2837_ARM_IRQ_COUNT - 1)] of TInterruptEntry;</code>	+	| <code>InterruptEntries:array[0..(BCM2837_GPU_IRQ_COUNT + BCM2837_ARM_IRQ_COUNT - 1)] of PInterruptEntry;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
	{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"		{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
	|-		|-
−	| <code>LocalInterruptEntries:array[RPI3_IRQ_LOCAL_START..(BCM2837_IRQ_COUNT - 1),0..(RPI3_CPU_COUNT - 1)] of TInterruptEntry;</code>	+	| <code>LocalInterruptEntries:array[RPI3_IRQ_LOCAL_START..(BCM2837_IRQ_COUNT - 1),0..(RPI3_CPU_COUNT - 1)] of PInterruptEntry;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 281:		Line 310:
	|-		|-
	| <code>SystemCallEntries:array[0..RPI3_SWI_COUNT - 1] of TSystemCallEntry;</code>		| <code>SystemCallEntries:array[0..RPI3_SWI_COUNT - 1] of TSystemCallEntry;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 290:		Line 319:
	|-		|-
	| <code>IRQEnabled:array[0..2] of LongWord;</code>		| <code>IRQEnabled:array[0..2] of LongWord;</code>
−	| style="width: 65%;"|3 groups of IRQs to Enable/Disable (See: TBCM2837InterruptRegisters)	+	| style="width: 40%;"|3 groups of IRQs to Enable/Disable (See: TBCM2837InterruptRegisters)
	|-		|-
	|}		|}
Line 296:		Line 325:
	|-		|-
	| <code>FIQEnabled:LongWord;</code>		| <code>FIQEnabled:LongWord;</code>
−	| style="width: 65%;"|The single IRQ number to Enable as FIQ instead (See: TBCM2837InterruptRegisters)	+	| style="width: 40%;"|The single IRQ number to Enable as FIQ instead (See: TBCM2837InterruptRegisters)
	|-		|-
	|}		|}
	{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"		{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
	|-		|-
−	| <code>IRQLocalEnabled:array[0..(RPI3_CPU_COUNT - 1)] of LongWord;</code>	+	| <code>LocalIRQEnabled:array[0..(RPI3_CPU_COUNT - 1)] of LongWord;</code>
−	| style="width: 65%;"|1 group of local IRQs to Enable/Disable per CPU (See: TBCM2837ARMLocalRegisters)	+	| style="width: 40%;"|1 group of local IRQs to Enable/Disable per CPU (See: TBCM2837ARMLocalRegisters)
	|-		|-
	|}		|}
	{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"		{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
	|-		|-
−	| <code>FIQLocalEnabled:array[0..(RPI3_CPU_COUNT - 1)] of LongWord;</code>	+	| <code>LocalFIQEnabled:array[0..(RPI3_CPU_COUNT - 1)] of LongWord;</code>
−	| style="width: 65%;"|1 group of local FIQs to Enable/Disable per CPU (See: TBCM2837ARMLocalRegisters)	+	| style="width: 40%;"|1 group of local FIQs to Enable/Disable per CPU (See: TBCM2837ARMLocalRegisters)
	|-		|-
	|}		|}
Line 317:		Line 346:
	|-		|-
	| <code>WatchdogRegisters:PBCM2837PMWatchdogRegisters;</code>		| <code>WatchdogRegisters:PBCM2837PMWatchdogRegisters;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 326:		Line 355:
	|-		|-
	| <code>ARMLocalRegisters:PBCM2837ARMLocalRegisters;</code>		| <code>ARMLocalRegisters:PBCM2837ARMLocalRegisters;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 335:		Line 364:
	|-		|-
	| <code>VirtualGPIOBuffer:TBCM2837VirtualGPIOBuffer;</code>		| <code>VirtualGPIOBuffer:TBCM2837VirtualGPIOBuffer;</code>
−	| style="width: 65%;"|	+	| style="width: 40%;"|
	|-		|-
	|}		|}
Line 352:		Line 381:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 364:		Line 393:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 376:		Line 405:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 388:		Line 417:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 403:		Line 432:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 415:		Line 444:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 427:		Line 456:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 439:		Line 468:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 451:		Line 480:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 463:		Line 492:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 475:		Line 504:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 487:		Line 516:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 499:		Line 528:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 511:		Line 540:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 523:		Line 552:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 535:		Line 564:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 547:		Line 576:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 559:		Line 588:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 571:		Line 600:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 583:		Line 612:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 595:		Line 624:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Data = first 28 bits, Channel = last 4 bits		| Data = first 28 bits, Channel = last 4 bits
	|-		|-
Line 607:		Line 636:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Data = first 28 bits, Channel = last 4 bits		| Data = first 28 bits, Channel = last 4 bits
	|-		|-
Line 619:		Line 648:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Data = first 28 bits, Channel = last 4 bits		| Data = first 28 bits, Channel = last 4 bits
	Data pointer must be 16 byte aligned to allow for the 4 bit channel number		Data pointer must be 16 byte aligned to allow for the 4 bit channel number
Line 632:		Line 661:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Data = first 28 bits, Channel = last 4 bits		| Data = first 28 bits, Channel = last 4 bits
	Data pointer must be 16 byte aligned to allow for the 4 bit channel number		Data pointer must be 16 byte aligned to allow for the 4 bit channel number
Line 645:		Line 674:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Data = first 28 bits, Channel = last 4 bits		| Data = first 28 bits, Channel = last 4 bits
	Data pointer must be 16 byte aligned to allow for the 4 bit channel number		Data pointer must be 16 byte aligned to allow for the 4 bit channel number
Line 658:		Line 687:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Data = first 28 bits, Channel = last 4 bits		| Data = first 28 bits, Channel = last 4 bits
	Data pointer must be 16 byte aligned to allow for the 4 bit channel number		Data pointer must be 16 byte aligned to allow for the 4 bit channel number
Line 666:		Line 695:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3RequestExIRQ(CPUID,Number:LongWord; Handler:TInterruptHandler; HandlerEx:TInterruptExHandler; Parameter:Pointer):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3MailboxPropertyTag(Tag:LongWord; Data:Pointer; Size:LongWord):LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Request registration of the supplied handler to the specified IRQ number</div>	+	<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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''CPUID'''	+	! Data
−	| CPU to route IRQ to	+	| Data does not need to include mailbox property channel header or footer. Data pointer does not need any specific alignment or caching attributes.
	|-		|-
−	! '''Number'''	+	! Size
−	| IRQ number to register	+	| Size must be a multiple of 4 bytes. Size must include the size of the request and response which use the same buffer.
	|-		|-
−	! '''Handler'''	+	|}
−	| Interrupt handler function to register	+	</div></div>
−	|-	+	<br />
−	! '''HandlerEx'''	+	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
−	| Extended Interrupt handler function to register	+	<pre style="border: 0; padding-bottom:0px;">function RPi3RequestExIRQ(CPUID,Number:LongWord; Handler:TInterruptHandler; HandlerEx:TInterruptExHandler; Parameter:Pointer):LongWord;</pre>
		+	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Request registration of the supplied handler to the specified IRQ number</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	+	| Non documented
	|-		|-
	|}		|}
Line 695:		Line 727:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''CPUID'''	+	! Note
−	| CPU to route IRQ to	+	| Non 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 719:		Line 739:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''CPUID'''	+	! Note
−	| CPU to route FIQ to	+	| Non 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 743:		Line 751:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''CPUID'''	+	! Note
−	| CPU to route FIQ to	+	| Non 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 RPi3RegisterInterrupt(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 RPi3DeregisterInterrupt(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 767:		Line 787:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''CPUID'''	+	! Note
−	| The CPU ID to register the System Call against (or CPU_ID_ALL)	+	| Non 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 791:		Line 799:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''CPUID'''	+	! Note
−	| The CPU ID to deregister the System Call from (or CPU_ID_ALL)	+	| 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 810:		Line 806:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3GetInterruptEntry(Number:LongWord):TInterruptEntry;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3GetInterruptEntry(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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 822:		Line 818:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3GetLocalInterruptEntry(CPUID,Number:LongWord):TInterruptEntry;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3GetLocalInterruptEntry(CPUID,Number,Instance:LongWord; var Interrupt:TInterruptEntry):LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the local interrupt entry for the specified interrupt number</div>	+	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the local interrupt entry for the specified interrupt number and instance</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 839:		Line 835:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 851:		Line 847:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 863:		Line 859:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 875:		Line 871:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 882:		Line 878:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3CPUGetMemory(var Address:PtrUInt; var Length:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3CPUGetMemory(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 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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 899:		Line 895:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 906:		Line 902:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3GPUGetMemory(var Address:PtrUInt; var Length:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3GPUGetMemory(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 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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 923:		Line 919:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 935:		Line 931:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 947:		Line 943:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 959:		Line 955:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 971:		Line 967:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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 RPi3FirmwareGetThrottled: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		| None documented
	|-		|-
Line 983:		Line 991:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 995:		Line 1,003:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,007:		Line 1,015:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Power Lock not required due to Mailbox Property Call serialization		| Power Lock not required due to Mailbox Property Call serialization
	|-		|-
Line 1,019:		Line 1,027:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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		| On the Raspberry Pi this comes from the System Timer free running counter which runs at 1MHz and therefore overflows every 4295 seconds
	|-		|-
Line 1,031:		Line 1,039:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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.		| 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 1,043:		Line 1,051:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,055:		Line 1,063:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,067:		Line 1,075:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,079:		Line 1,087:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,091:		Line 1,099:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,103:		Line 1,111:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,115:		Line 1,123:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,127:		Line 1,135:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,139:		Line 1,147:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,151:		Line 1,159:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,163:		Line 1,171:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,175:		Line 1,183:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,187:		Line 1,195:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,199:		Line 1,207:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,211:		Line 1,219:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,223:		Line 1,231:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,235:		Line 1,243:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,247:		Line 1,255:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,259:		Line 1,267:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,271:		Line 1,279:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,283:		Line 1,291:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,295:		Line 1,303:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,307:		Line 1,315:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,319:		Line 1,327:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,331:		Line 1,339:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,343:		Line 1,351:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,355:		Line 1,363:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,367:		Line 1,375:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,379:		Line 1,387:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,391:		Line 1,399:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,403:		Line 1,411:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,415:		Line 1,423:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,427:		Line 1,435:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,439:		Line 1,447:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,451:		Line 1,459:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,463:		Line 1,471:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,475:		Line 1,483:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,487:		Line 1,495:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,499:		Line 1,507:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,511:		Line 1,519:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,523:		Line 1,531:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,535:		Line 1,543:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,547:		Line 1,555:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,559:		Line 1,567:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,571:		Line 1,579:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,583:		Line 1,591:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,595:		Line 1,603:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,607:		Line 1,615:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,619:		Line 1,627:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,631:		Line 1,639:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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 RPi3FramebufferGetLayer(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 RPi3FramebufferSetLayer(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 RPi3FramebufferTestLayer(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		| None documented
	|-		|-
Line 1,643:		Line 1,687:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,655:		Line 1,699:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,667:		Line 1,711:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,674:		Line 1,718:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3TouchGetBuffer(var Address:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3FramebufferGetNumDisplays(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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,686:		Line 1,730:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3VirtualGPIOGetBuffer(var Address:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3FramebufferGetDisplayId(DisplayNum:LongWord):LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the Virtual GPIO buffer 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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,698:		Line 1,742:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3CursorSetDefault:LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3FramebufferSetDisplayNum(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 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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,710:		Line 1,754:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3CursorSetInfo(Width,Height,HotspotX,HotspotY:LongWord; Pixels:Pointer; Length:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3FramebufferGetDisplaySettings(DisplayNum:LongWord; var DisplaySettings:TDisplaySettings):LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set Cursor Info (Pixels) 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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,722:		Line 1,766:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3CursorSetState(Enabled:Boolean; X,Y:LongWord; Relative:Boolean):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3FramebufferDisplayIdToName(DisplayId:LongWord):String;</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 name for the specified display id</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Relative'''	+	! Note
−	| X, Y is relative to Display (Virtual) not Framebuffer (Physical)	+	| None documented
	|-		|-
	|}		|}
Line 1,734:		Line 1,778:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3DMAGetChannels:LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3TouchGetBuffer(var Address:PtrUInt):LongWord;</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 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
		+	| On current firmware versions calling TouchGetBuffer will allocate a buffer from GPU memory and render subsequent calls to TouchSetBuffer ineffective. After an initial call to TouchSetBuffer calls to TouchGetBuffer will always return the CPU allocated buffer.
		+	|-
		+	|}
		+	</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 RPi3TouchSetBuffer(Address:PtrUInt):LongWord;</pre>
		+	<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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,746:		Line 1,802:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3VirtualGPIOInputGet(Pin:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3VirtualGPIOGetBuffer(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 Virtual GPIO buffer from the Mailbox property tags channel</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,758:		Line 1,814:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3VirtualGPIOOutputSet(Pin,Level:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3VirtualGPIOSetBuffer(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:''' Set the Virtual GPIO buffer in the Mailbox property tags channel</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,770:		Line 1,826:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3VirtualGPIOFunctionSelect(Pin,Mode:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3CursorSetDefault:LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,781:		Line 1,837:
	</div></div>		</div></div>
	<br />		<br />
−
−	'''RPi3 thread functions'''
−
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3SchedulerInit;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3CursorSetInfo(Width,Height,HotspotX,HotspotY:LongWord; Pixels:Pointer; Length:LongWord):LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Initialize the scheduler interrupt on the boot CPU</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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,797:		Line 1,850:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3SchedulerStart(CPUID:LongWord);</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3CursorSetState(Enabled:Boolean; X,Y:LongWord; Relative:Boolean):LongWord;</pre>
−	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Initialize the scheduler interrupt on the specified secondary CPU</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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! 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 RPi3DMAGetChannels: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		| None documented
	|-		|-
Line 1,809:		Line 1,874:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3SecondaryBoot(CPUID:LongWord);</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3VirtualGPIOAllocate:Boolean;</pre>
		+	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Allocate the Virtual GPIO buffer either from memory or from the firmware</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 RPi3VirtualGPIOInputGet(Pin:LongWord):LongWord;</pre>
	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>		<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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,820:		Line 1,897:
	</div></div>		</div></div>
	<br />		<br />
−
−	'''RPi3 IRQ functions'''
−
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3DispatchIRQ(CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3VirtualGPIOOutputSet(Pin,Level:LongWord):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:''' To be documented</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
−	| Called by ARMv8IRQHandler in PlatformARMv8	+	| None documented
−	A DataMemoryBarrier is executed before and after calling this function	+
	|-		|-
	|}		|}
Line 1,837:		Line 1,910:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3HandleIRQ(Number,CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3VirtualGPIOFunctionSelect(Pin,Mode:LongWord):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:''' To be documented</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,849:		Line 1,922:
	<br />		<br />
−	'''RPi3 FIQ functions'''	+	'''RPi3 thread functions'''
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3DispatchFIQ(CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>	+	<pre style="border: 0; padding-bottom:0px;">procedure RPi3SchedulerInit;</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:''' Initialize the scheduler interrupt on the boot CPU</div>
	<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
−	| Called by ARMv8FIQHandler in PlatformARMv8	+	| None documented
−	A DataMemoryBarrier is executed before and after calling this function	+
	|-		|-
	|}		|}
Line 1,865:		Line 1,937:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3HandleFIQ(Number,CPUID:LongWord; Thread:TThreadHandle):TThreadHandle;</pre>	+	<pre style="border: 0; padding-bottom:0px;">procedure RPi3SchedulerStart(CPUID: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:''' Initialize the scheduler interrupt on the specified secondary CPU</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 RPi3SecondaryBoot(CPUID: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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,885:		Line 1,969:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| Called by ARMv8SoftwareInterruptHandler in PlatformARMv8		| Called by ARMv8SoftwareInterruptHandler in PlatformARMv8
	A DataMemoryBarrier is executed before and after calling this function		A DataMemoryBarrier is executed before and after calling this function
Line 1,901:		Line 1,985:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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 and checks for timers to trigger.		| This schedules another clock interrupt to occur CLOCK_CYCLES_PER_TICK in the future, then updates ClockTicks and ClockSeconds and checks for timers to trigger.
	|-		|-
Line 1,913:		Line 1,997:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Cycles'''	+	! Cycles
	| Number of cycles after which the timer interrupt is to be triggered		| 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		| This refers to native clock cycles as specified by CLOCK_FREQUENCY
	|-		|-
Line 1,931:		Line 2,015:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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 or timeout and the next thread to schedule.		| This schedules another scheduler interrupt to occur SCHEDULER_CLOCKS_PER_INTERRUPT in the future, then checks for threads to wakeup or timeout and the next thread to schedule.
	|-		|-
Line 1,943:		Line 2,027:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Cycles'''	+	! Cycles
	| Number of cycles after which the scheduler interrupt is to be triggered		| Number of cycles after which the scheduler interrupt is to be triggered
	|-		|-
−	! '''Note'''	+	! Note
	| This refers to native clock cycles as specified by RPI3_GENERIC_TIMER_FREQUENCY		| This refers to native clock cycles as specified by RPI3_GENERIC_TIMER_FREQUENCY
	|-		|-
Line 1,958:		Line 2,042:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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		| This is registered to receive requests for the SYSTEM_CALL_CONTEXT_SWITCH and will perform a context switch from within an SWI
	|-		|-
Line 1,973:		Line 2,057:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,985:		Line 2,069:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 1,997:		Line 2,081:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,009:		Line 2,093:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,016:		Line 2,100:
	<br />		<br />
	<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">		<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 RPi3FramebufferDeviceCommit(Framebuffer:PFramebufferDevice; Address,Size,Flags:LongWord):LongWord;</pre>	+	<pre style="border: 0; padding-bottom:0px;">function RPi3FramebufferDeviceCommit(Framebuffer:PFramebufferDevice; Address:PtrUInt; Size,Flags:LongWord):LongWord;</pre>
	<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>		<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;">		<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,033:		Line 2,117:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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 RPi3FramebufferDeviceSetProperties(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		| None documented
	|-		|-
Line 2,060:		Line 2,132:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,072:		Line 2,144:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,084:		Line 2,156:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,096:		Line 2,168:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,108:		Line 2,180:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,120:		Line 2,192:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| 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;">procedure RPi3BootOutput(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 RPi3BootConsoleStart;</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 RPi3BootConsoleWrite(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 RPi3BootConsoleWriteEx(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 RPi3BootConsoleGetX: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 RPi3BootConsoleGetY: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		| None documented
	|-		|-
Line 2,132:		Line 2,277:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,144:		Line 2,289:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,156:		Line 2,301:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,168:		Line 2,313:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,180:		Line 2,325:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,192:		Line 2,337:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,204:		Line 2,349:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-
Line 2,216:		Line 2,361:
	{| class="wikitable" style="font-size: 14px; background: white;"		{| class="wikitable" style="font-size: 14px; background: white;"
	|-		|-
−	! '''Note'''	+	! Note
	| None documented		| None documented
	|-		|-

---

Latest revision as of 05:09, 23 November 2022

Return to Unit Reference

Description

---

Ultibo Platform Interface unit for Raspberry Pi 3

The RPi3 B has the Activity LED connected to the GPU, access is via a Virtual GPIO (Power LED is only accessible via the GPIO expander driver).

The RPi3 B+ has the Activity LED connected to GPIO Pin 29 (Power LED is only accessible via the GPIO expander driver).

Constants

---

Type definitions

---

None defined

Public variables

---

RPi3 specific Ultibo variables

RPi3Initialized:Boolean;

RPi3CNTVOFFLow:LongWord = 0;

The low 32 bits of the Virtual Counter Offset register at boot time (CPU0 only) (Set by Startup). Must be initialized to remain in .data or else rewritten to zero with .bss

RPi3CNTVOFFHigh:LongWord = 0;

The high 32 bits of the Virtual Counter Offset register at boot time (CPU0 only) (Set by Startup). Must be initialized to remain in .data or else rewritten to zero with .bss

Timer variables

TimerRegisters:PBCM2837SystemTimerRegisters;

Mailbox variables

Mailbox0Registers:PBCM2837Mailbox0Registers;

Mailbox1Registers:PBCM2837Mailbox1Registers;

Interrupt variables

InterruptRegisters:PBCM2837InterruptRegisters;

InterruptEntries:array[0..(BCM2837_GPU_IRQ_COUNT + BCM2837_ARM_IRQ_COUNT - 1)] of PInterruptEntry;

LocalInterruptEntries:array[RPI3_IRQ_LOCAL_START..(BCM2837_IRQ_COUNT - 1),0..(RPI3_CPU_COUNT - 1)] of PInterruptEntry;

System call

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

IRQ/FIQ

IRQEnabled:array[0..2] of LongWord;

3 groups of IRQs to Enable/Disable (See: TBCM2837InterruptRegisters)

FIQEnabled:LongWord;

The single IRQ number to Enable as FIQ instead (See: TBCM2837InterruptRegisters)

LocalIRQEnabled:array[0..(RPI3_CPU_COUNT - 1)] of LongWord;

1 group of local IRQs to Enable/Disable per CPU (See: TBCM2837ARMLocalRegisters)

LocalFIQEnabled:array[0..(RPI3_CPU_COUNT - 1)] of LongWord;

1 group of local FIQs to Enable/Disable per CPU (See: TBCM2837ARMLocalRegisters)

Watchdog variables

WatchdogRegisters:PBCM2837PMWatchdogRegisters;

ARM local

ARMLocalRegisters:PBCM2837ARMLocalRegisters;

Virtual GPIO

VirtualGPIOBuffer:TBCM2837VirtualGPIOBuffer;

Function declarations

---

Initialization functions

RPi3 platform functions

RPi3 thread functions

RPi3 SWI functions

RPi3 clock functions

RPi3 scheduler functions

RPi3 framebuffer functions

RPi3 helper functions

Return to Unit Reference