Difference between revisions of "Unit BCM2710"

Latest revision as of 03:47, 5 September 2023

Both devices support 3 chip selects, by default SPI1 is available on GPIO pins 16 to 21 (CS2, CS1, CS0, MISO, MOSI, SCLK) using alternate function 4 and SPI2 is available on GPIO pins 40 to 45 (MISO, MOSI, SCLK, CS0, CS1, CS2) using alternate function 4. Only pins 16 to 21 are available on the header and only on the 40 pin header of the Raspberry Pi A+/B+/Zero/2B/3B.

BCM2710 SPI/I2C Slave Device

The slave device can be used as either an I2C or an SPI interface, the I2C slave supports 400KHz fast mode operation. Only 7 bit addressing is supported, DMA is not supported and neither is clock stretching.

Note: On the Raspberry Pi A+/B+/Zero/2B/3B the SPI slave device is apparently faulty and cannot be used.

The I2C Slave device can only appear on GPIO pins 18 (SDA) and 19 (SCL) (Alternate function 3).

BCM2710 DMA Device

The DMA controller has 16 channels in total although not all are available for software to use as some are already used by the GPU.

The firmware will pass the value dma.dmachans on the command line which will indicate which channels are available for our use.

Channels 0 to 6 are normal channels which support 2D stride and transfers up to 1GB per control block

Channels 7 to 14 are Lite channels which do not support stride and only allow transfers up to 64KB per control block

Channel 15 is not mentioned in most documentation and is shown as not available in the mask passed in dma.dmachans

Channel 0 and 15 are Bulk channels which have an additional FIFO for faster transfers (8 beat burst per read)

BCM2710 PWM0/1 Device

The BCM2710 has a single PWM controller with 2 independent output bit streams with multiple algorithms for generating the output pulse. The PWM controller supports either a single data register (independent per channel) or a 16 x 32 FIFO which also supports DMA mode transmission.

On the Raspberry Pi PWM0 and PWM1 are also connected via GPIO pins 40 and 45 (40 and 41 on the Raspberry Pi 3B) to the audio circuit and allow playback of digital audio signals via the 3 or 4 pole line jack (depending on model).

PWM0 is available on GPIO pins 12 (function 0), 18 (function 5), 40 (function 0) and 52 (function 1).

PWM1 is available on GPIO pins 13 (function 0), 19 (function 5), 41, 45 (function 0) and 53 (function 1).

On the Raspberry Pi A and B only pin 18 is exposed on the 26 pin header.

On the Raspberry Pi A+/B+/Zero/2B/3B pins 12, 13, 18 and 19 are exposed on the 40 pin header.

BCM2710 GPIO Device

The GPIO has 54 pins available each with multiple alternate functions. All pins can be configured as input or output and all can have pull up or down applied.

Not all pins are exposed on the 26 or 40 pin header of the Raspberry Pi, for details of which pins are available see:

Raspberry Pi A and B - https://www.raspberrypi.org/documentation/usage/gpio/README.md

Raspberry Pi A+/B+/2B/3B/Zero - https://www.raspberrypi.org/documentation/usage/gpio-plus-and-raspi2/README.md

Some of the 54 pins are used for peripheral communication (such as the SD card) and are not available for general use, take care when changing function selects on pins to avoid disabling certain system peripherals.

Event detection can be enabled for both high and low levels as well as rising and falling edges, there is also an asynchronous rising or falling edge detection which can detect edges of very short duration.

BCM2710 UART0 Device

The UART0 device is an ARM PL011 UART which supports programmable baud rates, start, stop and parity bits and hardware flow control and many others. The UART0 is similar to the industry standard 16C650 but with a number of differences, the PL011 has some optional features such as IrDA, Serial InfraRed and DMA which are not supported by the Broadcom implementation. In the standard configuration the UART0 TX and RX lines are connected to GPIO pins 14 and 15 respectively (Alternate function 0) but they can be remapped via GPIO function selects to a number of other locations. On the Raspberry Pi (all models) none of these alternate pin mappings are exposed via the 26 or 40 pin header and therefore cannot be used easily. This means that UART0 and UART1 cannot be used at the same time.

On the Raspberry Pi 3B the UART0 can be mapped to GPIO pins 32 and 33 (Alternate function 3) to communicate with the built in Bluetooth module.

BCM2710 UART1 Device

The UART1 device is a Broadcom implementation that is part of the AUX device which also includes the SPI1 and SPI2 devices. This device is termed a Mini UART and has a smaller feature set than the PL011 UART but still supports a fairly standard communication protocol with programmable baud rate and hardware flow control.

The Mini UART is similar to the standard 16550 device but is missing some of the features, the device also has no DMA support so high speed transfers will produce a higher CPU load. In the standard configuration the UART1 TX and RX lines are connected to GPIO pins 14 and 15 respectively (Alternate function 5) but they can be remapped via GPIO function selects to a number of other locations. On the Raspberry Pi (all models) none of these alternate pin mappings are exposed via the 26 or 40 pin header and therefore cannot be used easily. This means that UART0 and UART1 cannot be used at the same time.

On the Raspberry Pi 3B the UART1 can be mapped to GPIO pins 32 and 33 (Alternate function 5) to communicate with the built in Bluetooth module.

BCM2710 SDHCI Device

The SDHCI controller on the BCM2710 is an Arasan SD Host controller.

The Card Detect pin is not connected.

The Write Protect pin is not connected.

The device can be routed to GPIO pins 22 to 27 (ALT3) or 48 to 53 (ALT3), it can also be routed to GPIO pins 34 to 39 (ALT3) to provide an SDIO controller for the on board WiFi.

BCM2710 SDHOST Device

The SDHOST controller on the BCM2710 is a non SDHCI-compliant device which requires a specific driver.

It can be routed to GPIO pins 22 to 27 (ALT0) or 48 to 53 (ALT0) in order to control the SD card slot when the SDHCI device is being used for the on board WiFi.

Note: The actual driver is implemented in the BCMSDHOST unit

BCM2710 Clock (System Timer) Device

The clock device in the BCM2710 is based on the System Timer which is a 64 bit free running counter that runs at 1MHz regardless of core or CPU clock speeds.

The System Timer includes 4 compare registers which can each generate an interrupt when the compare value is matched, however 2 of the 4 are consumed by the GPU and on the Raspberry Pi A/B/A+/B+/Zero the other 2 are used for the scheduler and clock interrupts in Ultibo.

This device simply exposes the free running counter as a clock value and does not provide access to the timer compare functionality or to interrupt based events, for those see the timer devices below.

BCM2710 ARM Timer Device

The ARM Timer device in the BCM2710 is based on the ARM SP804 timer with some modifications and additions. In the Raspberry Pi it is connected to the core clock which by default is 250MHz but was increased to 400MHz on the Raspberry Pi 3B.

The divider is 10 bits wide which means that the ARM Timer can be set to clock rates of between 250KHz and 250MHz (or 400KHz to 400MHz on the Raspberry Pi 3B). Both the counter and the load/reload value are 32 bits wide by default giving a wide range of tick intervals.

The ARM Timer features a free running counter which is not enabled or used by this driver and a down counter which operates in wrapping mode so that each time it reaches 0 it triggers an interrupt and reloads the value from a load or reload register to begin counting again.

@@ Line 4: / Line 4: @@
 === Description ===
 ----
+'''Ultibo BCM2710 Interface unit'''
 This unit provides the BCM2710 specific implementations of the following devices:
@@ Line 10: / Line 12: @@
 *I2C0
 *I2C1
+*I2C2
 *SPI1
 *SPI2
@@ Line 42: / Line 45: @@
 By default SPI0 can appear on GPIO pins 7 to 11 (CS1, CS0, MISO, MOSI, SCLK) using alternate function 0 or on GPIO pins 35 to 39 (CS1, CS0, MISO, MOSI, SCLK) using alternate function 0, only pins 7 to 11 are available on the header.
-'''BCM2710 I2C0/1 Device'''
+'''BCM2710 I2C0/1/2 Device'''
 The BCM2710 has 3 Broadcom Serial Controller (BSC) devices which are fast mode (400Kz) masters numbered BSC0, BSC1 and BSC2.
-Device BSC2 is dedicated to the HDMI interface and is not availale for use by the ARM processor. All BSC devices contain a 16 byte FIFO, support 7 bit and 10 bit addressing and have software configurable clock timing.
+Device BSC2 is dedicated to the HDMI interface but can be accessed by the ARM processor for controlling some HDMI functionality. All BSC devices contain a 16 byte FIFO, support 7 bit and 10 bit addressing and have software configurable clock timing.
 By default BSC0 can appear on GPIO pins 0 and 1 (Alternate function 0), 28 and 29 (Alternate function 0) or 44 and 45 (Alternate function 1). Unfortunately on all except the Revision 1 models none of these pins are available on the 26 or 40 pin header.
@@ Line 59: / Line 62: @@
 Both devices support 3 chip selects, by default SPI1 is available on GPIO pins 16 to 21 (CS2, CS1, CS0, MISO, MOSI, SCLK) using alternate function 4 and SPI2 is available on GPIO pins 40 to 45 (MISO, MOSI, SCLK, CS0, CS1, CS2) using alternate function 4. Only pins 16 to 21 are available on the header and only on the 40 pin header of the Raspberry Pi A+/B+/Zero/2B/3B.
+'''BCM2710 SPI/I2C Slave Device'''
+The slave device can be used as either an I2C or an SPI interface, the I2C slave supports 400KHz fast mode operation. Only 7 bit addressing is supported, DMA is not supported and neither is clock stretching.
+Note: On the Raspberry Pi A+/B+/Zero/2B/3B the SPI slave device is apparently faulty and cannot be used.
+The I2C Slave device can only appear on GPIO pins 18 (SDA) and 19 (SCL) (Alternate function 3).
 '''BCM2710 DMA Device'''
@@ Line 86: / Line 97: @@
 On the Raspberry Pi A and B only pin 18 is exposed on the 26 pin header.
-On the Raspberry Pi A+/B+/Zero/2B/3B pins 12, 18 and 19 are exposed on the 40 pin header.
+On the Raspberry Pi A+/B+/Zero/2B/3B pins 12, 13, 18 and 19 are exposed on the 40 pin header.
 '''BCM2710 GPIO Device'''
@@ Line 104: / Line 115: @@
 '''BCM2710 UART0 Device'''
