bcm283x

package

v3.6.7+incompatible Latest Latest Go to latest Published: Dec 29, 2020 License: Apache-2.0 Imports: 19 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/meandrewdev/periph

Links

Open Source Insights

Documentation ¶

Overview ¶

Package bcm283x exposes the BCM283x GPIO functionality.

This driver implements memory-mapped GPIO pin manipulation and leverages sysfs-gpio for edge detection.

If you are looking for the actual implementation, open doc.go for further implementation details.

GPIOs ¶

Aliases for GPCLK0, GPCLK1, GPCLK2 are created for corresponding CLKn pins. Same for PWM0_OUT and PWM1_OUT, which point respectively to PWM0 and PWM1.

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Nanospin ¶

func Nanospin(t time.Duration)

Nanospin spins the CPU without calling into the kernel code if possible.

func PinsClear0To31 ¶

func PinsClear0To31(mask uint32)

PinsClear0To31 clears the value of GPIO0 to GPIO31 pin for the bit set at their corresponding bit as a single write operation.

This function is extremely fast and does no error checking.

Example ¶

package main

import (
	"log"

	"periph.io/x/periph/host"
	"periph.io/x/periph/host/bcm283x"
)

func main() {
	// Make sure periph is initialized.
	if _, err := host.Init(); err != nil {
		log.Fatal(err)
	}

	// Simultaneously clears GPIO4 and GPIO16 to gpio.Low.
	bcm283x.PinsClear0To31(1<<16 | 1<<4)
}

Output:

func PinsClear32To46 ¶

func PinsClear32To46(mask uint32)

PinsClear32To46 clears the value of GPIO31 to GPIO46 pin for the bit set at their corresponding 'bit minus 32' as a single write operation.

This function is extremely fast and does no error checking.

Bits above 15 are ignored.

This function is not recommended on Raspberry Pis as these GPIOs are not easily accessible.

func PinsRead0To31 ¶

func PinsRead0To31() uint32

PinsRead0To31 returns the value of all GPIO0 to GPIO31 at their corresponding bit as a single read operation.

This function is extremely fast and does no error checking.

The returned bits are valid for both inputs and outputs.

Example ¶

package main

import (
	"fmt"
	"log"

	"periph.io/x/periph/host"
	"periph.io/x/periph/host/bcm283x"
)

func main() {
	// Make sure periph is initialized.
	if _, err := host.Init(); err != nil {
		log.Fatal(err)
	}

	// Print out the state of 32 GPIOs with a single read that reads all these
	// pins all at once.
	bits := bcm283x.PinsRead0To31()
	fmt.Printf("bits: %#x\n", bits)
	suffixes := []string{"   ", "\n"}
	for i := uint(0); i < 32; i++ {
		fmt.Printf("GPIO%-2d: %d%s", i, (bits>>i)&1, suffixes[(i%4)/3])
	}
}

Output:

bits: 0x80011010
GPIO0 : 0   GPIO1 : 0   GPIO2 : 0   GPIO3 : 0
GPIO4 : 1   GPIO5 : 0   GPIO6 : 0   GPIO7 : 0
GPIO8 : 0   GPIO9 : 0   GPIO10: 0   GPIO11: 0
GPIO12: 1   GPIO13: 0   GPIO14: 0   GPIO15: 0
GPIO16: 1   GPIO17: 0   GPIO18: 0   GPIO19: 0
GPIO20: 0   GPIO21: 0   GPIO22: 0   GPIO23: 0
GPIO24: 0   GPIO25: 0   GPIO26: 0   GPIO27: 0
GPIO28: 0   GPIO29: 0   GPIO30: 0   GPIO31: 1

func PinsRead32To46 ¶

func PinsRead32To46() uint32

PinsRead32To46 returns the value of all GPIO32 to GPIO46 at their corresponding 'bit minus 32' as a single read operation.

This function is extremely fast and does no error checking.

The returned bits are valid for both inputs and outputs.

Bits above 15 are guaranteed to be 0.

This function is not recommended on Raspberry Pis as these GPIOs are not easily accessible.

func PinsSet0To31 ¶

func PinsSet0To31(mask uint32)

PinsSet0To31 sets the value of GPIO0 to GPIO31 pin for the bit set at their corresponding bit as a single write operation.

Example ¶

package main

import (
	"log"

	"periph.io/x/periph/host"
	"periph.io/x/periph/host/bcm283x"
)

func main() {
	// Make sure periph is initialized.
	if _, err := host.Init(); err != nil {
		log.Fatal(err)
	}

	// Simultaneously sets GPIO4 and GPIO16 to gpio.High.
	bcm283x.PinsClear0To31(1<<16 | 1<<4)
}

