Difference between revisions of "Unit BCM2710"

Revision as of 04:35, 21 November 2016

Return to Unit Reference

Description

This unit provides the BCM2710 specific implementations of the following devices:

• SPI0
• I2C0
• I2C1
• SPI1
• SPI2
• I2C Slave
• SPI Slave
• DMA
• PWM0
• PWM1
• PCM
• GPIO
• UART0
• UART1
• SDHCI (eMMC)

• Clock
• ARM Timer
• Local Timer
• Random
• Mailbox
• Watchdog
• Framebuffer

• MIPI CSI-2 (Camera Serial Interface)
• DSI (Display Serial Interface)

BCM2710 SPI0 Device

The BCM2710 has a single master mode SPI controller that supports 3 wire, 2 wire and LoSSI modes of operation. It also has 2 auxiliary SPI masters which do not support DMA mode (see SPI1/2 below).

The main SPI0 controller supports polled, interrupt and DMA modes and includes 3 chip selects although only CS0 and 1 are available on the 26 or 40 pin header.

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

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.

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.

Note: On the Raspberry Pi A+/B+/Zero/2B/3B the ID EEPROM pins on the 40 pin header are actually connected to GPIO 0 and 1 (BSC0)

Device BSC1 can appear on GPIO pins 2 and 3 (Alternate function 0) or 44 and 45 (Alternate function 2) but only pins 2 and 3 are exposed on the 26 or 40 pin header.

BCM2710 SPI1/2 Device

The BCM2710 has 2 additional SPI universal masters available as part of the AUX device which support interrupt mode but not DMA and therefore only allow limited bandwidth transfers due to the CPU overhead required to sustain high data rates.

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 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, 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 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.

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.

BCM2710 Clock 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 ?rom a load or reload register to begin counting again.

Constants

To be documented

Type definitions

To be documented

Public variables

To be documented

Function declarations

Initialization functions

procedure BCM2710Init;

BCM2710 SPI0 functions

function BCM2710SPI0Start(SPI:PSPIDevice; Mode,ClockRate,ClockPhase,ClockPolarity:LongWord):LongWord;

function BCM2710SPI0Stop(SPI:PSPIDevice):LongWord;

function BCM2710SPI0WriteRead(SPI:PSPIDevice; ChipSelect:Word; Source,Dest:Pointer; Size,Flags:LongWord; var Count:LongWord):LongWord;

function BCM2710SPI0SetMode(SPI:PSPIDevice; Mode:LongWord):LongWord;

function BCM2710SPI0SetClockRate(SPI:PSPIDevice; ChipSelect:Word; ClockRate:LongWord):LongWord;

function BCM2710SPI0SetClockPhase(SPI:PSPIDevice; ClockPhase:LongWord):LongWord;

function BCM2710SPI0SetClockPolarity(SPI:PSPIDevice; ClockPolarity:LongWord):LongWord;

function BCM2710SPI0SetSelectPolarity(SPI:PSPIDevice; ChipSelect:Word; SelectPolarity:LongWord):LongWord;

procedure BCM2710SPI0ReadFIFO(SPI:PBCM2710SPI0Device);

procedure BCM2710SPI0WriteFIFO(SPI:PBCM2710SPI0Device);

procedure BCM2710SPI0InterruptHandler(SPI:PBCM2710SPI0Device);

procedure BCM2710SPI0DMARequestCompleted(Request:PDMARequest);

BCM2710 BSCI2C (I2C0/1) functions

function BCM2710BSCI2CStart(I2C:PI2CDevice; Rate:LongWord):LongWord;

function BCM2710BSCI2CStop(I2C:PI2CDevice):LongWord;

function BCM2710BSCI2CRead(I2C:PI2CDevice; Address:Word; Buffer:Pointer; Size:LongWord; var Count:LongWord):LongWord;

function BCM2710BSCI2CWrite(I2C:PI2CDevice; Address:Word; Buffer:Pointer; Size:LongWord; var Count:LongWord):LongWord;

function BCM2710BSCI2CWriteRead(I2C:PI2CDevice; Address:Word; Initial:Pointer; Len:LongWord; Data:Pointer; Size:LongWord; var Count:LongWord):LongWord;

function BCM2710BSCI2CWriteWrite(I2C:PI2CDevice; Address:Word; Initial:Pointer; Len:LongWord; Data:Pointer; Size:LongWord; var Count:LongWord):LongWord;

function BCM2710BSCI2CSetRate(I2C:PI2CDevice; Rate:LongWord):LongWord;

