前言
SPI(Serial Peripheral Interface)是一種應用廣泛的通信總線,通常微處理器上會內建SPI子產品以支援該通信協定,輸出正确的信号的時序,并保證時序間同步,實作與外部SPI裝置正常通信。當需要使用微處理器上SPI子產品,但發現引腳被占用時,那麼可以通過SPI Bit-banging這個方法,通過GPIO端口模拟SPI接口引腳(CS、MOSI、MISO、CLK)上的時序信号來實作SPI協定,與對應SPI裝置進行通信。以下為MT7688晶片的SPI讀寫時序圖。本文主要介紹如何在嵌入式linux發行版平台上實作SPI Bit-banging功能。
![](https://img.laitimes.com/img/_0nNw4CM6IyYiwiM6ICdiwiI4VGbjlGdyF2XjBDMygDMldzM3IjY10COyczNxgDMwAjMvwVM4AzLcBDMy8CXt92YuQHb1FmZ05WZtdWZz5yYpRXY0NXLldWYtl2Lc9CX6MHc0RHaiojIsJye.jpg)
裝置樹文法和格式
- 嵌入式linux系統引入了裝置樹(Device Tree)機制,采用這種資料結構将硬體資訊組織成DTS(Device Tree source)檔案用于描述闆級裝置。裝置樹由基本單元——節點(node)組織成樹狀結構,一個裝置樹隻有一個根節點(root node),根節點中可包含若幹子節點,每個子節點可以同時包含若幹屬性和下一級子節點,屬性用于描述了節點的具體特征。
- 以下為.dts檔案中最基本的樹結構,“/”表示根節點,根節點下的兩個子節點分别為“node1”和“node2”,“node1”和“node2”又各自包含了子節點,如“child-node1”和“child-node2”。檔案中若幹鍵-值對,為分散在裝置樹中的屬性。
- / {
- node1 {
- a- string- property = "A string";
- a- string-list- property = "first string", "second string";
- a-byte-data- property = [ ];
- child-node1 {
- first-child- property;
- second-child- property = < >;
- a- string- property = "Hello, world";
- };
- child-node2 {
- };
- };
- node2 {
- an- empty- property;
- a-cell- property = < >; /* each number (cell) is a uint32 */
- child-node1 {
- };
- };
- };
由于以上的.dts檔案并沒有描述任何硬體裝置的特征,下面以openwrt發行版上的MT7628dts檔案為例對裝置樹進行具體說明。每個節點以“<名稱>[@<裝置位址>]”形式命名,當該節點描述的裝置存在裝置位址時需在名稱後加上主位址,同時節點中以reg=<位址1 長度1] [位址2 長度2] [位址3 長度3] ... >方式列出裝置使用的位址範圍,父節點的 #address-cells 和 #size-cells 屬性聲明reg中各字段的數量。節點中的compatible屬性表示使用哪個裝置驅動綁定到目前節點描述的裝置上。
- Mt7628an.dtsi檔案部分代碼:
- / {
- #address-cells = <1>;
- #size-cells = <1>;
- compatible = "ralink,mtk7628an-soc";
- cpus {
- cpu@ {
- compatible = "mips,mips24KEc";
- };
- };
- chosen {
- bootargs = "console=ttyS0,57600";
- };
- ......
- palmbus: palmbus@ {
- compatible = "palmbus";
- reg = < >;
- ranges = < >;
- #address-cells = <1>;
- #size-cells = <1>;
- sysc: sysc@ {
- compatible = "ralink,mt7620a-sysc";
- reg = < >;
- };
- gpio@ {
- #address-cells = <1>;
- #size-cells = <0>;
- compatible = "mtk,mt7628-gpio", "mtk,mt7621-gpio";
- reg = < >;
- interrupt-parent = <&intc>;
- interrupts = < >;
- gpio0: bank@ {
- reg = < >;
- compatible = "mtk,mt7621-gpio-bank";
- gpio-controller;
- #gpio-cells = <2>;
- };
- gpio1: bank@ {
- reg = < >;
- compatible = "mtk,mt7621-gpio-bank";
- gpio-controller;
- #gpio-cells = <2>;
- };
- gpio2: bank@ {
- reg = < >;
- compatible = "mtk,mt7621-gpio-bank";
- gpio-controller;
- #gpio-cells = <2>;
- };
- };
- spi0: [email protected] {
- compatible = "ralink,mt7621-spi";
- reg = < >;
- resets = <&rstctrl >;
- reset-names = "spi";
- #address-cells = <1>;
- #size-cells = <0>;
- pinctrl-names = "default";
- pinctrl = <&spi_pins>;
- status = "disabled";
- };
- ......
- };
- pinctrl: pinctrl {
- compatible = "ralink,rt2880-pinmux";
- pinctrl-names = "default";
- pinctrl = <&state_default>;
- state_default: pinctrl0 {
- };
- spi_pins: spi {
- spi {
- ralink,group = "spi";
- ralink,function = "spi";
- };
- };
- spi_cs1_pins: spi_cs1 {
- spi_cs1 {
- ralink,group = "spi cs1";
- ralink,function = "spi cs1";
- };
- };
- ......
- };
- };
SPI Bit-banging實作
嵌入式Linux核心中已提供SPI Bit-banging驅動代碼,隻需進行對應的配置即可使用。
首先在openwrt_widora-master/target/linux/ramips/dts路徑下修改Widora.dts檔案,将配置代碼加入根節點中,并且在pinctrl中将Spis功能的引腳申明為GPIO引腳,驅動檔案為drivers/spi路徑下的spi-gpio.c,函數中注冊的驅動名稱為spi_gpio,與 compatible屬性對應。
- dts檔案部分代碼:
- gpio-spi {
- status = "okay";
- compatible = "spi-gpio";
- #address-cells = <0x1>;
- ranges;
- gpio-sck = <&gpio0 >;
- gpio-miso = <&gpio0 >;
- gpio-mosi = <&gpio0 >;
- cs-gpios = <&gpio0 >;
- num-chipselects = < >;
- }
- spi-gpio.c檔案部分代碼:
- #define DRIVER_NAME "spi_gpio"
- static struct platform_driver spi_gpio_driver = {
- .driver = {
- .name = DRIVER_NAME,
- .owner = THIS_MODULE,
- .of_match_table = of_match_ptr(spi_gpio_dt_ids),
- },
- .probe = spi_gpio_probe,
- .remove = spi_gpio_remove,
- };
- module_platform_driver(spi_gpio_driver);
其次在OpenWrt的配置界面中選擇Kernel modules–> SPI Support –>kmod-spi-gpio,選中後會自動關聯 kmod-spi-bitbang子產品。
最後編譯核心并燒錄固件。核心啟動後通過lsmod指令檢視已經加載到核心中的子產品的狀态資訊,可發現核心已經加載了spi_bitbang和spi_gpio子產品。
在spi-gpio.c檔案的spi_gpio_probe函數加入printk語句觀察可獲悉到spi-gpio驅動在啟動時被加載運作,并且從dts檔案中擷取到定義為SPI Bit-banging功能的GPIO引腳。
結論
SPI的bit-bang方式實作SPI協定雖然可以不依賴于控制器上的SPI外設子產品,但是需要代碼完成時序邏輯和同步要求,相對來說性能低于控制器自身的SPI子產品,是以僅适用于低速要求的應用場合。