Output:

func PinsSet32To46 ¶

func PinsSet32To46(mask uint32)

PinsSet32To46 sets the value of GPIO31 to GPIO46 pin for the bit set at their corresponding 'bit minus 32' as a single write operation.

This function is extremely fast and does no error checking.

Bits above 15 are ignored.

This function is not recommended on Raspberry Pis as these GPIOs are not easily accessible.

func PinsSetup0To27 ¶

func PinsSetup0To27(drive physic.ElectricCurrent, slewLimit, hysteresis bool) error

PinsSetup0To27 sets the output current drive strength, output slew limiting and input hysteresis for GPIO 0 to 27.

Default drive is 8mA, slew unlimited and hysteresis enabled.

Can only be used if driver bcm283x-dma was loaded.

Example ¶

package main

import (
	"fmt"
	"log"

	"periph.io/x/periph/conn/physic"
	"periph.io/x/periph/host/bcm283x"
)

func main() {
	if err := bcm283x.PinsSetup0To27(16*physic.MilliAmpere, true, true); err != nil {
		log.Fatal(err)
	}
	fmt.Printf("drive:      %s", bcm283x.GPIO0.Drive())
	fmt.Printf("slew:       %t", bcm283x.GPIO0.SlewLimit())
	fmt.Printf("hysteresis: %t", bcm283x.GPIO0.Hysteresis())
}

Output:

func PinsSetup28To45 ¶

func PinsSetup28To45(drive physic.ElectricCurrent, slewLimit, hysteresis bool) error

PinsSetup28To45 sets the output current drive strength, output slew limiting and input hysteresis for GPIO 28 to 45.

Default drive is 16mA, slew unlimited and hysteresis enabled.

Can only be used if driver bcm283x-dma was loaded.

This function is not recommended on Raspberry Pis as these GPIOs are not easily accessible.

func Present ¶

func Present() bool

Present returns true if running on a Broadcom bcm283x based CPU.

func ReadTime ¶

func ReadTime() time.Duration

ReadTime returns the time on a monotonic 1Mhz clock (1µs resolution).

It only works if bcm283x-dma successfully loaded. Otherwise it returns 0.

Types ¶

type Pin ¶

type Pin struct {
	// contains filtered or unexported fields
}

Pin is a GPIO number (GPIOnn) on BCM238(5|6|7).

Pin implements gpio.PinIO.

var (
	GPIO0  *Pin // I2C0_SDA
	GPIO1  *Pin // I2C0_SCL
	GPIO2  *Pin // I2C1_SDA
	GPIO3  *Pin // I2C1_SCL
	GPIO4  *Pin // CLK0
	GPIO5  *Pin // CLK1
	GPIO6  *Pin // CLK2
	GPIO7  *Pin // SPI0_CS1
	GPIO8  *Pin // SPI0_CS0
	GPIO9  *Pin // SPI0_MISO
	GPIO10 *Pin // SPI0_MOSI
	GPIO11 *Pin // SPI0_CLK
	GPIO12 *Pin // PWM0
	GPIO13 *Pin // PWM1
	GPIO14 *Pin // UART0_TX, UART1_TX
	GPIO15 *Pin // UART0_RX, UART1_RX
	GPIO16 *Pin // UART0_CTS, SPI1_CS2, UART1_CTS
	GPIO17 *Pin // UART0_RTS, SPI1_CS1, UART1_RTS
	GPIO18 *Pin // I2S_SCK, SPI1_CS0, PWM0
	GPIO19 *Pin // I2S_WS, SPI1_MISO, PWM1
	GPIO20 *Pin // I2S_DIN, SPI1_MOSI, CLK0
	GPIO21 *Pin // I2S_DOUT, SPI1_CLK, CLK1
	GPIO22 *Pin //
	GPIO23 *Pin //
	GPIO24 *Pin //
	GPIO25 *Pin //
	GPIO26 *Pin //
	GPIO27 *Pin //
	GPIO28 *Pin // I2C0_SDA, I2S_SCK
	GPIO29 *Pin // I2C0_SCL, I2S_WS
	GPIO30 *Pin // I2S_DIN, UART0_CTS, UART1_CTS
	GPIO31 *Pin // I2S_DOUT, UART0_RTS, UART1_RTS
	GPIO32 *Pin // CLK0, UART0_TX, UART1_TX
	GPIO33 *Pin // UART0_RX, UART1_RX
	GPIO34 *Pin // CLK0
	GPIO35 *Pin // SPI0_CS1
	GPIO36 *Pin // SPI0_CS0, UART0_TX
	GPIO37 *Pin // SPI0_MISO, UART0_RX
	GPIO38 *Pin // SPI0_MOSI, UART0_RTS
	GPIO39 *Pin // SPI0_CLK, UART0_CTS
	GPIO40 *Pin // PWM0, SPI2_MISO, UART1_TX
	GPIO41 *Pin // PWM1, SPI2_MOSI, UART1_RX
	GPIO42 *Pin // CLK1, SPI2_CLK, UART1_RTS
	GPIO43 *Pin // CLK2, SPI2_CS0, UART1_CTS
	GPIO44 *Pin // CLK1, I2C0_SDA, I2C1_SDA, SPI2_CS1
	GPIO45 *Pin // PWM1, I2C0_SCL, I2C1_SCL, SPI2_CS2
	GPIO46 *Pin //

)