-The UART0 device is an ARM PL011 UART which supports programmable baud rates, start, stop and parity bits and hardware flow control and many others. The UART0 is similar to the industry standard 16C650 but with a number of differences, the PL011 has a some optional features such as IrDA, Serial InfraRed and DMA which are not supported by the Broadcom implementation. In the standard configuration the UART0 TX and RX lines are connected to GPIO pins 14 and 15 respectively (Alternate function 0) but they can be remapped via GPIO function selects to a number of other locations. On the Raspberry Pi (all models) none of these alternate pin mappings are exposed via the 26 or 40 pin header and therefore cannot be used easily. This means that UART0 and UART1 cannot be used at the same time.
+The UART0 device is an ARM PL011 UART which supports programmable baud rates, start, stop and parity bits and hardware flow control and many others. The UART0 is similar to the industry standard 16C650 but with a number of differences, the PL011 has some optional features such as IrDA, Serial InfraRed and DMA which are not supported by the Broadcom implementation. In the standard configuration the UART0 TX and RX lines are connected to GPIO pins 14 and 15 respectively (Alternate function 0) but they can be remapped via GPIO function selects to a number of other locations. On the Raspberry Pi (all models) none of these alternate pin mappings are exposed via the 26 or 40 pin header and therefore cannot be used easily. This means that UART0 and UART1 cannot be used at the same time.
 On the Raspberry Pi 3B the UART0 can be mapped to GPIO pins 32 and 33 (Alternate function 3) to communicate with the built in Bluetooth module.
@@ Line 124: / Line 135: @@
 The Write Protect pin is not connected.
-'''BCM2710 Clock Device'''
+The device can be routed to GPIO pins 22 to 27 (ALT3) or 48 to 53 (ALT3), it can also be routed to GPIO pins 34 to 39 (ALT3) to provide an SDIO controller for the on board WiFi.
+'''BCM2710 SDHOST Device'''
+The SDHOST controller on the BCM2710 is a non SDHCI-compliant device which requires a specific driver.
+It can be routed to GPIO pins 22 to 27 (ALT0) or 48 to 53 (ALT0) in order to control the SD card slot when the SDHCI device is being used for the on board WiFi.
+Note: The actual driver is implemented in the BCMSDHOST unit
+'''BCM2710 Clock (System Timer) Device'''
 The clock device in the BCM2710 is based on the System Timer which is a 64 bit free running counter that runs at 1MHz regardless of core or CPU clock speeds.
@@ Line 138: / Line 159: @@
 The divider is 10 bits wide which means that the ARM Timer can be set to clock rates of between 250KHz and 250MHz (or 400KHz to 400MHz on the Raspberry Pi 3B). Both the counter and the load/reload value are 32 bits wide by default giving a wide range of tick intervals.
-The ARM Timer features a free running counter which is not enabled or used by this driver and a down counter which operates in wrapping mode so that each time it reaches 0 it triggers an interrupt and reloads the value ?rom a load or reload register to begin counting again.
+The ARM Timer features a free running counter which is not enabled or used by this driver and a down counter which operates in wrapping mode so that each time it reaches 0 it triggers an interrupt and reloads the value from a load or reload register to begin counting again.
 === Constants ===
 ----