function BCM2710BSCI2CSetAddress(I2C:PI2CDevice; Address:Word):LongWord;

procedure BCM2710BSCI2CFillFIFO(I2C:PBCM2710BSCI2CDevice);

procedure BCM2710BSCI2CDrainFIFO(I2C:PBCM2710BSCI2CDevice);

procedure BCM2710BSCI2CInterruptHandler(IRQData:PBCM2710BSCI2CIRQData);

BCM2710 DMA functions

function BCM2710DMAHostStart(DMA:PDMAHost):LongWord;

function BCM2710DMAHostStop(DMA:PDMAHost):LongWord;

function BCM2710DMAHostSubmit(DMA:PDMAHost;Request:PDMARequest):LongWord;

function BCM2710DMAHostCancel(DMA:PDMAHost;Request:PDMARequest):LongWord;

procedure BCM2710DMAInterruptHandler(Channel:PBCM2710DMAChannel);

procedure BCM2710DMASharedInterruptHandler(DMA:PBCM2710DMAHost);

procedure BCM2710DMARequestComplete(Channel:PBCM2710DMAChannel);

function BCM2710DMAPeripheralToDREQ(Peripheral:LongWord):LongWord;

procedure BCM2710DMADataToControlBlock(Request:PDMARequest; Data:PDMAData; Block:PBCM2837DMAControlBlock; Bulk,Lite:Boolean);

BCM2710 PWM0/1 functions

function BCM2710PWMStart(PWM:PPWMDevice):LongWord;

function BCM2710PWMStop(PWM:PPWMDevice):LongWord;

function BCM2710PWMWrite(PWM:PPWMDevice; Value:LongWord):LongWord;

function BCM2710PWM?etGPIO(PWM:PPWMDevice; GPIO:LongWord):LongWord;

function BCM2710PWMResetGPIO(PWM:PPWMDevice; GPIO:LongWord):LongWord;

function BCM2710PWM?etMode(PWM:PPWMDevice; Mode:LongWord):LongWord;

function BCM2710PWM?etRange(PWM:PPWMDevice; Range:LongWord):LongWord;

function BCM2710PWM?etFrequency(PWM:PPWMDevice;Frequency:LongWord):LongWord;

function BCM2710PWM?etPolarity(PWM:PPWMDevice; Polarity:LongWord):LongWord;

function BCM2710PWMConfigure(PWM:PPWMDevice; DutyNS,PeriodNS:LongWord):LongWord;

function BCM2710PWMClockStart(PWM:PPWMDevice; Frequency:LongWord):LongWord;

function BCM2710PWMClockStop(PWM:PPWMDevice):LongWord;

function BCM2710PWMClockEnabled(PWM:PPWMDevice):Boolean;

BCM2710 GPIO functions

function BCM2710GPIOStart(GPIO:PGPIODevice):LongWord;

function BCM2710GPIOStop(GPIO:PGPIODevice):LongWord;

function BCM2710GPIORead(GPIO:PGPIODevice; Reg:LongWord):LongWord;

procedure BCM2710GPIOWrite(GPIO:PGPIODevice; Reg,Value:LongWord);

function BCM2710GPIOInputGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;

function BCM2710GPIOInputWait(GPIO:PGPIODevice; Pin,Trigger,Timeout:LongWord):LongWord;

function BCM2710GPIOInputEvent(GPIO:PGPIODevice; Pin,Trigger,Flags,Timeout:LongWord; Callback:TGPIOCallback; Data:Pointer):LongWord;

function BCM2710GPIOInputCancel(GPIO:PGPIODevice; Pin:LongWord):LongWord;

function BCM2710GPIOOutput?et(GPIO:PGPIODevice; Pin,Level:LongWord):LongWord;

function BCM2710GPIOPullSelect(GPIO:PGPIODevice; Pin,Mode:LongWord):LongWord;

function BCM2710GPIOFunctionGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;

function BCM2710GPIOFunctionSelect(GPIO:PGPIODevice; Pin,Mode:LongWord):LongWord;

procedure BCM2710GPIOInterruptHandler(Bank:PBCM2710GPIOBank);

procedure BCM2710GPIOEventTrigger(Pin:PGPIOPin);

procedure BCM2710GPIOEventTimeout(Event:PGPIOEvent);

BCM2710 UART0 functions

function BCM2710UART0Open(UART:PUARTDevice; BaudRate,DataBits,StopBits,Parity,FlowControl:LongWord):LongWord;

function BCM2710UART0Close(UART:PUARTDevice):LongWord;