All the pins supported by the CPU.

func (*Pin) DefaultPull ¶

func (p *Pin) DefaultPull() gpio.Pull

DefaultPull implements gpio.PinIn.

The CPU doesn't return the current pull.

func (*Pin) Drive ¶

func (p *Pin) Drive() physic.ElectricCurrent

Drive returns the configured output current drive strength for this GPIO.

The current drive is configurable per GPIO groups: 0~27 and 28~45.

The default value for GPIOs 0~27 is 8mA and for GPIOs 28~45 is 16mA.

The value is a multiple 2mA between 2mA and 16mA.

Can only be used if driver bcm283x-dma was loaded. Otherwise returns 0.

func (*Pin) FastOut ¶

func (p *Pin) FastOut(l gpio.Level)

FastOut sets a pin output level with Absolutely No error checking.

Out() Must be called once first before calling FastOut(), otherwise the behavior is undefined. Then FastOut() can be used for minimal CPU overhead to reach Mhz scale bit banging.

func (*Pin) FastRead ¶

func (p *Pin) FastRead() gpio.Level

FastRead return the current pin level without any error checking.

This function is very fast. It works even if the pin is set as output.

func (*Pin) Func ¶

func (p *Pin) Func() pin.Func

Func implements pin.PinFunc.

func (*Pin) Function ¶

func (p *Pin) Function() string

Function implements pin.Pin.

func (*Pin) Halt ¶

func (p *Pin) Halt() error

Halt implements conn.Resource.

If the pin is running a clock, PWM or waiting for edges, it is halted.

In the case of clock or PWM, all pins with this clock source are also disabled.

func (*Pin) Hysteresis ¶

func (p *Pin) Hysteresis() bool

Hysteresis returns true if the input hysteresis via a Schmitt trigger is enabled.

The hysteresis is configurable per GPIO groups: 0~27 and 28~45.

The default is true.

Can only be used if driver bcm283x-dma was loaded. Otherwise returns true (the default value).

func (*Pin) In ¶

func (p *Pin) In(pull gpio.Pull, edge gpio.Edge) error

In implements gpio.PinIn.

Specifying a value for pull other than gpio.PullNoChange causes this function to be slightly slower (about 1ms).

For pull down, the resistor is 50KOhm~60kOhm For pull up, the resistor is 50kOhm~65kOhm

The pull resistor stays set even after the processor shuts down. It is not possible to 'read back' what value was specified for each pin.

Will fail if requesting to change a pin that is set to special functionality.

Using edge detection requires opening a gpio sysfs file handle. On Raspbian, make sure the user is member of group 'gpio'. The pin will be exported at /sys/class/gpio/gpio*/. Note that the pin will not be unexported at shutdown.

For edge detection, the processor samples the input at its CPU clock rate and looks for '011' to rising and '100' for falling detection to avoid glitches. Because gpio sysfs is used, the latency is unpredictable.

func (*Pin) Name ¶

func (p *Pin) Name() string

Name implements pin.Pin.

func (*Pin) Number ¶

func (p *Pin) Number() int

Number implements pin.Pin.

This is the GPIO number, not the pin number on a header.

func (*Pin) Out ¶

func (p *Pin) Out(l gpio.Level) error

Out implements gpio.PinOut.

Fails if requesting to change a pin that is set to special functionality.

func (*Pin) PWM ¶

func (p *Pin) PWM(duty gpio.Duty, freq physic.Frequency) error

PWM implements gpio.PinOut.

It outputs a periodic signal on supported pins without CPU usage.

PWM pins ¶