-''To be documented''
+<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;">'''BCM2710 SPI0''' <code> BCM2710_SPI0_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_SPI0_DESCRIPTION = 'BCM2837 SPI0 Master';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_SPI0_MAX_SIZE = $FFFF;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_SPI0_MIN_CLOCK = 3814;</code>
+| Default minimum based on the default settings from the firmware (Recalculated during open)
+|-
+| <code>BCM2710_SPI0_MAX_CLOCK = 125000000;</code>
+| Default maximum based on the default settings from the firmware (Recalculated during open)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_SPI0_MIN_DIVIDER = 2;</code>
+| Divider is always rounded down to an even number and a value of 0 sets the divider to 65536
+|-
+| <code>BCM2710_SPI0_MAX_DIVIDER = $FFFE;</code>
+| Divider is always rounded down to an even number
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_SPI0_CORE_CLOCK = 250000000;</code>
+| Default core clock based on the default settings from the firmware (Requested from firmware during start)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_SPI0_MODE_IRQ = 0;</code>
+| &nbsp;
+|-
+| <code>BCM2710_SPI0_MODE_DMA = 1;</code>
+| &nbsp;
+|-
+| <code>BCM2710_SPI0_MODE_PIO = 2;</code>
+| &nbsp;
+|-
+|}
+</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;">'''BCM2710 BSCI2C (BSC0/1/2)''' <code> BCM2710_BSCI2C_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_BSCI2C_MAX_SIZE = $FFFF;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_BSCI2C_MIN_CLOCK = 3814;</code>
+| Default minimum based on the default settings from the firmware (Recalculated during open)
+|-
+| <code>BCM2710_BSCI2C_MAX_CLOCK = 125000000;</code>
+| Default maximum based on the default settings from the firmware (Recalculated during open)
+|-
+| <code>BCM2710_BSCI2C_DEFAULT_CLOCK = 100000; </code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_BSCI2C_MIN_DIVIDER = 2;</code>
+| Divider is always rounded down to an even number and a value of 0 sets the divider to 32768
+|-
+| <code>BCM2710_BSCI2C_MAX_DIVIDER = $FFFE;</code>
+| Divider is always rounded down to an even number
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_BSCI2C_CORE_CLOCK = 250000000;</code>
+| Default core clock based on the default settings from the firmware (Requested from firmware during start)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_BSCI2C_MODE_WRITE = 0;</code>
+| &nbsp;
+|-
+| <code>BCM2710_BSCI2C_MODE_READ = 1;</code>
+| &nbsp;
+|-
+|}
+</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;">'''BCM2710 I2C0 (BSC0)''' <code> BCM2710_I2C0_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_I2C0_DESCRIPTION = 'BCM2837 BSC0 Master I2C';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 I2C1 (BSC1)''' <code> BCM2710_I2C1_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_I2C1_DESCRIPTION = 'BCM2837 BSC1 Master I2C';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 I2C2 (BSC2)''' <code> BCM2710_I2C2_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_I2C2_DESCRIPTION = 'BCM2837 BSC2 Master I2C';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 SPI1''' <code> BCM2710_SPI1_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_SPI1_DESCRIPTION = 'BCM2837 AUX SPI1 Master';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 SPI2''' <code> BCM2710_SPI2_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_SPI2_DESCRIPTION = 'BCM2837 AUX SPI2 Master';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 I2C slave''' <code> BCM2710_I2CSLAVE_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_I2CSLAVE_DESCRIPTION = 'BCM2837 I2C Slave';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_I2CSLAVE_TIMEOUT = 10;</code>
+| Timeout (Milliseconds) for RX/TX wait data
+|-
+| <code>BCM2710_I2CSLAVE_BUFFER_SIZE = 1024;</code>
+| Size in bytes of the RX/TX data buffer
+|-
+| <code>BCM2710_I2CSLAVE_RX_POLL_LIMIT = 256;</code>
+| Number of times interrupt handler may poll the read FIFO
+|-
+|}
+</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;">'''BCM2710 SPI slave''' <code> BCM2710_SPISLAVE_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_SPISLAVE_DESCRIPTION = 'BCM2837 SPI Slave';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 DMA''' <code> BCM2710_DMA_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_DMA_DESCRIPTION = 'BCM2837 DMA';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_CHANNEL_COUNT = 16;</code>
+| Total number of DMA channels (Not all are usable)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_LITE_CHANNELS = $7F80;</code>
+| Mask of DMA Lite channels (7 to 14)
+|-
+| <code>BCM2710_DMA_NORMAL_CHANNELS = $007E;</code>
+| (807F) Mask of normal channels (1 to 6)
+|-
+| <code>BCM2710_DMA_BULK_CHANNELS = $8001;</code>
+| Mask of DMA Bulk channels (0 and 15)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_SHARED_CHANNELS = $7800;</code>
+| Mask of channels with shared interrupt (11 to 14)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_MAX_LITE_TRANSFER = 65536;</code>
+| Maximum transfer length for a DMA Lite channel
+|-
+| <code>BCM2710_DMA_MAX_NORMAL_TRANSFER = 1073741824;</code>
+| Maximum transfer length for a normal channel
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_MAX_STRIDE = $FFFF;</code>
+| Maximum stride value (Increment between rows) (Note this is a signed value (Min -32768/Max 32767)
+|-
+| <code>BCM2710_DMA_MAX_Y_COUNT = $3FFF;</code>
+| Maximum number of X length transfers in 2D stride
+|-
+| <code>BCM2710_DMA_MAX_X_LENGTH = $FFFF;</code>
+| Maximum X transfer length in 2D stride
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_CB_ALIGNMENT = 32;</code>
+| Alignment required for DMA control blocks
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_DMA_LITE_BURST_LENGTH = 2;</code>
+| Burst length for DMA Lite channels
+|-
+| <code>BCM2710_DMA_NORMAL_BURST_LENGTH = 4;</code>
+| Burst length for normal channels
+|-
+| <code>BCM2710_DMA_BULK_BURST_LENGTH = 16;</code>
+| Burst length for DMA Bulk channels
+|-
+|}
+</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;">'''BCM2710 PWM''' <code> BCM2710_PWM_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_PWM_MIN_PERIOD = 108;</code>
+| Default based on 19.2MHz PWM clock (Oscillator source)
+|-
+| <code>BCM2710_PWM_DEFAULT_CLOCK = 19200000;</code>
+| Default to the 19.2MHz oscillator clock
+|-
+|}
+</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;">'''BCM2710 PWM0''' <code> BCM2710_PWM0_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_PWM0_DESCRIPTION = 'BCM2837 PWM0';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 PWM1''' <code> BCM2710_PWM1_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_PWM1_DESCRIPTION = 'BCM2837 PWM1';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 GPIO''' <code> BCM2710_GPIO_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_GPIO_DESCRIPTION = 'BCM2837 GPIO';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_GPIO_MIN_PIN = GPIO_PIN_0;</code>
+| &nbsp;
+|-
+| <code>BCM2710_GPIO_MAX_PIN = GPIO_PIN_53;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_GPIO_MAX_LEVEL = GPIO_LEVEL_HIGH;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_GPIO_MAX_PULL = GPIO_PULL_DOWN;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_GPIO_MIN_FUNCTION = GPIO_FUNCTION_IN;</code>
+| &nbsp;
+|-
+| <code>BCM2710_GPIO_MAX_FUNCTION = GPIO_FUNCTION_ALT5;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_GPIO_MIN_TRIGGER = GPIO_TRIGGER_LOW;</code>
+| &nbsp;
+|-
+| <code>BCM2710_GPIO_MAX_TRIGGER = GPIO_TRIGGER_ASYNC_FALLING;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+|colspan="2"|''GPIO pull up/down to BCM2837 pull up/down''
+|-
+|colspan="2"|<code>BCM2710_GPIO_PULL_MAP:array[GPIO_PULL_NONE..GPIO_PULL_DOWN] of LongWord = (</code>
+|-
+| <code>BCM2837_GPPUD_NONE,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPPUD_UP,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPPUD_DOWN);</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+|colspan="2"|''GPIO functions to BCM2837 functions''
+|-
+|colspan="2"|<code>BCM2710_GPIO_FUNCTION_MAP:array[BCM2710_GPIO_MIN_FUNCTION..BCM2710_GPIO_MAX_FUNCTION] of LongWord = (</code>
+|-
+| <code>BCM2837_GPFSEL_IN,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_OUT,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_ALT0,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_ALT1,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_ALT2,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_ALT3,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_ALT4,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFSEL_ALT5);</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+|colspan="2"|''BCM2837 functions to GPIO functions''
+|-
+|colspan="2"|<code>BCM2710_GPIO_FUNCTION_UNMAP:array[BCM2710_GPIO_MIN_FUNCTION..BCM2710_GPIO_MAX_FUNCTION] of LongWord = (</code>
+|-
+| <code>GPIO_FUNCTION_IN,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_OUT,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_ALT5,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_ALT4,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_ALT0,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_ALT1,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_ALT2,</code>
+| &nbsp;
+|-
+| <code>GPIO_FUNCTION_ALT3);</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+|colspan="2"|''GPIO triggers to BCM2837 event registers''
+|-
+|colspan="2"|<code>BCM2710_GPIO_TRIGGER_MAP:array[BCM2710_GPIO_MIN_TRIGGER..BCM2710_GPIO_MAX_TRIGGER] of LongWord = (</code>
+|-
+| <code>BCM2837_GPLEN0,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPHEN0,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPREN0,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPFEN0,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPAREN0,</code>
+| &nbsp;
+|-
+| <code>BCM2837_GPAFEN0);</code>
+| &nbsp;
+|-
+|}
+</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;">'''BCM2710 UART0 (PL011)''' <code> BCM2710_UART0_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_UART0_DESCRIPTION = 'BCM2837 PL011 UART';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_MIN_BAUD = 300;</code>
+| Default minimum of 300 baud
+|-
+| <code>BCM2710_UART0_MAX_BAUD = 187500;</code>
+| Default maximum based on the default settings from the firmware (Recalculated during open)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_MIN_DATABITS = SERIAL_DATA_5BIT;</code>
+| &nbsp;
+|-
+| <code>BCM2710_UART0_MAX_DATABITS = SERIAL_DATA_8BIT;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_MIN_STOPBITS = SERIAL_STOP_1BIT;</code>
+| &nbsp;
+|-
+| <code>BCM2710_UART0_MAX_STOPBITS = SERIAL_STOP_2BIT;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_MAX_PARITY = SERIAL_PARITY_EVEN;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_MAX_FLOW = SERIAL_FLOW_RTS_CTS;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_CLOCK_RATE = 3000000;</code>
+| Default clock rate based on the default settings from the firmware (Requested from firmware during open)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_UART0_RX_POLL_LIMIT = 256;</code>
+| Number of times interrupt handler may poll the read FIFO
+|-
+| <code>BCM2710_UART0_RX_BUFFER_SIZE = 1024;</code>
+| &nbsp;
+|-
+|}
+</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;">'''BCM2710 UART1 (AUX)''' <code> BCM2710_UART1_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_UART1_DESCRIPTION = 'BCM2837 AUX (Mini) UART';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 SDHCI''' <code> BCM2710_EMMC_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_EMMC_DESCRIPTION = 'BCM2837 Arasan SD Host';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_EMMC_MIN_FREQ = 400000;</code>
+| Default minimum of 400KHz
+|-
+| <code>BCM2710_EMMC_MAX_FREQ = 200000000;</code>
+| Default clock rate based on the default settings from the firmware (Requested from firmware during start)
+|-
+|}
+</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;">'''BCM2710 SDHOST''' <code> BCM2710_SDHOST_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_SDHOST_DESCRIPTION = 'BCM2837 SDHOST';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_SDHOST_MIN_FREQ = 400000;</code>
+| Default minimum of 400KHz
+|-
+| <code>BCM2710_SDHOST_MAX_FREQ = 250000000;</code>
+| Default clock rate based on the default settings from the firmware (Requested from firmware during start)
+|-
+|colspan="2"|See: BCMSDHOST for the driver implementation
+|-
+|}
+</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;">'''BCM2710 clock (system timer)''' <code> BCM2710_SYS_CLOCK_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_SYS_CLOCK_DESCRIPTION = 'BCM2837 System Timer Clock';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 clock (ARM timer)''' <code> BCM2710_ARM_CLOCK_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_ARM_CLOCK_DESCRIPTION = 'BCM2837 ARM Timer Clock';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_CLOCK_MIN_RATE = 976562;</code>
+| Default minimum (Divider 255) based on the default settings from the firmware (Recalculated during start)
+|-
+| <code>BCM2710_ARM_CLOCK_MAX_RATE = 250000000;</code>
+| Default maximum (Divider 0) based on the default settings from the firmware (Recalculated during start)
+|-
+| <code>BCM2710_ARM_CLOCK_DEFAULT_RATE = 3968253;</code>
+| Default rate (Divider 62) based on the default settings from the firmware (Recalculated during start)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_CLOCK_MIN_DIVIDER = 0;</code>
+| &nbsp;
+|-
+| <code>BCM2710_ARM_CLOCK_MAX_DIVIDER = 255;</code>
+| &nbsp;
+|-
+| <code>BCM2710_ARM_CLOCK_DEFAULT_DIVIDER = 62;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_CLOCK_CORE_CLOCK = 250000000;</code>
+| Default core clock based on the default settings from the firmware (Requested from firmware during start)
+|-
+|}
+</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;">'''BCM2710 clock (local timer)''' <code> BCM2710_LOCAL_CLOCK_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_LOCAL_CLOCK_DESCRIPTION = 'BCM2837 Local Timer Clock';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 ARM timer''' <code> BCM2710_ARM_TIMER_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_ARM_TIMER_DESCRIPTION = 'BCM2837 ARM Timer';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_MIN_RATE = 244140;</code>
+| Default minimum (Divider 1023) based on the default settings from the firmware (Recalculated during start)
+|-
+| <code>BCM2710_ARM_TIMER_MAX_RATE = 250000000;</code>
+| Default maximum (Divider 0) based on the default settings from the firmware (Recalculated during start)
+|-
+| <code>BCM2710_ARM_TIMER_DEFAULT_RATE = 1000000;</code>
+| Default rate (Divider 249) based on the default settings from the firmware (Recalculated during start)
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_MIN_INTERVAL = 1;</code>
+| &nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_MAX_INTERVAL = $FFFFFFFF;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_MIN_DIVIDER = 0;</code>
+| &nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_MAX_DIVIDER = 1023;</code>
+| &nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_DEFAULT_DIVIDER = 249;</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_ARM_TIMER_CORE_CLOCK = 250000000;</code>
+| Default core clock based on the default settings from the firmware (Requested from firmware during start)
+|-
+|}
+</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;">'''BCM2710 local timer''' <code> BCM2710_LOCAL_TIMER_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_LOCAL_TIMER_DESCRIPTION = 'BCM2837 Local Timer';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 random''' <code> BCM2710_RANDOM_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_RANDOM_DESCRIPTION = 'BCM2837 Random Number Generator';</code>
+| &nbsp;
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>BCM2710_RANDOM_WARMUP_COUNT = $00040000;</code>
+| The initial numbers generated are "less random" so will be discarded
+|-
+|}
+</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;">'''BCM2710 mailbox''' <code> BCM2710_MAILBOX_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_MAILBOX_DESCRIPTION = 'BCM2837 Mailbox';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 watchdog''' <code> BCM2710_WATCHDOG_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_WATCHDOG_DESCRIPTION = 'BCM2837 Watchdog Timer';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</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;">'''BCM2710 framebuffer''' <code> BCM2710_FRAMEBUFFER_* </code></div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>BCM2710_FRAMEBUFFER_DESCRIPTION = 'BCM2837 Framebuffer';</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</div></div>
+<br />
 === Type definitions ===
 ----