function BCM2710UART0Read(UART:PUARTDevice; Buffer:Pointer; Size,Flags:LongWord; var Count:LongWord):LongWord;

function BCM2710UART0Write(UART:PUARTDevice; Buffer:Pointer; Size,Flags:LongWord; var Count:LongWord):LongWord;

function BCM2710UART0Status(UART:PUARTDevice):LongWord;

procedure BCM2710UART0InterruptHandler(UART:PUARTDevice);

procedure BCM2710UART0Receive(UART:PUARTDevice);

procedure BCM2710UART0Transmit(UART:PUARTDevice);

BCM2710 SDHCI functions

function BCM2710SDHCIHostStart(SDHCI:PSDHCIHost):LongWord;

function BCM2710SDHCIHostStop(SDHCI:PSDHCIHost):LongWord;

function BCM2710SDHCIHostReadByte(SDHCI:PSDHCIHost; Reg:LongWord):Byte;

function BCM2710SDHCIHostReadWord(SDHCI:PSDHCIHost; Reg:LongWord):Word;

function BCM2710SDHCIHostReadLong(SDHCI:PSDHCIHost; Reg:LongWord):LongWord;

procedure BCM2710SDHCIHostWriteByte(SDHCI:PSDHCIHost; Reg:LongWord; Value:Byte);

procedure BCM2710SDHCIHostWriteWord(SDHCI:PSDHCIHost; Reg:LongWord; Value:Word);

procedure BCM2710SDHCIHostWriteLong(SDHCI:PSDHCIHost; Reg:LongWord; Value:LongWord);

procedure BCM2710SDHCIInterruptHandler(SDHCI:PSDHCIHost);

function BCM2710SDHCISetupInterrupts(SDHCI:PSDHCIHost):LongWord;

function BCM2710MMCDeviceGetCardDetect(MMC:PMMCDevice):LongWord;

BCM2710 Clock functions

function BCM2710ClockRead(Clock:PClockDevice):LongWord;

function BCM2710ClockRead64(Clock:PClockDevice):Int64;

BCM2710 ARM Timer functions

function BCM2710ARMTimerStart(Timer:PTimerDevice):LongWord;

function BCM2710ARMTimerStop(Timer:PTimerDevice):LongWord;

function BCM2710ARMTimerRead64(Timer:PTimerDevice):Int64;

function BCM2710ARMTimerWait(Timer:PTimerDevice):LongWord;

function BCM2710ARMTimerEvent(Timer:PTimerDevice; Flags:LongWord; Callback:TTimerCallback; Data:Pointer):LongWord;

function BCM2710ARMTimerCancel(Timer:PTimerDevice):LongWord;

function BCM2710ARMTimer?etRate(Timer:PTimerDevice; Rate:LongWord):LongWord;

function BCM2710ARMTimer?etInterval(Timer:PTimerDevice; Interval:LongWord):LongWord;

procedure BCM2710ARMTimerInterruptHandler(Timer:PTimerDevice);

procedure BCM2710ARMTimerEventTrigger(Timer:PTimerDevice);

BCM2710 random functions

function BCM2710RandomStart(Random:PRandomDevice):LongWord;

function BCM2710RandomStop(Random:PRandomDevice):LongWord;

function BCM2710RandomReadLongWord(Random:PRandomDevice):LongWord;

BCM2710 watchdog functions

function BCM2710WatchdogStart(Watchdog:PWatchdogDevice):LongWord;

function BCM2710WatchdogStop(Watchdog:PWatchdogDevice):LongWord;

function BCM2710WatchdogRefresh(Watchdog:PWatchdogDevice):LongWord;

function BCM2710WatchdogGetRemain(Watchdog:PWatchdogDevice):LongWord;

BCM2710 framebuffer functions

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

function BCM2710FramebufferRelease(Framebuffer:PFramebufferDevice):LongWord;

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

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

function BCM2710FramebufferWaitSync(Framebuffer:PFramebufferDevice):LongWord;

function BCM2710Framebuffer?etOff?et(Framebuffer:PFramebufferDevice; X,Y:LongWord; Pan:Boolean):LongWord;

function BCM2710FramebufferGetPalette(Framebuffer:PFramebufferDevice; Palette:PFramebufferPalette):LongWord;

function BCM2710Framebuffer?etPalette(Framebuffer:PFramebufferDevice; Palette:PFramebufferPalette):LongWord;

function BCM2710Framebuffer?etBacklight(Framebuffer:PFramebufferDevice; Brightness:LongWord):LongWord;

function BCM2710Framebuffer?etProperties(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;

Return to Unit Reference