PWM0 is exposed on pins 12, 18 and 40. However, PWM0 is used for generating clock for DMA and unavailable for PWM.

PWM1 is exposed on pins 13, 19, 41 and 45.

PWM1 uses 25Mhz clock source. The frequency must be a divisor of 25Mhz.

DMA driven PWM is available for all pins except PWM1 pins, its resolution is 200KHz which is down-sampled from 25MHz clock above. The number of DMA driven PWM is limited.

Furthermore, these can only be used if the drive "bcm283x-dma" was loaded. It can only be loaded if the process has root level access.

The user must call either Halt(), In(), Out(), PWM(0,..) or PWM(gpio.DutyMax,..) to stop the clock source and DMA engine before exiting the program.

func (*Pin) Pull ¶

func (p *Pin) Pull() gpio.Pull

Pull implements gpio.PinIn.

bcm2711/bcm2838 support querying the pull resistor of all GPIO pins. Prior to it, bcm283x doesn't support querying the pull resistor of any GPIO pin.

func (*Pin) Read ¶

func (p *Pin) Read() gpio.Level

Read implements gpio.PinIn.

This function is fast. It works even if the pin is set as output.

func (*Pin) SetFunc ¶

func (p *Pin) SetFunc(f pin.Func) error

SetFunc implements pin.PinFunc.

func (*Pin) SlewLimit ¶

func (p *Pin) SlewLimit() bool

SlewLimit returns true if the output slew is limited to reduce interference.

The slew is configurable per GPIO groups: 0~27 and 28~45.

The default is true.

Can only be used if driver bcm283x-dma was loaded. Otherwise returns false (the default value).

func (*Pin) StreamIn ¶

func (p *Pin) StreamIn(pull gpio.Pull, s gpiostream.Stream) error

StreamIn implements gpiostream.PinIn.

DMA driven StreamOut is available for GPIO0 to GPIO31 pin and the maximum resolution is 200kHz.

func (*Pin) StreamOut ¶

func (p *Pin) StreamOut(s gpiostream.Stream) error

StreamOut implements gpiostream.PinOut.

I2S/PCM driven StreamOut is available for GPIO21 pin. The resolution is up to 250MHz.

For GPIO0 to GPIO31 except GPIO21 pin, DMA driven StreamOut is available and the maximum resolution is 200kHz.

func (*Pin) String ¶

func (p *Pin) String() string

String implements conn.Resource.

func (*Pin) SupportedFuncs ¶

func (p *Pin) SupportedFuncs() []pin.Func

SupportedFuncs implements pin.PinFunc.

func (*Pin) WaitForEdge ¶

func (p *Pin) WaitForEdge(timeout time.Duration) bool

WaitForEdge implements gpio.PinIn.

Notes ¶

Bugs ¶

PWM(): There is no conflict verification when multiple pins are used simultaneously. The last call to PWM() will affect all pins of the same type (CLK0, CLK2, PWM0 or PWM1).

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
bcm283xsmoketest Package bcm283xsmoketest verifies that bcm283x specific functionality work.	Package bcm283xsmoketest verifies that bcm283x specific functionality work.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Documentation ¶

Overview ¶

GPIOs ¶

Datasheet ¶

Index ¶

Examples ¶

Constants ¶

Variables ¶

Functions ¶

func Nanospin ¶

func PinsClear0To31 ¶

func PinsClear32To46 ¶

func PinsRead0To31 ¶

func PinsRead32To46 ¶

func PinsSet0To31 ¶

func PinsSet32To46 ¶

func PinsSetup0To27 ¶

func PinsSetup28To45 ¶

func Present ¶

func ReadTime ¶

Types ¶

type Pin ¶

func (*Pin) DefaultPull ¶

func (*Pin) Drive ¶

func (*Pin) FastOut ¶

func (*Pin) FastRead ¶

func (*Pin) Func ¶

func (*Pin) Function ¶

func (*Pin) Halt ¶

func (*Pin) Hysteresis ¶

func (*Pin) In ¶

func (*Pin) Name ¶

func (*Pin) Number ¶

func (*Pin) Out ¶

func (*Pin) PWM ¶

PWM pins ¶

func (*Pin) Pull ¶

func (*Pin) Read ¶

func (*Pin) SetFunc ¶

func (*Pin) SlewLimit ¶

func (*Pin) StreamIn ¶

func (*Pin) StreamOut ¶

func (*Pin) String ¶

func (*Pin) SupportedFuncs ¶

func (*Pin) WaitForEdge ¶

Notes ¶

Bugs ¶

Source Files ¶

Directories ¶