-''To be documented''
+'''BCM2710 SPI0'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710SPI0Device = ^TBCM2710SPI0Device;</code>
+<code>TBCM2710SPI0Device = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''SPI Properties''
+|-
+| <code>SPI:TSPIDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>Address:Pointer;</code>
+| Device register base address
+|-
+| <code>CoreClock:LongWord;</code>
+| Core clock rate
+|-
+|colspan="2"|''Transfer Properties''
+|-
+| <code>Mode:LongWord;</code>
+| Mode of current transfer (BCM2710_SPI0_MODE_IRQ/BCM2710_SPI0_MODE_DMA / BCM2710_SPI0_MODE_PIO)
+|-
+| <code>Source:Pointer;</code>
+| Pointer to the source for current transfer (nil if reading only)
+|-
+| <code>Dest:Pointer;</code>
+| Pointer to the destination for current transfer (nil if writing only)
+|-
+| <code>Count:LongWord;</code>
+| Count of bytes for current transfer
+|-
+| <code>SourceRemain:LongWord;</code>
+| Source bytes remaining for current transfer
+|-
+| <code>DestRemain:LongWord;</code>
+| Destination bytes remaining for current transfer
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 BSCI2C (I2C0/1/2)'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710BSCI2CDevice = ^TBCM2710BSCI2CDevice;</code>
+<code>TBCM2710BSCI2CDevice = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''I2C Properties''
+|-
+| <code>I2C:TI2CDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>Address:Pointer;</code>
+| Device register base address
+|-
+| <code>CoreClock:LongWord;</code>
+| Core clock rate
+|-
+| <code>SDAPin:LongWord;</code>
+| GPIO pin for the SDA line
+|-
+| <code>SCLPin:LongWord;</code>
+| GPIO pin for the SCL line
+|-
+| <code>SDAFunction:LongWord;</code>
+| GPIO function for the SDA line
+|-
+| <code>SCLFunction:LongWord;</code>
+| GPIO function for the SCL line
+|-
+|colspan="2"|''Transfer Properties''
+|-
+| <code>Index:LongWord;</code>
+| Index of this device in the IRQData array (Set during device initialization)
+|-
+| <code>Mode:LongWord;</code>
+| Mode of current transfer (BCM2710_BSCI2C_MODE_WRITE/BCM2710_BSCI2C_MODE_READ)
+|-
+| <code>Data:Pointer;</code>
+| Pointer to the data for current transfer
+|-
+| <code>Count:LongWord;</code>
+| Count of bytes for current transfer
+|-
+| <code>Remain:LongWord;</code>
+| Bytes remaining for current transfer
+|-
+| <code>Error:LongBool;</code>
+| True if an error occurred during the transfer
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 BSCI2C (I2C0/1) IRQ data'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710BSCI2CIRQData = ^TBCM2710BSCI2CIRQData;</code>
+<code>TBCM2710BSCI2CIRQData = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|Note: BSC I2C devices share a single interrupt
+|-
+| <code>Count:LongWord;</code>
+| style="width: 50%;"|&nbsp;
+|-
+| <code>Lock:TSpinHandle;</code>
+| &nbsp;
+|-
+| <code>Devices:array[0..2] of PBCM2710BSCI2CDevice;</code>
+| &nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 SPI AUX (SPI1/2)'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710SPIAUXDevice = ^TBCM2710SPIAUXDevice;</code>
+<code>TBCM2710SPIAUXDevice = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''SPI Properties''
+|-
+| <code>SPI:TSPIDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>Address:Pointer;</code>
+| Device register base address
+|-
+| <code>CoreClock:LongWord;</code>
+| Core clock rate
+|-
+|}
+</div></div>
+'''BCM2710 I2C slave buffer'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710I2CSlaveBuffer = ^TBCM2710I2CSlaveBuffer;</code>
+<code>TBCM2710I2CSlaveBuffer = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>Wait:TSemaphoreHandle;</code>
+| Data ready semaphore
+|-
+| <code>Start:LongWord;</code>
+| Index of first available buffer entry
+|-
+| <code>Count:LongWord;</code>
+| Number of available entries in the buffer
+|-
+| <code>Buffer:array[0..(BCM2710_I2CSLAVE_BUFFER_SIZE - 1)] of Byte;</code>
+| &nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 I2C slave'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710I2CSlave = ^TBCM2710I2CSlave;</code>
+<code>TBCM2710I2CSlave = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''I2C Properties''
+|-
+| <code>I2C:TI2CDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>IRQ:LongWord;</code>
+| IRQ of this device
+|-
+| <code>Address:Pointer;</code>
+| Device register base address
+|-
+| <code>Lock:TSpinHandle;</code>
+| Device lock (Differs from lock in I2C device) (Spin lock due to use by interrupt handler)
+|-
+| <code>SDAPin:LongWord;</code>
+| GPIO pin for the SDA line
+|-
+| <code>SCLPin:LongWord;</code>
+| GPIO pin for the SCL line
+|-
+| <code>SDAFunction:LongWord;</code>
+| GPIO function for the SDA line
+|-
+| <code>SCLFunction:LongWord;</code>
+| GPIO function for the SCL line
+|-
+|colspan="2"|''Transfer Properties''
+|-
+| <code>Receive:TBCM2710I2CSlaveBuffer;</code>
+| Receive Data Buffer
+|-
+| <code>Transmit:TBCM2710I2CSlaveBuffer;</code>
+| Transmit Data Buffer
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 DMA channel'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710DMAChannel = ^TBCM2710DMAChannel;</code>
+<code>TBCM2710DMAChannel = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>Host:PBCM2710DMAHost;</code>
+| DMA host this channel belongs to
+|-
+| <code>Request:PDMARequest;</code>
+| Current DMA request pending on this channel (or nil of no request is pending)
+|-
+| <code>Number:LongWord;</code>
+| The channel number of this channel
+|-
+| <code>Interrupt:LongWord;</code>
+| The interrupt number of this channel
+|-
+| <code>Registers:PBCM2837DMARegisters;</code>
+| The channel registers for configuration
+|-
+|}
+</div></div>
+'''BCM2710 DMA'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710DMAHost = ^TBCM2710DMAHost;</code>
+<code>TBCM2710DMAHost = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''DMA Properties''
+|-
+| <code>DMA:TDMAHost;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>ChannelMask:LongWord;</code>
+| Mask of available channels (Passed from GPU firmware)
+|-
+| <code>ChannelFree:LongWord;</code>
+| Bitmap of current free channels
+|-
+| <code>ChannelLock:TMutexHandle;</code>
+| Lock for access to ChannelFree
+|-
+| <code>ChannelWait:TSemaphoreHandle;</code>
+| Number of free normal channels in ChannelFree
+|-
+| <code>ChannelLite:TSemaphoreHandle;</code>
+| Number of free DMA Lite channels in ChannelFree
+|-
+| <code>ChannelBulk:TSemaphoreHandle;</code>
+| Number of free DMA Bulk channels in ChannelFree
+|-
+| <code>Channels:array[0..BCM2710_DMA_CHANNEL_COUNT - 1] of TBCM2710DMAChannel;</code>
+| Channel information for each DMA channel on the host
+|-
+| <code>EnableRegister:PLongWord;</code>
+| &nbsp;
+|-
+| <code>InterruptRegister:PLongWord;</code>
+| &nbsp;
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the host controller
+|-
+|}
+</div></div>
+'''BCM2710 PWM device'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710PWMDevice = ^TBCM2710PWMDevice;</code>
+<code>TBCM2710PWMDevice = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''PWM Properties''
+|-
+| <code>PWM:TPWMDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>Address:Pointer;</code>
+| Device register base address
+|-
+| <code>Channel:LongWord;</code>
+| Channel for this device
+|-
+| <code>Scaler:LongWord;</code>
+| Scaler for Duty cycle and Period
+|-
+| <code>Pair:PBCM2710PWMDevice;</code>
+| The paired PWM device for the other channel
+|-
+|colspan="2"|''Audio Properties''
+|-
+| <code>Audio:PBCM2710PWMAudio;</code>
+| The associated PWM Audio device
+|-
+|}
+</div></div>
+'''BCM2710 PWM audio'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710PWMAudio = ^TBCM2710PWMAudio;</code>
+<code>TBCM2710PWMAudio = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Audio Properties''
+|-
+| <code>Audio:TAudioDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''PWM Properties''
+|-
+| <code>PWM0:PBCM2710PWMDevice;</code>
+| The PWM device for channel 0
+|-
+| <code>PWM1:PBCM2710PWMDevice;</code>
+| The PWM device for channel 1
+|-
+|}
+</div></div>
+'''BCM2710 GPIO'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710GPIOBank = ^TBCM2710GPIOBank;</code>
+<code>TBCM2710GPIOBank = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+| <code>GPIO:PGPIODevice;</code>
+| style="width: 50%;"|&nbsp;
+|-
+| <code>Bank:LongWord;</code>
+| &nbsp;
+|-
+| <code>Address:PtrUInt;</code>
+| &nbsp;
+|-
+| <code>PinStart:LongWord;</code>
+| &nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 GPIO device'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710GPIODevice = ^TBCM2710GPIODevice;</code>
+<code>TBCM2710GPIODevice = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''GPIO Properties''
+|-
+| <code>GPIO:TGPIODevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>Lock:TSpinHandle;</code>
+| Device lock (Differs from lock in Device portion) (Spin lock due to use by interrupt handler)
+|-
+| <code>Banks:array[0..BCM2837_GPIO_BANK_COUNT - 1] of TBCM2710GPIOBank;</code>
+| &nbsp;
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 UART0'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710UART0Device = ^TBCM2710UART0Device;</code>
+<code>TBCM2710UART0Device = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''UART Properties''
+|-
+| <code>UART:TUARTDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>Address:Pointer;</code>
+| Device register base address
+|-
+| <code>ClockRate:LongWord;</code>
+| Device clock rate
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>Start:LongWord;</code>
+| Index of first available buffer entry
+|-
+| <code>Count:LongWord;</code>
+| Number of available entries in the buffer
+|-
+| <code>Buffer:array[0..(BCM2710_UART0_RX_BUFFER_SIZE - 1)] of Word;</code>
+| Buffer for received data (Includes data and status)
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 SDHCI'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710SDHCIHost = ^TBCM2710SDHCIHost;</code>
+<code>TBCM2710SDHCIHost = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''SDHCI Properties''
+|-
+| <code>SDHCI:TSDHCIHost;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>FIQ:LongBool;</code>
+| &nbsp;
+|-
+| <code>SDIO:LongBool;</code>
+| &nbsp;
+|-
+| <code>WriteDelay:LongWord;</code>
+| &nbsp;
+|-
+| <code>DelayClock:LongWord;</code>
+| &nbsp;
+|-
+| <code>ShadowRegister:LongWord;</code>
+| &nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 system clock'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710SystemClock = ^TBCM2710SystemClock;</code>
+<code>TBCM2710SystemClock = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Clock Properties''
+|-
+| <code>Clock:TClockDevice;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 ARM clock'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710ARMClock = ^TBCM2710ARMClock;</code>
+<code>TBCM2710ARMClock = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Clock Properties''
+|-
+| <code>Clock:TClockDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>CoreClock:LongWord;</code>
+| Core clock rate
+|-
+|}
+</div></div>
+'''BCM2710 ARM timer'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710ARMTimer = ^TBCM2710ARMTimer;</code>
+<code>TBCM2710ARMTimer = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Timer Properties''
+|-
+| <code>Timer:TTimerDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>CoreClock:LongWord;</code>
+| Core clock rate
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 local timer'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710LocalTimer = ^TBCM2710LocalTimer;</code>
+<code>TBCM2710LocalTimer = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Timer Properties''
+|-
+| <code>Timer:TTimerDevice;</code>
+| &nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>CoreClock:LongWord;</code>
+| Core clock rate
+|-
+|colspan="2"|''Statistics Properties''
+|-
+| <code>InterruptCount:LongWord;</code>
+| Number of interrupt requests received by the device
+|-
+|}
+</div></div>
+'''BCM2710 random'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710Random = ^TBCM2710Random;</code>
+<code>TBCM2710Random = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Random Properties''
+|-
+| <code>Random:TRandomDevice;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 mailbox'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710Mailbox = ^TBCM2710Mailbox;</code>
+<code>TBCM2710Mailbox = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Mailbox Properties''
+|-
+| <code>Mailbox:TMailboxDevice;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 watchdog'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710Watchdog = ^TBCM2710Watchdog;</code>
+<code>TBCM2710Watchdog = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Watchdog Properties''
+|-
+| <code>Watchdog:TWatchdogDevice;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</div></div>
+'''BCM2710 framebuffer'''
+<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
+<code>PBCM2710Framebuffer = ^TBCM2710Framebuffer;</code>
+<code>TBCM2710Framebuffer = record</code>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+|colspan="2"|''Framebuffer Properties''
+|-
+| <code>Framebuffer:TFramebufferDevice;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|colspan="2"|''BCM2710 Properties''
+|-
+| <code>MultiDisplay:LongBool;</code>
+| style="width: 50%;"|&nbsp;
+|-
+| <code>DisplayNum:LongWord;</code>
+| style="width: 50%;"|&nbsp;
+|-
+| <code>DisplaySettings:TDisplaySettings;</code>
+| style="width: 50%;"|&nbsp;
+|-
+|}
+</div></div>
+<br />
 === Public variables ===
 ----
