Difference between revisions of "Quartz64 Model A using a PCF8574"

From PINE64
Jump to navigation Jump to search
m (→‎Device Tree Changes: move regs to appropriate place)
(interrupts and buttons)
Line 57: Line 57:


'''Note:''' be sure to change the A0, A1 and A2 pins accordingly to set the addresses of the daisy chained modules! For example, for the second module, pull A0 high and leave A1 and A2 low. The address pins work like a binary counter, so 000 -> 001 -> 010 -> 011 -> 100 -> ...
'''Note:''' be sure to change the A0, A1 and A2 pins accordingly to set the addresses of the daisy chained modules! For example, for the second module, pull A0 high and leave A1 and A2 low. The address pins work like a binary counter, so 000 -> 001 -> 010 -> 011 -> 100 -> ...
=== Interrupts ===
The PCF8574 will pull its <tt>INT</tt> pin low when one of its inputs changed. We can use this to generate an interrupt:
&i2c3 {
status = "okay";
pcf8574: pcf8574@20 {
compatible = "nxp,pcf8574";
reg = <0x20>;
gpio-controller;
#gpio-cells = <2>;
interrupt-parent = <&gpio0>;
interrupts = <RK_PC1 IRQ_TYPE_EDGE_FALLING>;
interrupt-controller;
#interrupt-cells = <2>;
};
};
In this case, we use GPIO0 Pin C1 (<tt>RK_PC1</tt> with <tt>interrupt-parent</tt> gpio0), a.k.a. UART0_TX, a.k.a. pin 12, as the interrupt pin. ('''Note:''' You cannot use pin 7 here, as it's pulled high.)
To know which <tt>RK_PXX</tt> and which <tt>interrupt-parent</tt> correspond to which pin on the board, consult the schematics.


== Hooking Up The Module ==
== Hooking Up The Module ==
Line 79: Line 102:


If you are daisy-chaining the modules, you'll see an additional gpiochip with 8 lines for each additional module.
If you are daisy-chaining the modules, you'll see an additional gpiochip with 8 lines for each additional module.
=== Testing The Pins As Outputs ===


To test whether this is working, you can connect an LED between a pin (in this example, 4) of your PCF8574, and ground. Then (assuming your chip number is 5) you can use <code>sudo gpioset -B pull-down 5 4=0</code> to turn off the pin and set its bias mode to be pulled down, and use <code>sudo gpioset 5 4=1</code> to turn it on and <code>sudo gpioset 5 4=0</code> to turn it off. Connecting an LED with no resistor in-line should be fine because the pins deliver like 100mA current at most.
To test whether this is working, you can connect an LED between a pin (in this example, 4) of your PCF8574, and ground. Then (assuming your chip number is 5) you can use <code>sudo gpioset -B pull-down 5 4=0</code> to turn off the pin and set its bias mode to be pulled down, and use <code>sudo gpioset 5 4=1</code> to turn it on and <code>sudo gpioset 5 4=0</code> to turn it off. Connecting an LED with no resistor in-line should be fine because the pins deliver like 100mA current at most.
=== Programmatically Driving The Pins ===


'''TODO:''' Expand this section with how to control the pins programmatically using libgpiod or whatever.
'''TODO:''' Expand this section with how to control the pins programmatically using libgpiod or whatever.
=== Adding A Button To Send A Key Code ===
In this example, we're adding a button that's hooked between the input pin 0 and ground, and making it type W whenever it's pressed.
/ {
...
'''keyboard {'''
'''compatible = "gpio-keys";'''
'''w_key {'''
'''gpios = <&pcf8574 0 GPIO_ACTIVE_LOW>;'''
'''linux,code = <17>;'''
'''label = "W_KEY";'''
'''};'''
'''};'''
...
};
The label here isn't the defining bit but the [https://github.com/torvalds/linux/blob/master/include/uapi/linux/input-event-codes.h input event code] is. 17 is for W. You can also include the header file on top and use the symbol name <tt>KEY_W</tt>
Note that you will need to have your PCF8574 set up with interrupts for this.


[[Category:Quartz64]] [[Category:Guide]]
[[Category:Quartz64]] [[Category:Guide]]

Revision as of 12:27, 1 December 2021

In this article, we'll go over how to hook up a PCF8574 I2C I/O extender to a Quartz64 Model A single-board computer, including what device tree changes to make and how to control it.

Introduction To The PCF8574

The PCF8574 is a fairly ubiquitous GPIO extender that communicates through the I2C bus. You can find modules featuring it from many vendors on the usual marketplaces for cheap. It exposes 8 additional GPIO lines, and can be daisy chained to up to 8 devices, giving you an additional 64 GPIO outputs. Combining it with 8 PCF8574A modules will actually push this to a total of 128 GPIO outputs added to your board!

The PCF8574 has a mainline Linux driver, meaning that you do not need to use I2C directly to control it; it will just appear as another /dev/gpiochip<n> device. A lot of Raspberry Pi focused guides for this chip get this precise thing wrong actually, and have the user manually fiddle with the bus.

Device Tree Changes

To control the chip, you'll need to modify your board's device tree—a description of its hardware for devices that don't automatically enumerate—so that the kernel knows how to load the driver.

The easiest way to go about this is to get a copy of the Linux kernel source code from https://kernel.org that matches your kernel version (uname -a), as the device tree definitions live in the Linux kernel repository. Technically, device trees should be compatible across kernel versions, but I wouldn't gamble on it.

Once you have the kernel source, you can use your local configuration: run zcat /proc/config.gz > .config inside the top-level directory of the Linux kernel source tree to use your running kernel's configuration. Then run make xconfig (or one of the other non-graphical alternatives, like nconfig or menuconfig), save the configuration to set any new options to their default values, and then also ensure that CONFIG_GPIO_PCF857X (a.k.a. "PCF857x, PCA{85,96}7x, and MAX732[89] I2C GPIO expanders") is either set to "M" or "Y".

In arch/arm64/boot/dts/rockchip/rk3566-quartz64-a.dts, add the following section:

&i2c3 {
	status = "okay";
 
	pcf8574: pcf8574@20 {
		compatible = "nxp,pcf8574";
		reg = <0x20>;
		gpio-controller;
		#gpio-cells = <2>;
	};
};

This lets the kernel know that there's a PCF8574 hanging off the third I2C controller, and is listening on slave address 0x20 (decimal: 32). Be sure to use tabs of size 8 for the indentation, this is the style the kernel uses.

Now run make dtbs to compile the device tree. This should give you a arch/arm64/boot/dts/rockchip/rk3566-quartz64-a.dtb, which you can then copy into your /boot/dtbs/ as for example quartz-with-pcf8574.dtb or something like that. Then, in your extlinux.conf, either add a new boot label or modify your existing boot labels FDT line to point towards this dtb file, with the path being relative to /boot and not to /.

Daisy Chaining

As previously stated, you can hook up multiple of these modules onto the same bus. Here's how the device tree changes for this will look like:

&i2c3 {
	status = "okay";

	pcf8574_1: pcf8574@20 {
		compatible = "nxp,pcf8574";
		reg = <0x20>;
		gpio-controller;
		#gpio-cells = <2>;
	};

	pcf8574_2: pcf8574@21 {
		compatible = "nxp,pcf8574";
		reg = <0x21>;
		gpio-controller;
		#gpio-cells = <2>;
	};
};

Notice how the labels (the part before the colon) have been differentiated, and the address (number after the @ and number in the reg field) has changed for the second module.

Note: be sure to change the A0, A1 and A2 pins accordingly to set the addresses of the daisy chained modules! For example, for the second module, pull A0 high and leave A1 and A2 low. The address pins work like a binary counter, so 000 -> 001 -> 010 -> 011 -> 100 -> ...

Interrupts

The PCF8574 will pull its INT pin low when one of its inputs changed. We can use this to generate an interrupt:

&i2c3 {
	status = "okay";

	pcf8574: pcf8574@20 {
		compatible = "nxp,pcf8574";
		reg = <0x20>;
		gpio-controller;
		#gpio-cells = <2>;
		interrupt-parent = <&gpio0>;
		interrupts = <RK_PC1 IRQ_TYPE_EDGE_FALLING>;
		interrupt-controller;
		#interrupt-cells = <2>;
	};
};

In this case, we use GPIO0 Pin C1 (RK_PC1 with interrupt-parent gpio0), a.k.a. UART0_TX, a.k.a. pin 12, as the interrupt pin. (Note: You cannot use pin 7 here, as it's pulled high.)

To know which RK_PXX and which interrupt-parent correspond to which pin on the board, consult the schematics.

Hooking Up The Module

Hook up SDA to pin number 3 of your board, and SCL to pin number 5. Connect GND to ground, e.g. pin number 9, and VCC to 3.3V, for example pin number 1. If your module has an interrupt pin, you can leave it unconnected for now; producing interrupts when pin states change is an advanced topic we will expand on later.

TODO: Put photo of hooked up module here.

Using The GPIOs

Upon booting your board with your modified device tree blob, you should have an additional /dev/gpiochip<n> device, most likely /dev/gpiochip5. You can verify this by running libgpiod's gpioinfo utility, which should now show you an additional GPIO chip with only 8 lines.

gpiochip5 - 8 lines:
        line   0:      unnamed       unused   input  active-high 
        line   1:      unnamed       unused   input  active-high 
        line   2:      unnamed       unused   input  active-high 
        line   3:      unnamed       unused   input  active-high 
        line   4:      unnamed       unused   input  active-high 
        line   5:      unnamed       unused   input  active-high 
        line   6:      unnamed       unused   input  active-high 
        line   7:      unnamed       unused   input  active-high

If you are daisy-chaining the modules, you'll see an additional gpiochip with 8 lines for each additional module.

Testing The Pins As Outputs

To test whether this is working, you can connect an LED between a pin (in this example, 4) of your PCF8574, and ground. Then (assuming your chip number is 5) you can use sudo gpioset -B pull-down 5 4=0 to turn off the pin and set its bias mode to be pulled down, and use sudo gpioset 5 4=1 to turn it on and sudo gpioset 5 4=0 to turn it off. Connecting an LED with no resistor in-line should be fine because the pins deliver like 100mA current at most.

Programmatically Driving The Pins

TODO: Expand this section with how to control the pins programmatically using libgpiod or whatever.

Adding A Button To Send A Key Code

In this example, we're adding a button that's hooked between the input pin 0 and ground, and making it type W whenever it's pressed.

/ {
	...

	keyboard {
		compatible = "gpio-keys";

		w_key {
			gpios = <&pcf8574 0 GPIO_ACTIVE_LOW>;
			linux,code = <17>;
			label = "W_KEY";
		};
	};

	...
};

The label here isn't the defining bit but the input event code is. 17 is for W. You can also include the header file on top and use the symbol name KEY_W

Note that you will need to have your PCF8574 set up with interrupts for this.