-''To be documented''
+''None defined''
 === Function declarations ===
@@ Line 167: / Line 1,566: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 182: / Line 1,581: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 194: / Line 1,593: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 206: / Line 1,605: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 218: / Line 1,617: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 230: / Line 1,629: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 242: / Line 1,641: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 254: / Line 1,653: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 266: / Line 1,665: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 278: / Line 1,677: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Called ?rom within the interrupt handler
+| Called from within the interrupt handler
 |-
 |}
@@ Line 290: / Line 1,689: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Called ?rom within the interrupt handler
+| Called from within the interrupt handler
 |-
 |}
@@ Line 302: / Line 1,701: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 314: / Line 1,713: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 321: / Line 1,720: @@
 <br />
-'''BCM2710 BSCI2C (I2C0/1) functions'''
+'''BCM2710 BSCI2C (I2C0/1/2) functions'''
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
@@ Line 329: / Line 1,728: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 341: / Line 1,740: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 353: / Line 1,752: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 365: / Line 1,764: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 377: / Line 1,776: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 389: / Line 1,788: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 401: / Line 1,800: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 413: / Line 1,812: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 425: / Line 1,824: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Called ?rom within the interrupt handler
+| Called from within the interrupt handler
 |-
 |}
@@ Line 437: / Line 1,836: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Called ?rom within the interrupt handler
+| Called from within the interrupt handler
 |-
 |}
@@ Line 449: / Line 1,848: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Thread submitting the current request will hold the I2C device lock
+|-
+|}
+</div></div>
+<br />
+'''BCM2710 SPI/I2C slave 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 BCM2710I2CSlaveStart(I2C:PI2CDevice; Rate:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of I2CSlaveStart API for BCM2710 I2C slave</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use I2CSlaveStart instead.
+Rate is not applicable for I2C slave devices
+|-
+|}
+</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 BCM2710I2CSlaveStop(I2C:PI2CDevice):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of I2CSlaveStop API for BCM2710 I2C slave</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use I2CSlaveStop instead.
+|-
+|}
+</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 BCM2710I2CSlaveRead(I2C:PI2CDevice; Address:Word; Buffer:Pointer; Size:LongWord; var Count:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of I2CSlaveRead API for BCM2710 I2C slave</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use I2CSlaveRead instead.
+Address is not applicable for I2C slave devices
+|-
+|}
+</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 BCM2710I2CSlaveWrite(I2C:PI2CDevice; Address:Word; Buffer:Pointer; Size:LongWord; var Count:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of I2CSlaveWrite API for BCM2710 I2C slave</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use I2CSlaveWrite instead.
+Address is not applicable for I2C slave devices
+|-
+|}
+</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 BCM2710I2CSlaveSetAddress(I2C:PI2CDevice; Address:Word):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of I2CSlaveSetAddress API for BCM2710 I2C slave</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use I2CSlaveSetAddress instead.
 |-
 |}
@@ Line 464: / Line 1,929: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 476: / Line 1,941: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 488: / Line 1,953: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 500: / Line 1,965: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 512: / Line 1,977: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 524: / Line 1,989: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 536: / Line 2,001: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 548: / Line 2,013: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 560: / Line 2,025: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 575: / Line 2,040: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 587: / Line 2,052: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 599: / Line 2,064: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 606: / Line 2,071: @@
 <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 BCM2710PWM?etGPIO(PWM:PPWMDevice; GPIO:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710PWMSetGPIO(PWM:PPWMDevice; GPIO: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 623: / Line 2,088: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 630: / Line 2,095: @@
 <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 BCM2710PWM?etMode(PWM:PPWMDevice; Mode:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710PWMSetMode(PWM:PPWMDevice; Mode: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 642: / Line 2,107: @@
 <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 BCM2710PWM?etRange(PWM:PPWMDevice; Range:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710PWMSetRange(PWM:PPWMDevice; Range: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 654: / Line 2,119: @@
 <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 BCM2710PWM?etFrequency(PWM:PPWMDevice;Frequency:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710PWMSetFrequency(PWM:PPWMDevice;Frequency: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 666: / Line 2,131: @@
 <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 BCM2710PWM?etPolarity(PWM:PPWMDevice; Polarity:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710PWMSetPolarity(PWM:PPWMDevice; Polarity: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 683: / Line 2,148: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 695: / Line 2,160: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 707: / Line 2,172: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 719: / Line 2,184: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 734: / Line 2,199: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 746: / Line 2,211: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 758: / Line 2,223: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 770: / Line 2,235: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 782: / Line 2,247: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 794: / Line 2,259: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 806: / Line 2,271: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 818: / Line 2,283: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 825: / Line 2,290: @@
 <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 BCM2710GPIOOutput?et(GPIO:PGPIODevice; Pin,Level:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710GPIOOutputSet(GPIO:PGPIODevice; Pin,Level: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 842: / Line 2,307: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 854: / Line 2,319: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 866: / Line 2,331: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 878: / Line 2,343: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 890: / Line 2,355: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 902: / Line 2,367: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 913: / Line 2,378: @@
 <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 BCM2710UART0Open(UART:PUARTDevice; BaudRate,DataBits,StopBits,Parity,FlowControl: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:''' Implementation of UARTDeviceOpen API for BCM2710 UART0</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
+| Not intended to be called directly by applications, use UARTDeviceOpen instead.
 |-
 |}
@@ Line 925: / Line 2,390: @@
 <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 BCM2710UART0Close(UART:PUARTDevice):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of UARTDeviceClose API for BCM2710 UART0</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
+| Not intended to be called directly by applications, use UARTDeviceClose instead.
 |-
 |}
@@ Line 937: / Line 2,402: @@
 <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 BCM2710UART0Read(UART:PUARTDevice; Buffer:Pointer; Size,Flags:LongWord; var Count:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of UARTDeviceRead API for BCM2710 UART0</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use UARTDeviceRead instead.
+|-
+|}
+</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 BCM2710UART0PushRX(UART:PUARTDevice):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 949: / Line 2,426: @@
 <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 BCM2710UART0Write(UART:PUARTDevice; Buffer:Pointer; Size,Flags:LongWord; var Count: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:''' Implementation of UARTDeviceWrite API for BCM2710 UART0</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
+| Not intended to be called directly by applications, use UARTDeviceWrite instead.
 |-
 |}
@@ Line 960: / Line 2,437: @@
 <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 BCM2710UART0Status(UART:PUARTDevice):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710UART0GetStatus(UART:PUARTDevice):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of UARTDeviceGetStatus API for BCM2710 UART0</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
+| Not intended to be called directly by applications, use UARTDeviceGetStatus instead.
+|-
+|}
+</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 BCM2710UART0SetStatus(UART:PUARTDevice; Status:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of UARTDeviceSetStatus API for BCM2710 UART0</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use UARTDeviceSetStatus instead.
 |-
 |}
@@ Line 973: / Line 2,462: @@
 <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 BCM2710UART0InterruptHandler(UART:PUARTDevice);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Interrupt handler for the BCM2710 UART0 device</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
+| Not intended to be called directly by applications
 |-
 |}
@@ Line 985: / Line 2,474: @@
 <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 BCM2710UART0Receive(UART:PUARTDevice);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Receive handler for the BCM2710 UART0 device</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
+| Not intended to be called directly by applications
 |-
 |}
@@ Line 997: / Line 2,486: @@
 <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 BCM2710UART0Transmit(UART:PUARTDevice);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Transmit handler for the BCM2710 UART0 device</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
+| Not intended to be called directly by applications
+|-
+|}
+</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 BCM2710UART0EnableInterrupt(UART:PBCM2710UART0Device; Interrupt:LongWord);</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Enable the specified interrupt in the interrupt mask register of a BCM2710 UART0 device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! UART
+| The BCM2710 UART0 device to enable the interrupt for
+|-
+! Interrupt
+| The interrupt to enable
+|-
+! Note
+| Caller must hold the UART lock
+|-
+|}
+</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 BCM2710UART0DisableInterrupt(UART:PBCM2710UART0Device; Interrupt:LongWord);</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Disable the specified interrupt in the interrupt mask register of a BCM2710 UART0 device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! UART
+| The BCM2710 UART0 device to disable the interrupt for
+|-
+! Interrupt
+| The interrupt to disable
+|-
+! Note
+| Caller must hold the UART lock
 |-
 |}
@@ Line 1,012: / Line 2,537: @@
 <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 BCM2710SDHCIHostStart(SDHCI:PSDHCIHost):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostStart API for BCM2710 SDHCI</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
+| Not intended to be called directly by applications, use SDHCIHostStart instead.
 |-
 |}
@@ Line 1,024: / Line 2,549: @@
 <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 BCM2710SDHCIHostStop(SDHCI:PSDHCIHost):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostStop API for BCM2710 SDHCI</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
+| Not intended to be called directly by applications, use SDHCIHostStop instead.
+|-
+|}
+</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 BCM2710SDHCIHostLock(SDHCI:PSDHCIHost):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostLock API for BCM2710 SDHCI</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use SDHCIHostLock instead.
+|-
+|}
+</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 BCM2710SDHCIHostUnlock(SDHCI:PSDHCIHost):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostUnlock API for BCM2710 SDHCI</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use SDHCIHostUnlock instead.
+|-
+|}
+</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 BCM2710SDHCIHostSignal(SDHCI:PSDHCIHost; Semaphore:TSemaphoreHandle):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostSignal API for BCM2710 SDHCI</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use SDHCIHostSignal instead.
 |-
 |}
@@ Line 1,036: / Line 2,597: @@
 <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 BCM2710SDHCIHostReadByte(SDHCI:PSDHCIHost; Reg:LongWord):Byte;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostReadByte API for BCM2710 SDHCI</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| Not intended to be called directly by applications, use SDHCIHostReadByte instead.
+|-
+! Note
 | The Broadcom document BCM2835-ARM-Peripherals page 66 states the following: Contrary to Arasans documentation the EMMC module registers can only be accessed as 32 bit registers, i.e. the two LSBs of the address are always zero. For this reason this code must simulate Byte and Word reads using LongWord reads.
 |-
@@ Line 1,048: / Line 2,612: @@
 <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 BCM2710SDHCIHostReadWord(SDHCI:PSDHCIHost; Reg:LongWord):Word;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostReadWord API for BCM2710 SDHCI</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| Not intended to be called directly by applications, use SDHCIHostReadWord instead.
+|-
+! Note
 | The Broadcom document BCM2835-ARM-Peripherals page 66 states the following: Contrary to Arasans documentation the EMMC module registers can only be accessed as 32 bit registers, i.e. the two LSBs of the address are always zero. For this reason this code must simulate Byte and Word reads using LongWord reads.
 |-
@@ Line 1,060: / Line 2,627: @@
 <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 BCM2710SDHCIHostReadLong(SDHCI:PSDHCIHost; Reg: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:''' Implementation of SDHCIHostReadLong API for BCM2710 SDHCI</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
+| Not intended to be called directly by applications, use SDHCIHostReadLong instead.
 |-
 |}
@@ Line 1,072: / Line 2,639: @@
 <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 BCM2710SDHCIHostWriteByte(SDHCI:PSDHCIHost; Reg:LongWord; Value:Byte);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostWriteByte API for BCM2710 SDHCI</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| Not intended to be called directly by applications, use SDHCIHostWriteByte instead.
+|-
+! Note
 | The Broadcom document BCM2835-ARM-Peripherals page 66 states the following: Contrary to Arasans documentation the EMMC module registers can only be accessed as 32 bit registers, i.e. the two LSBs of the address are always zero. For this reason this code must simulate Byte and Word writes using LongWord writes.
 |-
@@ Line 1,084: / Line 2,654: @@
 <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 BCM2710SDHCIHostWriteWord(SDHCI:PSDHCIHost; Reg:LongWord; Value:Word);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostWriteWord API for BCM2710 SDHCI</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| Not intended to be called directly by applications, use SDHCIHostWriteWord instead.
+|-
+! Note
 | The Broadcom document BCM2835-ARM-Peripherals page 66 states the following: Contrary to Arasans documentation the EMMC module registers can only be accessed as 32 bit registers, i.e. the two LSBs of the address are always zero. For this reason this code must simulate Byte and Word writes using LongWord writes.
 |-
@@ Line 1,096: / Line 2,669: @@
 <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 BCM2710SDHCIHostWriteLong(SDHCI:PSDHCIHost; Reg:LongWord; Value:LongWord);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of SDHCIHostWriteLong API for BCM2710 SDHCI</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
+| Not intended to be called directly by applications, use SDHCIHostWriteLong instead.
+|-
+! Note
 | The source code of U-Boot and Linux kernel drivers have this comment The Arasan has a bugette whereby it may lose the content of successive writes to registers that are within two SD-card clock cycles of each other (a clock domain crossing problem). It seems, however, that the data register does not have this problem (which is just as well - otherwise we'd have to nobble the DMA engine too). For this reason this code must delay after each write to the registers.
 |-
@@ Line 1,108: / Line 2,684: @@
 <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 BCM2710SDHCIInterruptHandler(SDHCI:PSDHCIHost);</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Interrupt handler for the BCM2710 SDHCI host controller</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
+| Not intended to be called directly by applications
 |-
 |}
@@ Line 1,120: / Line 2,696: @@
 <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 BCM2710SDHCISetupInterrupts(SDHCI:PSDHCIHost):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Configure and enable interrupt handling for the BCM2710 SDHCI</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
+| Not intended to be called directly by applications
 |-
 |}
@@ Line 1,136: / Line 2,712: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| None documented
+| Not intended to be called directly by applications, use MMCDeviceGetCardDetect instead.
 |-
 |}
@@ Line 1,143: / Line 2,719: @@
 <br />
-'''BCM2710 Clock functions'''
+'''BCM2710 system clock 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 BCM2710ClockRead(Clock:PClockDevice):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710SystemClockRead(Clock:PClockDevice):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,158: / Line 2,734: @@
 <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 BCM2710ClockRead64(Clock:PClockDevice):Int64;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710SystemClockRead64(Clock:PClockDevice):Int64;</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 />
+'''BCM2710 ARM clock 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 BCM2710ARMClockStart(Clock:PClockDevice):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 BCM2710ARMClockStop(Clock:PClockDevice):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 BCM2710ARMClockRead(Clock:PClockDevice):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 BCM2710ARMClockRead64(Clock:PClockDevice):Int64;</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 BCM2710ARMClockSetRate(Clock:PClockDevice; Rate: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,170: / Line 2,809: @@
 <br />
-'''BCM2710 ARM Timer functions'''
+'''BCM2710 ARM timer functions'''
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
@@ Line 1,178: / Line 2,817: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDeviceStart instead
+| Not intended to be called directly by applications, use TimerDeviceStart instead.
 |-
 |}
@@ Line 1,190: / Line 2,829: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDeviceStop instead
+| Not intended to be called directly by applications, use TimerDeviceStop instead.
 |-
 |}
@@ Line 1,202: / Line 2,841: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDeviceRead64 instead
+| Not intended to be called directly by applications, use TimerDeviceRead64 instead.
 |-
 |}
@@ Line 1,214: / Line 2,853: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDeviceWait instead
+| Not intended to be called directly by applications, use TimerDeviceWait instead.
 |-
 |}
@@ Line 1,226: / Line 2,865: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDeviceEvent instead
+| Not intended to be called directly by applications, use TimerDeviceEvent instead.
 |-
 |}
@@ Line 1,238: / Line 2,877: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDeviceCancel instead
+| Not intended to be called directly by applications, use TimerDeviceCancel instead.
 |-
 |}
@@ Line 1,245: / Line 2,884: @@
 <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 BCM2710ARMTimer?etRate(Timer:PTimerDevice; Rate:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710ARMTimerSetRate(Timer:PTimerDevice; Rate:LongWord):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of TimerDevice?etRate API for ARM Timer</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of TimerDeviceSetRate API for ARM Timer</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDevice?etRate instead
+| Not intended to be called directly by applications, use TimerDeviceSetRate instead.
 |-
 |}
@@ Line 1,257: / Line 2,896: @@
 <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 BCM2710ARMTimer?etInterval(Timer:PTimerDevice; Interval:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710ARMTimerSetInterval(Timer:PTimerDevice; Interval:LongWord):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of TimerDevice?etInterval API for ARM Timer</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of TimerDeviceSetInterval API for ARM Timer</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use TimerDevice?etInterval instead
+| Not intended to be called directly by applications, use TimerDeviceSetInterval instead.
 |-
 |}
@@ Line 1,274: / Line 2,913: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Not intended to be called directly by applications
 |-
@@ Line 1,286: / Line 2,925: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | Not intended to be called directly by applications
 |-
@@ Line 1,301: / Line 2,940: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,313: / Line 2,952: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,325: / Line 2,964: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,340: / Line 2,979: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,352: / Line 2,991: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,364: / Line 3,003: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,376: / Line 3,015: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 1,387: / Line 3,026: @@
 <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 BCM2710FramebufferAllocate(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceAllocate API for BCM2710 Framebuffer</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
+| Not intended to be called directly by applications, use FramebufferDeviceAllocate instead.
 |-
 |}
@@ Line 1,399: / Line 3,038: @@
 <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 BCM2710FramebufferRelease(Framebuffer:PFramebufferDevice):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceRelease API for BCM2710 Framebuffer</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
+| Not intended to be called directly by applications, use FramebufferDeviceRelease instead.
 |-
 |}
@@ Line 1,411: / Line 3,050: @@
 <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 BCM2710FramebufferBlank(Framebuffer:PFramebufferDevice; Blank:Boolean):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceBlank API for BCM2710 Framebuffer</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
+| Not intended to be called directly by applications, use FramebufferDeviceBlank instead.
 |-
 |}
@@ Line 1,422: / Line 3,061: @@
 <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 BCM2710FramebufferCommit(Framebuffer:PFramebufferDevice; Address,Size,Flags:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710FramebufferCommit(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:''' Implementation of FramebufferDeviceCommit API for BCM2710 Framebuffer</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
+| Not intended to be called directly by applications, use FramebufferDeviceCommit instead.
 |-
 |}
@@ Line 1,434: / Line 3,073: @@
 <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 BCM2710Framebuffer?etBacklight(Framebuffer:PFramebufferDevice; Brightness:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710FramebufferWaitSync(Framebuffer:PFramebufferDevice):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceWaitSync API for BCM2710 Framebuffer</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
+| Not intended to be called directly by applications, use FramebufferDeviceWaitSync instead.
 |-
 |}
@@ Line 1,446: / Line 3,085: @@
 <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 BCM2710Framebuffer?etProperties(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function BCM2710FramebufferSetOffsetEx(Framebuffer:PFramebufferDevice; X,Y:LongWord; Pan,Switch:Boolean):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetOffsetEx API for BCM2710 Framebuffer</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
+| Not intended to be called directly by applications, use FramebufferDeviceSetOffsetEx instead.
+|-
+|}
+</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 BCM2710FramebufferGetPalette(Framebuffer:PFramebufferDevice; Palette:PFramebufferPalette):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceGetPalette API for BCM2710 Framebuffer</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use FramebufferDeviceGetPalette instead.
+|-
+|}
+</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 BCM2710FramebufferSetPalette(Framebuffer:PFramebufferDevice; Palette:PFramebufferPalette):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetPalette API for BCM2710 Framebuffer</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use FramebufferDeviceSetPalette instead.
+|-
+|}
+</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 BCM2710FramebufferSetBacklight(Framebuffer:PFramebufferDevice; Brightness:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetBacklight API for BCM2710 Framebuffer</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use FramebufferDeviceSetBacklight instead.
+|-
+|}
+</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 BCM2710FramebufferSetCursor(Framebuffer:PFramebufferDevice; Width,Height,HotspotX,HotspotY:LongWord; Image:Pointer; Len:LongWord):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetCursor API for BCM2710 Framebuffer</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use FramebufferDeviceSetCursor instead.
+|-
+|}
+</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 BCM2710FramebufferUpdateCursor(Framebuffer:PFramebufferDevice; Enabled:Boolean; X,Y:LongInt; Relative:Boolean):LongWord;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceUpdateCursor API for BCM2710 Framebuffer</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Note
+| Not intended to be called directly by applications, use FramebufferDeviceUpdateCursor instead.
+|-
+|}
+</div></div>
+<br />
+'''BCM2710 helper 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 BCM2710SPIGetDescription(Id:LongWord):String;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the device description of an SPI device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Id
+| The Id number of the SPI device (0 or 2)
+|-
+! Return
+| The correct device description suitable for passing to SPIDeviceFindByDescription
+|-
+! Note
+| The Id number supplied to this function may differ from the Ultibo device id value.
+|-
+|}
+</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 BCM2710I2CGetDescription(Id:LongWord):String;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the device description of an I2C device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Id
+| The Id number of the I2C device (0 to 2)
+|-
+! Return
+| The correct device description suitable for passing to I2CDeviceFindByDescription
+|-
+! Note
+| The Id number supplied to this function may differ from the Ultibo device id value.
+|-
+|}
+</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 BCM2710I2CSlaveGetDescription(Id:LongWord):String;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the device description of an I2C slave device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Id
+| The Id number of the I2C slave device (Always 0)
+|-
+! Return
+| The correct device description suitable for passing to I2CSlaveFindByDescription
+|-
+! Note
+| The Id number supplied to this function may differ from the Ultibo device id value
+|-
+|}
+</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 BCM2710PWMGetDescription(Id,Channel:LongWord):String;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the device description of a PWM device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Id
+| The Id number of the PWM device (0 or 1)
+|-
+! Channel
+| The channel number of the PWM device (0 or 1)
+|-
+! Return
+| The correct device description suitable for passing to PWMDeviceFindByDescription
+|-
+! Note
+| The Id number supplied to this function may differ from the Ultibo device id value.
+|-
+|}
+</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 BCM2710UARTGetDescription(Id:LongWord):String;</pre>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the device description of a UART device</div>
+<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
+{| class="wikitable" style="font-size: 14px; background: white;"
+|-
+! Id
+| The Id number of the UART device (0 or 1)
+|-
+! Return
+| The correct device description suitable for passing to UARTDeviceFindByDescription
+|-
+! Note
+| The Id number supplied to this function may differ from the Ultibo device id value.
 |-
 |}

`BCM2710_SPI0_DESCRIPTION = 'BCM2837 SPI0 Master';`

`BCM2710_SPI0_MAX_SIZE = $FFFF;`

`BCM2710_SPI0_MIN_CLOCK = 3814;`	Default minimum based on the default settings from the firmware (Recalculated during open)
`BCM2710_SPI0_MAX_CLOCK = 125000000;`	Default maximum based on the default settings from the firmware (Recalculated during open)

`BCM2710_SPI0_MIN_DIVIDER = 2;`	Divider is always rounded down to an even number and a value of 0 sets the divider to 65536
`BCM2710_SPI0_MAX_DIVIDER = $FFFE;`	Divider is always rounded down to an even number

`BCM2710_SPI0_CORE_CLOCK = 250000000;`	Default core clock based on the default settings from the firmware (Requested from firmware during start)

`BCM2710_SPI0_MODE_IRQ = 0;`
`BCM2710_SPI0_MODE_DMA = 1;`
`BCM2710_SPI0_MODE_PIO = 2;`

`BCM2710_BSCI2C_MAX_SIZE = $FFFF;`

`BCM2710_BSCI2C_MIN_CLOCK = 3814;`	Default minimum based on the default settings from the firmware (Recalculated during open)
`BCM2710_BSCI2C_MAX_CLOCK = 125000000;`	Default maximum based on the default settings from the firmware (Recalculated during open)
`BCM2710_BSCI2C_DEFAULT_CLOCK = 100000;`

`BCM2710_BSCI2C_MIN_DIVIDER = 2;`	Divider is always rounded down to an even number and a value of 0 sets the divider to 32768
`BCM2710_BSCI2C_MAX_DIVIDER = $FFFE;`	Divider is always rounded down to an even number

`BCM2710_BSCI2C_CORE_CLOCK = 250000000;`	Default core clock based on the default settings from the firmware (Requested from firmware during start)

`BCM2710_BSCI2C_MODE_WRITE = 0;`
`BCM2710_BSCI2C_MODE_READ = 1;`

`BCM2710_I2CSLAVE_DESCRIPTION = 'BCM2837 I2C Slave';`

`BCM2710_I2CSLAVE_TIMEOUT = 10;`	Timeout (Milliseconds) for RX/TX wait data
`BCM2710_I2CSLAVE_BUFFER_SIZE = 1024;`	Size in bytes of the RX/TX data buffer
`BCM2710_I2CSLAVE_RX_POLL_LIMIT = 256;`	Number of times interrupt handler may poll the read FIFO

`BCM2710_DMA_DESCRIPTION = 'BCM2837 DMA';`

`BCM2710_DMA_CHANNEL_COUNT = 16;`	Total number of DMA channels (Not all are usable)

`BCM2710_DMA_LITE_CHANNELS = $7F80;`	Mask of DMA Lite channels (7 to 14)
`BCM2710_DMA_NORMAL_CHANNELS = $007E;`	(807F) Mask of normal channels (1 to 6)
`BCM2710_DMA_BULK_CHANNELS = $8001;`	Mask of DMA Bulk channels (0 and 15)

`BCM2710_DMA_SHARED_CHANNELS = $7800;`	Mask of channels with shared interrupt (11 to 14)

`BCM2710_DMA_MAX_LITE_TRANSFER = 65536;`	Maximum transfer length for a DMA Lite channel
`BCM2710_DMA_MAX_NORMAL_TRANSFER = 1073741824;`	Maximum transfer length for a normal channel

`BCM2710_DMA_MAX_STRIDE = $FFFF;`	Maximum stride value (Increment between rows) (Note this is a signed value (Min -32768/Max 32767)
`BCM2710_DMA_MAX_Y_COUNT = $3FFF;`	Maximum number of X length transfers in 2D stride
`BCM2710_DMA_MAX_X_LENGTH = $FFFF;`	Maximum X transfer length in 2D stride

`BCM2710_DMA_CB_ALIGNMENT = 32;`	Alignment required for DMA control blocks

`BCM2710_DMA_LITE_BURST_LENGTH = 2;`	Burst length for DMA Lite channels
`BCM2710_DMA_NORMAL_BURST_LENGTH = 4;`	Burst length for normal channels
`BCM2710_DMA_BULK_BURST_LENGTH = 16;`	Burst length for DMA Bulk channels

`BCM2710_PWM_MIN_PERIOD = 108;`	Default based on 19.2MHz PWM clock (Oscillator source)
`BCM2710_PWM_DEFAULT_CLOCK = 19200000;`	Default to the 19.2MHz oscillator clock

`BCM2710_GPIO_DESCRIPTION = 'BCM2837 GPIO';`

`BCM2710_GPIO_MIN_PIN = GPIO_PIN_0;`
`BCM2710_GPIO_MAX_PIN = GPIO_PIN_53;`

`BCM2710_GPIO_MAX_LEVEL = GPIO_LEVEL_HIGH;`

`BCM2710_GPIO_MAX_PULL = GPIO_PULL_DOWN;`

`BCM2710_GPIO_MIN_FUNCTION = GPIO_FUNCTION_IN;`
`BCM2710_GPIO_MAX_FUNCTION = GPIO_FUNCTION_ALT5;`

`BCM2710_GPIO_MIN_TRIGGER = GPIO_TRIGGER_LOW;`
`BCM2710_GPIO_MAX_TRIGGER = GPIO_TRIGGER_ASYNC_FALLING;`

GPIO pull up/down to BCM2837 pull up/down
`BCM2710_GPIO_PULL_MAP:array[GPIO_PULL_NONE..GPIO_PULL_DOWN] of LongWord = (`
`BCM2837_GPPUD_NONE,`
`BCM2837_GPPUD_UP,`
`BCM2837_GPPUD_DOWN);`

GPIO functions to BCM2837 functions
`BCM2710_GPIO_FUNCTION_MAP:array[BCM2710_GPIO_MIN_FUNCTION..BCM2710_GPIO_MAX_FUNCTION] of LongWord = (`
`BCM2837_GPFSEL_IN,`
`BCM2837_GPFSEL_OUT,`
`BCM2837_GPFSEL_ALT0,`
`BCM2837_GPFSEL_ALT1,`
`BCM2837_GPFSEL_ALT2,`
`BCM2837_GPFSEL_ALT3,`
`BCM2837_GPFSEL_ALT4,`
`BCM2837_GPFSEL_ALT5);`

BCM2837 functions to GPIO functions
`BCM2710_GPIO_FUNCTION_UNMAP:array[BCM2710_GPIO_MIN_FUNCTION..BCM2710_GPIO_MAX_FUNCTION] of LongWord = (`
`GPIO_FUNCTION_IN,`
`GPIO_FUNCTION_OUT,`
`GPIO_FUNCTION_ALT5,`
`GPIO_FUNCTION_ALT4,`
`GPIO_FUNCTION_ALT0,`
`GPIO_FUNCTION_ALT1,`
`GPIO_FUNCTION_ALT2,`
`GPIO_FUNCTION_ALT3);`

GPIO triggers to BCM2837 event registers
`BCM2710_GPIO_TRIGGER_MAP:array[BCM2710_GPIO_MIN_TRIGGER..BCM2710_GPIO_MAX_TRIGGER] of LongWord = (`
`BCM2837_GPLEN0,`
`BCM2837_GPHEN0,`
`BCM2837_GPREN0,`
`BCM2837_GPFEN0,`
`BCM2837_GPAREN0,`
`BCM2837_GPAFEN0);`

`BCM2710_UART0_DESCRIPTION = 'BCM2837 PL011 UART';`

`BCM2710_UART0_MIN_BAUD = 300;`	Default minimum of 300 baud
`BCM2710_UART0_MAX_BAUD = 187500;`	Default maximum based on the default settings from the firmware (Recalculated during open)

`BCM2710_UART0_MIN_DATABITS = SERIAL_DATA_5BIT;`
`BCM2710_UART0_MAX_DATABITS = SERIAL_DATA_8BIT;`

`BCM2710_UART0_MIN_STOPBITS = SERIAL_STOP_1BIT;`
`BCM2710_UART0_MAX_STOPBITS = SERIAL_STOP_2BIT;`

`BCM2710_UART0_MAX_PARITY = SERIAL_PARITY_EVEN;`

`BCM2710_UART0_MAX_FLOW = SERIAL_FLOW_RTS_CTS;`

`BCM2710_UART0_CLOCK_RATE = 3000000;`	Default clock rate based on the default settings from the firmware (Requested from firmware during open)

`BCM2710_UART0_RX_POLL_LIMIT = 256;`	Number of times interrupt handler may poll the read FIFO
`BCM2710_UART0_RX_BUFFER_SIZE = 1024;`

`BCM2710_EMMC_DESCRIPTION = 'BCM2837 Arasan SD Host';`

`BCM2710_EMMC_MIN_FREQ = 400000;`	Default minimum of 400KHz
`BCM2710_EMMC_MAX_FREQ = 200000000;`	Default clock rate based on the default settings from the firmware (Requested from firmware during start)

`BCM2710_SDHOST_DESCRIPTION = 'BCM2837 SDHOST';`

`BCM2710_SDHOST_MIN_FREQ = 400000;`	Default minimum of 400KHz
`BCM2710_SDHOST_MAX_FREQ = 250000000;`	Default clock rate based on the default settings from the firmware (Requested from firmware during start)
See: BCMSDHOST for the driver implementation

SPI Properties
`SPI:TSPIDevice;`
BCM2710 Properties
`Address:Pointer;`	Device register base address
`CoreClock:LongWord;`	Core clock rate

`GPIO:PGPIODevice;`
`Bank:LongWord;`
`Address:PtrUInt;`
`PinStart:LongWord;`

`BCM2710_ARM_CLOCK_DESCRIPTION = 'BCM2837 ARM Timer Clock';`

`BCM2710_ARM_CLOCK_MIN_RATE = 976562;`	Default minimum (Divider 255) based on the default settings from the firmware (Recalculated during start)
`BCM2710_ARM_CLOCK_MAX_RATE = 250000000;`	Default maximum (Divider 0) based on the default settings from the firmware (Recalculated during start)
`BCM2710_ARM_CLOCK_DEFAULT_RATE = 3968253;`	Default rate (Divider 62) based on the default settings from the firmware (Recalculated during start)

`BCM2710_ARM_CLOCK_MIN_DIVIDER = 0;`
`BCM2710_ARM_CLOCK_MAX_DIVIDER = 255;`
`BCM2710_ARM_CLOCK_DEFAULT_DIVIDER = 62;`

`BCM2710_ARM_CLOCK_CORE_CLOCK = 250000000;`	Default core clock based on the default settings from the firmware (Requested from firmware during start)

`BCM2710_ARM_TIMER_DESCRIPTION = 'BCM2837 ARM Timer';`

`BCM2710_ARM_TIMER_MIN_RATE = 244140;`	Default minimum (Divider 1023) based on the default settings from the firmware (Recalculated during start)
`BCM2710_ARM_TIMER_MAX_RATE = 250000000;`	Default maximum (Divider 0) based on the default settings from the firmware (Recalculated during start)
`BCM2710_ARM_TIMER_DEFAULT_RATE = 1000000;`	Default rate (Divider 249) based on the default settings from the firmware (Recalculated during start)

`BCM2710_ARM_TIMER_MIN_INTERVAL = 1;`
`BCM2710_ARM_TIMER_MAX_INTERVAL = $FFFFFFFF;`

`BCM2710_ARM_TIMER_MIN_DIVIDER = 0;`
`BCM2710_ARM_TIMER_MAX_DIVIDER = 1023;`
`BCM2710_ARM_TIMER_DEFAULT_DIVIDER = 249;`

`BCM2710_ARM_TIMER_CORE_CLOCK = 250000000;`	Default core clock based on the default settings from the firmware (Requested from firmware during start)

`BCM2710_RANDOM_DESCRIPTION = 'BCM2837 Random Number Generator';`

`BCM2710_RANDOM_WARMUP_COUNT = $00040000;`	The initial numbers generated are "less random" so will be discarded

I2C Properties
`I2C:TI2CDevice;`
BCM2710 Properties
`Address:Pointer;`	Device register base address
`CoreClock:LongWord;`	Core clock rate
`SDAPin:LongWord;`	GPIO pin for the SDA line
`SCLPin:LongWord;`	GPIO pin for the SCL line
`SDAFunction:LongWord;`	GPIO function for the SDA line
`SCLFunction:LongWord;`	GPIO function for the SCL line
Transfer Properties
`Index:LongWord;`	Index of this device in the IRQData array (Set during device initialization)
`Mode:LongWord;`	Mode of current transfer (BCM2710_BSCI2C_MODE_WRITE/BCM2710_BSCI2C_MODE_READ)
`Data:Pointer;`	Pointer to the data for current transfer
`Count:LongWord;`	Count of bytes for current transfer
`Remain:LongWord;`	Bytes remaining for current transfer
`Error:LongBool;`	True if an error occurred during the transfer
Statistics Properties
`InterruptCount:LongWord;`	Number of interrupt requests received by the device

Note: BSC I2C devices share a single interrupt
`Count:LongWord;`
`Lock:TSpinHandle;`
`Devices:array[0..2] of PBCM2710BSCI2CDevice;`

`Wait:TSemaphoreHandle;`	Data ready semaphore
`Start:LongWord;`	Index of first available buffer entry
`Count:LongWord;`	Number of available entries in the buffer
`Buffer:array[0..(BCM2710_I2CSLAVE_BUFFER_SIZE - 1)] of Byte;`

`Host:PBCM2710DMAHost;`	DMA host this channel belongs to
`Request:PDMARequest;`	Current DMA request pending on this channel (or nil of no request is pending)
`Number:LongWord;`	The channel number of this channel
`Interrupt:LongWord;`	The interrupt number of this channel
`Registers:PBCM2837DMARegisters;`	The channel registers for configuration

DMA Properties
`DMA:TDMAHost;`
BCM2710 Properties
`ChannelMask:LongWord;`	Mask of available channels (Passed from GPU firmware)
`ChannelFree:LongWord;`	Bitmap of current free channels
`ChannelLock:TMutexHandle;`	Lock for access to ChannelFree
`ChannelWait:TSemaphoreHandle;`	Number of free normal channels in ChannelFree
`ChannelLite:TSemaphoreHandle;`	Number of free DMA Lite channels in ChannelFree
`ChannelBulk:TSemaphoreHandle;`	Number of free DMA Bulk channels in ChannelFree
`Channels:array[0..BCM2710_DMA_CHANNEL_COUNT - 1] of TBCM2710DMAChannel;`	Channel information for each DMA channel on the host
`EnableRegister:PLongWord;`
`InterruptRegister:PLongWord;`
Statistics Properties
`InterruptCount:LongWord;`	Number of interrupt requests received by the host controller

PWM Properties
`PWM:TPWMDevice;`
BCM2710 Properties
`Address:Pointer;`	Device register base address
`Channel:LongWord;`	Channel for this device
`Scaler:LongWord;`	Scaler for Duty cycle and Period
`Pair:PBCM2710PWMDevice;`	The paired PWM device for the other channel
Audio Properties
`Audio:PBCM2710PWMAudio;`	The associated PWM Audio device

Audio Properties
`Audio:TAudioDevice;`
PWM Properties
`PWM0:PBCM2710PWMDevice;`	The PWM device for channel 0
`PWM1:PBCM2710PWMDevice;`	The PWM device for channel 1

Difference between revisions of "Unit BCM2710"

Latest revision as of 03:47, 5 September 2023

Contents

Description

Constants

Type definitions

Public variables

Function declarations

Navigation menu

Search

GPIO Properties
`GPIO:TGPIODevice;`
BCM2710 Properties
`Lock:TSpinHandle;`	Device lock (Differs from lock in Device portion) (Spin lock due to use by interrupt handler)
`Banks:array[0..BCM2837_GPIO_BANK_COUNT - 1] of TBCM2710GPIOBank;`
Statistics Properties
`InterruptCount:LongWord;`	Number of interrupt requests received by the device

UART Properties
`UART:TUARTDevice;`
BCM2710 Properties
`Address:Pointer;`	Device register base address
`ClockRate:LongWord;`	Device clock rate

`Start:LongWord;`	Index of first available buffer entry
`Count:LongWord;`	Number of available entries in the buffer
`Buffer:array[0..(BCM2710_UART0_RX_BUFFER_SIZE - 1)] of Word;`	Buffer for received data (Includes data and status)
Statistics Properties
`InterruptCount:LongWord;`	Number of interrupt requests received by the device

SDHCI Properties
`SDHCI:TSDHCIHost;`
BCM2710 Properties
`FIQ:LongBool;`
`SDIO:LongBool;`
`WriteDelay:LongWord;`
`DelayClock:LongWord;`
`ShadowRegister:LongWord;`

Clock Properties
`Clock:TClockDevice;`
BCM2710 Properties
`CoreClock:LongWord;`	Core clock rate

Timer Properties
`Timer:TTimerDevice;`
BCM2710 Properties
`CoreClock:LongWord;`	Core clock rate
Statistics Properties
`InterruptCount:LongWord;`	Number of interrupt requests received by the device

Framebuffer Properties
`Framebuffer:TFramebufferDevice;`
BCM2710 Properties
`MultiDisplay:LongBool;`
`DisplayNum:LongWord;`
`DisplaySettings:TDisplaySettings;`

UART	The BCM2710 UART0 device to enable the interrupt for
Interrupt	The interrupt to enable
Note	Caller must hold the UART lock

UART	The BCM2710 UART0 device to disable the interrupt for
Interrupt	The interrupt to disable
Note	Caller must hold the UART lock

Note	Not intended to be called directly by applications, use SDHCIHostReadByte instead.
Note	The Broadcom document BCM2835-ARM-Peripherals page 66 states the following: Contrary to Arasans documentation the EMMC module registers can only be accessed as 32 bit registers, i.e. the two LSBs of the address are always zero. For this reason this code must simulate Byte and Word reads using LongWord reads.

Id	The Id number of the SPI device (0 or 2)
Return	The correct device description suitable for passing to SPIDeviceFindByDescription
Note	The Id number supplied to this function may differ from the Ultibo device id value.