Adafruit-Blinkaを使ってみる

新しいボードの追加

Adafruit-Blinkaはチップ(=マイクロコントローラー)とボードの検出に Adafruit_Python_PlatformDetectライブラリを使っています。
PlatformDetectが新しいチップ(=マイクロコントローラー)とボードを検出できるようになったら、
Blinkaに新しいマイクロコントローラーとボードを追加することができます。
そこで、Blinkaに新しいマイクロコントローラーとボードを追加する手順を紹介します。

マイクロコントローラーとはSoCのことで例えばAllwinner H3やAllwinner A64などです。
同じSoCを使っているボードは多数あります。
例えばOrangePi PC、OrangePi ZERO、NanoPi NEOなどはAllwinner H3を採用しています。
ボードとはOrangePi PC、OrangePi ZERO、NanoPi NEOのことです。
Adafruit-Blinkaはマイクロコントローラー定義を参照してボード定義を決定します。

Blinkaライブラリへのマイクロコントローラーとボードの追加は以下の手順で行います。
・対応状況の確認
・マイクロコントローラー定義の追加
・ボード定義の追加
・ボード検出処理の追加

pipを使ってAdafruit-Blinkaをインストールした場合、ライブラリは以下のディレクトリにインストールされます。
$HOME/.local/lib/python3.10/site-packages/adafruit_blinka
pipを使ってインストールしたファイルと、githubのmasterブランチのファイルは一部差分が有ります。

$ python3 -m pip install Adafruit-Blinka

$ git clone https://github.com/adafruit/Adafruit_Blinka

$ diff $HOME/Adafruit_Blinka/src/board.py $HOME/.local/lib/python3.10/site-packages
14c14
< __version__ = "0.0.0+auto.0"
---
> __version__ = "8.39.2"

そこで、githubのmasterブランチを正として、あらかじめこの差分を無くしておきます。
これをこの時点でやっておかないと、テスト後の処理が面倒になります。

$ cd $HOME/Adafruit_Blinka/src

              $ cp board.py $HOME/.local/lib/python3.10/site-packages/

これ以降、以下のディレクトリを基準のディレクトリとします。

$ cd
              $HOME/.local/lib/python3.10/site-packages

◇対応状況の確認
以下のスクリプトを実行することで対応状況を確認することができます。

$ cat boards.py

              import board

              print(vars(board))

ライブラリが対応してないときは以下のエラーになります。

◇マイクロコントローラー定義の追加
「microcontroller/チップベンダー/チップ名」のディレクトリを作成し、そのディレクトリ内に __init__.py pin.py の２つのファイルを作成します。
既にチップベンダーのディレクトリが存在している場合、既存のディレクトリの下にチップ名のディレクトリを作成します。
今回はrockchipの下にrv1106を追加しました。

$ cd
              adafruit_blinka/microcontroller/rockchip

              

              $ mkdir rv1106

__init__.pyは以下のようなファイルでチップ名だけを記載します。

# SPDX-FileCopyrightText: 2021 Melissa
              LeBlanc-Williams for Adafruit Industries

              #

              # SPDX-License-Identifier: MIT

              """Definition for the Rockchip RV1106 chip"""

pin.pyは以下の様なファイルで、そのチップが提供するGPIO、SPI、I2C、UART、PWM、ADCの情報を定義します。
ここが一番面倒なところです。
RV11606を採用しているLockfox Pico Maxには、こんなに沢山のピンヘッダーは出ていませんが、RV1106がサポートしてるピンを全て定義します。
GPIO以外の定義については後述します。

# SPDX-FileCopyrightText: 2022 ShangYun

              #

              # SPDX-License-Identifier: MIT

              """A Pin class for use with Rockchip RV1106."""

              from
              adafruit_blinka.microcontroller.generic_linux.libgpiod_pin
              import Pin

              

              # GPIOx_yz = x * 32 + y * 8 + z

              # y: A -> 0, B -> 1, C -> 2, D -> 3

              

              GPIO0_A0 = Pin((0, 0))

              GPIO0_A1 = Pin((0, 1))

              GPIO0_A2 = Pin((0, 2))

              GPIO0_A3 = Pin((0, 3))

              GPIO0_A4 = Pin((0, 4))

              GPIO0_A5 = Pin((0, 5))

              GPIO0_A6 = Pin((0, 6))

              GPIO0_A7 = Pin((0, 7))

              GPIO0_B0 = Pin((0, 8))

              GPIO0_B1 = Pin((0, 9))

              GPIO0_B2 = Pin((0, 10))

              GPIO0_B3 = Pin((0, 11))

              GPIO0_B4 = Pin((0, 12))

              GPIO0_B5 = Pin((0, 13))

              GPIO0_B6 = Pin((0, 14))

              GPIO0_B7 = Pin((0, 15))

              GPIO0_C0 = Pin((0, 16))

              GPIO0_C1 = Pin((0, 17))

              GPIO0_C2 = Pin((0, 18))

              GPIO0_C3 = Pin((0, 19))

              GPIO0_C4 = Pin((0, 20))

              GPIO0_C5 = Pin((0, 21))

              GPIO0_C6 = Pin((0, 22))

              GPIO0_C7 = Pin((0, 23))

              GPIO0_D0 = Pin((0, 24))

              GPIO0_D1 = Pin((0, 25))

              GPIO0_D2 = Pin((0, 26))

              GPIO0_D3 = Pin((0, 27))

              GPIO0_D4 = Pin((0, 28))

              GPIO0_D5 = Pin((0, 29))

              GPIO0_D6 = Pin((0, 30))

              GPIO0_D7 = Pin((0, 31))

              GPIO1_A0 = Pin((1, 0))

              GPIO1_A1 = Pin((1, 1))

              GPIO1_A2 = Pin((1, 2))

              GPIO1_A3 = Pin((1, 3))

              GPIO1_A4 = Pin((1, 4))

              GPIO1_A5 = Pin((1, 5))

              GPIO1_A6 = Pin((1, 6))

              GPIO1_A7 = Pin((1, 7))

              GPIO1_B0 = Pin((1, 8))

              GPIO1_B1 = Pin((1, 9))

              GPIO1_B2 = Pin((1, 10))

              GPIO1_B3 = Pin((1, 11))

              GPIO1_B4 = Pin((1, 12))

              GPIO1_B5 = Pin((1, 13))

              GPIO1_B6 = Pin((1, 14))

              GPIO1_B7 = Pin((1, 15))

              GPIO1_C0 = Pin((1, 16))

              GPIO1_C1 = Pin((1, 17))

              GPIO1_C2 = Pin((1, 18))

              GPIO1_C3 = Pin((1, 19))

              GPIO1_C4 = Pin((1, 20))

              GPIO1_C5 = Pin((1, 21))

              GPIO1_C6 = Pin((1, 22))

              GPIO1_C7 = Pin((1, 23))

              GPIO1_D0 = Pin((1, 24))

              GPIO1_D1 = Pin((1, 25))

              GPIO1_D2 = Pin((1, 26))

              GPIO1_D3 = Pin((1, 27))

              GPIO1_D4 = Pin((1, 28))

              GPIO1_D5 = Pin((1, 29))

              GPIO1_D6 = Pin((1, 30))

              GPIO1_D7 = Pin((1, 31))

              GPIO2_A0 = Pin((2, 0))

              GPIO2_A1 = Pin((2, 1))

              GPIO2_A2 = Pin((2, 2))

              GPIO2_A3 = Pin((2, 3))

              GPIO2_A4 = Pin((2, 4))

              GPIO2_A5 = Pin((2, 5))

              GPIO2_A6 = Pin((2, 6))

              GPIO2_A7 = Pin((2, 7))

              GPIO2_B0 = Pin((2, 8))

              GPIO2_B1 = Pin((2, 9))

              GPIO2_B2 = Pin((2, 10))

              GPIO2_B3 = Pin((2, 11))

              GPIO2_B4 = Pin((2, 12))

              GPIO2_B5 = Pin((2, 13))

              GPIO2_B6 = Pin((2, 14))

              GPIO2_B7 = Pin((2, 15))

              GPIO2_C0 = Pin((2, 16))

              GPIO2_C1 = Pin((2, 17))

              GPIO2_C2 = Pin((2, 18))

              GPIO2_C3 = Pin((2, 19))

              GPIO2_C4 = Pin((2, 20))

              GPIO2_C5 = Pin((2, 21))

              GPIO2_C6 = Pin((2, 22))

              GPIO2_C7 = Pin((2, 23))

              GPIO2_D0 = Pin((2, 24))

              GPIO2_D1 = Pin((2, 25))

              GPIO2_D2 = Pin((2, 26))

              GPIO2_D3 = Pin((2, 27))

              GPIO2_D4 = Pin((2, 28))

              GPIO2_D5 = Pin((2, 29))

              GPIO2_D6 = Pin((2, 30))

              GPIO2_D7 = Pin((2, 31))

              GPIO3_A0 = Pin((3, 0))

              GPIO3_A1 = Pin((3, 1))

              GPIO3_A2 = Pin((3, 2))

              GPIO3_A3 = Pin((3, 3))

              GPIO3_A4 = Pin((3, 4))

              GPIO3_A5 = Pin((3, 5))

              GPIO3_A6 = Pin((3, 6))

              GPIO3_A7 = Pin((3, 7))

              GPIO3_B0 = Pin((3, 8))

              GPIO3_B1 = Pin((3, 9))

              GPIO3_B2 = Pin((3, 10))

              GPIO3_B3 = Pin((3, 11))

              GPIO3_B4 = Pin((3, 12))

              GPIO3_B5 = Pin((3, 13))

              GPIO3_B6 = Pin((3, 14))

              GPIO3_B7 = Pin((3, 15))

              GPIO3_C0 = Pin((3, 16))

              GPIO3_C1 = Pin((3, 17))

              GPIO3_C2 = Pin((3, 18))

              GPIO3_C3 = Pin((3, 19))

              GPIO3_C4 = Pin((3, 20))

              GPIO3_C5 = Pin((3, 21))

              GPIO3_C6 = Pin((3, 22))

              GPIO3_C7 = Pin((3, 23))

              GPIO3_D0 = Pin((3, 24))

              GPIO3_D1 = Pin((3, 25))

              GPIO3_D2 = Pin((3, 26))

              GPIO3_D3 = Pin((3, 27))

              GPIO3_D4 = Pin((3, 28))

              GPIO3_D5 = Pin((3, 29))

              GPIO3_D6 = Pin((3, 30))

              GPIO3_D7 = Pin((3, 31))

              GPIO4_A0 = Pin((4, 0))

              GPIO4_A1 = Pin((4, 1))

              GPIO4_A2 = Pin((4, 2))

              GPIO4_A3 = Pin((4, 3))

              GPIO4_A4 = Pin((4, 4))

              GPIO4_A5 = Pin((4, 5))

              GPIO4_A6 = Pin((4, 6))

              GPIO4_A7 = Pin((4, 7))

              GPIO4_B0 = Pin((4, 8))

              GPIO4_B1 = Pin((4, 9))

              GPIO4_B2 = Pin((4, 10))

              GPIO4_B3 = Pin((4, 11))

              GPIO4_B4 = Pin((4, 12))

              GPIO4_B5 = Pin((4, 13))

              GPIO4_B6 = Pin((4, 14))

              GPIO4_B7 = Pin((4, 15))

              GPIO4_C0 = Pin((4, 16))

              GPIO4_C1 = Pin((4, 17))

              GPIO4_C2 = Pin((4, 18))

              GPIO4_C3 = Pin((4, 19))

              GPIO4_C4 = Pin((4, 20))

              GPIO4_C5 = Pin((4, 21))

              GPIO4_C6 = Pin((4, 22))

              GPIO4_C7 = Pin((4, 23))

              GPIO4_D0 = Pin((4, 24))

              GPIO4_D1 = Pin((4, 25))

              GPIO4_D2 = Pin((4, 26))

              GPIO4_D3 = Pin((4, 27))

              GPIO4_D4 = Pin((4, 28))

              GPIO4_D5 = Pin((4, 29))

              GPIO4_D6 = Pin((4, 30))

              GPIO4_D7 = Pin((4, 31))

              

              # UART

              UART0_TX_M1 = GPIO2_B1

              UART0_RX_M1 = GPIO2_B0

              UART1_TX_M1 = GPIO2_A4

              UART1_RX_M1 = GPIO2_A5

              UART2_TX_M1 = GPIO1_B2

              UART2_RX_M1 = GPIO1_B3

              UART3_TX_M1 = GPIO1_D0

              UART3_RX_M1 = GPIO1_D1

              UART4_TX_M1 = GPIO1_C5

              UART4_RX_M1 = GPIO1_C4

              UART5_TX_M0 = GPIO3_A6

              UART5_RX_M0 = GPIO3_A7

              

              # ordered as uartId, txId, rxId

              uartPorts = (

                  (0, UART0_TX_M1, UART0_RX_M1),

                  (1, UART1_TX_M1, UART2_RX_M1),

                  (2, UART2_TX_M1, UART2_RX_M1),

                  (3, UART3_TX_M1, UART3_RX_M1),

                  (4, UART4_TX_M1, UART4_RX_M1),

                  (5, UART5_TX_M0, UART5_RX_M0),

              )

              

              

              # I2C

              I2C0_SCL_M2 = GPIO3_A4

              I2C0_SDA_M2 = GPIO3_A5

              I2C1_SCL_M1 = GPIO2_B0

              I2C1_SDA_M1 = GPIO2_B1

              I2C3_SCL_M0 = GPIO2_A6

              I2C3_SDA_M0 = GPIO2_A7

              I2C3_SCL_M1 = GPIO1_D3

              I2C3_SDA_M1 = GPIO1_D2

              I2C4_SCL_M0 = GPIO2_A1

              I2C4_SDA_M0 = GPIO2_A0

              

              # ordered as i2cId, sclId, sdaId

              i2cPorts = (

                  (0, I2C0_SCL_M2, I2C0_SDA_M2),

                  (1, I2C1_SCL_M1, I2C1_SDA_M1),

                  (3, I2C3_SCL_M0, I2C3_SDA_M0),

                  (3, I2C3_SCL_M1, I2C3_SDA_M1),

                  (4, I2C4_SCL_M0, I2C4_SDA_M0),

              )

              

              # SPI

              SPI0_MOSI_M0 = GPIO1_C2

              SPI0_MISO_M0 = GPIO1_C3

              SPI0_CLK_M0 = GPIO1_C1

              SPI0_CS0_M0 = GPIO1_C0

              SPI0_CS1_M0 = GPIO1_D2

              

              # ordered as spiId, sckId, mosiId, misoId

              spiPorts = (

                  (0, SPI0_CLK_M0, SPI0_MOSI_M0,
              SPI0_MISO_M0),

              )

              

              # PWM

              PWM5 = GPIO2_B0

              PWM6 = GPIO2_B1

              PWM10 = GPIO1_C6

              PWM11 = GPIO1_C7

              

              # SysFS pwm outputs, pwm channel and pin in first tuple

              pwmOuts = (

                  ((5, 0), PWM5),

                  ((6, 0), PWM6),

                  ((10, 0), PWM10),

                  ((11, 0), PWM11),

              )

              

              # ADC IN

              ADC_IN0 = 0

              ADC_IN1 = 1

              

              # SysFS analog inputs, Ordered as analog analogInId,
              device, and channel

              analogIns = (

                  (ADC_IN0, 0, 0),

                  (ADC_IN1, 0, 1),

              )

この定義は同じマイクロコントローラーを使用している複数のボードから参照されます。
例えばallwinner.h3を採用しているボードは、以下の様に多数存在しています。
これらのボードは全てallwinner.h3のマイクロコントローラーを使用していますが、ボードのピンヘッダーに出ているGPIOポートは
全て同じとは限りません。
ボードサイズの制限などにより、ボードのピンヘッダーに出ているGPIOポートの数とポート番号は違う可能性が有ります。

$ grep -rn "allwinner.h3" *

              bananapi/bpim2zero.py:8:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              bananapi/bpim2plus.py:8:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              nanopi/neoair.py:9:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              nanopi/neo.py:9:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              nanopi/duo2.py:9:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              orangepi/orangepir1.py:6:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              orangepi/orangepizero.py:8:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              orangepi/orangepipc.py:6:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

              tritium-h3.py:6:from
              adafruit_blinka.microcontroller.allwinner.h3 import pin

allwinner.h3は以下の106個のGPIOを持っていますが、これらの中からボードベンダーが必要と考えたものだけを
ピンヘッダーに出しています。
106個全てのGPIOをピンヘッダーに出したら、ボードサイズが超巨大になります。
OrangePi Zeroなどはわずか18個のGPIOしか、ピンヘッダーに出ていません。
・PA0～PA21
・PC0～PC16
・PD0～PD17
・PE0～PE15
・PF0～PF6
・PG0～PG13
・PL0～PL11

◇UARTの追加
データシートなどを参考に、以下の表を埋める必要が有ります。
私はこちらのピン情報を参考にしました。
UART-BUSは重複しても構いませんが、UART-TXとUART-RXの組み合わせはユニークである必要が有ります。

UARTデバイス	UART-BUS	UART-TX	UART-RX
/dev/ttyS0	0	GPIO2_B1	GPIO2_B0
/dev/ttyS1	1	GPIO2_A4	GPIO2_A5
/dev/ttyS2	2	GPIO1_B2	GPIO1_B3
/dev/ttyS3	3	GPIO1_D0	GPIO1_D1
/dev/ttyS4	4	GPIO1_C5	GPIO1_C4
/dev/ttyS5	5	GPIO3_A6	GPIO3_A7

この組み合わせを以下の形式で指定します。

# UART

              UART0_TX_M1 = GPIO2_B1

              UART0_RX_M1 = GPIO2_B0

              UART1_TX_M1 = GPIO2_A4

              UART1_RX_M1 = GPIO2_A5

              UART2_TX_M1 = GPIO1_B2

              UART2_RX_M1 = GPIO1_B3

              UART3_TX_M1 = GPIO1_D0

              UART3_RX_M1 = GPIO1_D1

              UART4_TX_M1 = GPIO1_C5

              UART4_RX_M1 = GPIO1_C4

              UART5_TX_M0 = GPIO3_A6

              UART5_RX_M0 = GPIO3_A7

              

              # ordered as uartId, txId, rxId

              uartPorts = (

                  (0, UART0_TX_M1, UART0_RX_M1),

                  (1, UART1_TX_M1, UART2_RX_M1),

                  (2, UART2_TX_M1, UART2_RX_M1),

                  (3, UART3_TX_M1, UART3_RX_M1),

                  (4, UART4_TX_M1, UART4_RX_M1),

                  (5, UART5_TX_M0, UART5_RX_M0),

              )

実際にUARTデバイスを使うときはTXとRXを指定します。
ライブラリ内部で、この定義を元に、BUSを求め、
/dev/ttyS{BUS}の形式に変換してデバイスを制御します。

◇I2Cの追加
データシートなどを参考に、以下の表を埋める必要が有ります。
私はこちらのピン情報を参考にしました。
I2C-BUSは重複しても構いませんが、I2C-SCLとI2C-SDAの組み合わせはユニークである必要が有ります。

I2Cデバイス	I2C-BUS	I2C-SCL	I2C-SDA
/dev/i2c-0	0	GPIO3_A4	GPIO3_A5
/dev/i2c-1	1	GPIO2_B0	GPIO2_B1
/dev/i2c-3	3	GPIO2_A6	GPIO2_A7
/dev/i2c-3	3	GPIO1_D3	GPIO1_D2
/dev/i2c-4	4	GPIO2_A1	GPIO2_A0

この組み合わせを以下の形式で指定します。

# I2C

              I2C0_SCL_M2 = GPIO3_A4

              I2C0_SDA_M2 = GPIO3_A5

              I2C1_SCL_M1 = GPIO2_B0

              I2C1_SDA_M1 = GPIO2_B1

              I2C3_SCL_M0 = GPIO2_A6

              I2C3_SDA_M0 = GPIO2_A7

              I2C3_SCL_M1 = GPIO1_D3

              I2C3_SDA_M1 = GPIO1_D2

              I2C4_SCL_M0 = GPIO2_A1

              I2C4_SDA_M0 = GPIO2_A0

              

              # ordered as i2cId, sclId, sdaId

              i2cPorts = (

                  (0, I2C0_SCL_M2, I2C0_SDA_M2),

                  (1, I2C1_SCL_M1, I2C1_SDA_M1),

                  (3, I2C3_SCL_M0, I2C3_SDA_M0),

                  (3, I2C3_SCL_M1, I2C3_SDA_M1),

                  (4, I2C4_SCL_M0, I2C4_SDA_M0),

              )

実際にI2Cデバイスを使うときはSCLとSDLを指定します。
ライブラリ内部で、この定義を元に、BUSを求め、
/dev/i2c-{BUS}の形式に変換してデバイスを制御します。

◇SPIの追加
データシートなどを参考に、以下の表を埋める必要が有ります。
私はこちらのピン情報を参考にしました。
SPI-BUSとSPI-DEVの組み合わせと、CLK/MOSI/MISOの組み合わせはユニークである必要が有ります。

SPIデバイス	SPI-BUS	SPI-DEV	SPI-CLK	SPI-MOSI	SPI-MISO
/dev/spidev0.0	0	0	GPIO1_C1	GPIO1_C2	GPIO1_C3

この組み合わせを以下の形式で指定します。
CSの指定は無くても構いません。
またSPI-DEVが0の時は、この指定を省略することができます。

# SPI

              SPI0_MOSI_M0 = GPIO1_C2

              SPI0_MISO_M0 = GPIO1_C3

              SPI0_CLK_M0 = GPIO1_C1

              SPI0_CS0_M0 = GPIO1_C0

              SPI0_CS1_M0 = GPIO1_D2

              

              # ordered as spiId, sckId, mosiId, misoId

              spiPorts = (

                  (0, SPI0_CLK_M0, SPI0_MOSI_M0,
              SPI0_MISO_M0),

              )

実際にSPIデバイスを使うときはCLK/MOSI/MISOを指定します。
ライブラリ内部で、この定義を元に、BUSとDEVを求め、
DEVの定義が無いときはDEV=0を使います。
/dev/spidev{BUS}.{DEV}の形式に変換してデバイスを制御します。

◇PWMの追加
ハードウェアPWMをサポートしているマイクロコントローラーではPWMの定義を行いますが、
Linuxのファイルシステムを使用して sysfs PWM ライブラリを使用するか、メーカーが提供するカスタムドライバーを使用することができます。
メーカーのカスタムドライバーは多種多様で、ここでは割愛(と言うか説明できません)します。
ファイルシステムがPWMをサポートしているかどうかは、以下のコマンドで確認することができます。
このコマンドで何も表示されなければ、LinuxのファイルシステムはPWMをサポートしていません。

$ ls /sys/class/pwm/pwmchip*

              /sys/class/pwm/pwmchip10:

              device  export  npwm  power 
              subsystem  uevent  unexport

              

              /sys/class/pwm/pwmchip11:

              device  export  npwm  power 
              subsystem  uevent  unexport

              

              /sys/class/pwm/pwmchip5:

              device  export  npwm  power 
              subsystem  uevent  unexport

              

              /sys/class/pwm/pwmchip6:

              device  export  npwm  power 
              subsystem  uevent  unexport

LinuxのファイルシステムはPWMをPWMチップ番号とPWMチャネル番号で識別します。
上の例ではチップ番号=10/11/5/6があることが分かります。
以下のコマンドで各PWMチップが持つチャネル数を確認することができます。

$ cat /sys/class/pwm/pwmchip10/npwm

              1

              

              $ cat /sys/class/pwm/pwmchip11/npwm

              1

              

              $ cat /sys/class/pwm/pwmchip5/npwm

              1

              

              $ cat /sys/class/pwm/pwmchip6/npwm

              1

上の例では全てのPWMチップが１つだけチャネルを持っていることが分かります。
チャネル番号は０から始まる番号なので、以下の組み合わせが完成します。

PWMチップ番号	PWMチャネル番号	PWMインデックス名	PWMインデックス値
5	0
6	0
10	0
11	0

上の表にPWMインデックス名をアサインします。
名前は何でも構わないので今回は、チップ番号を元に以下の様にしました。

PWMチップ番号	PWMチャネル番号	PWMインデックス名	PWMインデックス値
5	0	PWM5
6	0	PWM6
10	0	PWM10
11	0	PWM11

PWMインデックス名は必ずユニークにする必要が有ります。
今回は各チップがサポートするPWMチャネル数が全て1だったので、この名前で問題ないですが、
PWMチャネル数が複数の時は以下の様にする必要が有ります。

PWMチップ番号	PWMチャネル番号	PWMインデックス名	PWMインデックス値
5	0	PWM5_1
5	1	PWM5_2
6	0	PWM6_0
6	1	PWM6_1
10	0	PWM10_0
10	1	PWM10_1
11	0	PWM11_0
11	1	PWM11_1

最後にPWMインデックス名に値を設定します。
インデックスの値はユニークな値であれば何でも構いません。
今回はGPIO番号をアサインしましたが、5/6/10/11の定数でも構いません。

PWMチップ番号	PWMチャネル番号	PWMインデックス名	PWMインデックス値
5	0	PWM5	GPIO2_B0
6	0	PWM6	GPIO2_B1
10	0	PWM10	GPIO1_C6
11	0	PWM11	GPIO1_C7

この組み合わせを以下の形式で指定します。

# PWM

              PWM5 = GPIO2_B0

              PWM6 = GPIO2_B1

              PWM10 = GPIO1_C6

              PWM11 = GPIO1_C7

              

              # SysFS pwm outputs, pwm channel and pin in first tuple

              pwmOuts = (

                  ((5, 0), PWM5),

                  ((6, 0), PWM6),

                  ((10, 0), PWM10),

                  ((11, 0), PWM11),

              )

pwmOutsを定義した時はpwmio.pyでPWMOutクラスを追加します。

elif
              detector.board.any_luckfox_pico_board:

                  from
              adafruit_blinka.microcontroller.generic_linux.sysfs_pwmout
              import PWMOut

実際にハードウェアPWMを使うときはPWMのインデックス値を指定します。
ライブラリ内部で、PWMのインデックス値を元に、PWMチップ番号とPWMチャネル番号を求め、
PWMチップ番号とPWMチャネル番号を使ってデバイスを制御します。
このスクリプトを実行するとPWM6(=/sys/class/pwm/pwmchip6)に接続したLEDの輝度がゆっくり変わります。
スクリプトを終了する際には、deinit()でPWMポートを開放する必要が有ります。

#!/usr/bin/python

              #-*- encoding: utf-8 -*-

              import time

              import pwmio

              import board

              import argparse

              

              parser = argparse.ArgumentParser()

              parser.add_argument('-p', '--pwm', type=int, help='PWM to
              blink', default=6)

              args = parser.parse_args()

              pwm = "board.PWM{}".format(args.pwm)

              print("pwm={}".format(pwm))

              

              #pwm = pwmio.PWMOut(eval("board.PWM6"))

              pwm = pwmio.PWMOut(eval(pwm))

              

              while True:

                  try:

                      for cycle in
              range(0, 65535, 10):  # Cycles through the full PWM
              range from 0 to 65535

                         

















              pwm.duty_cycle = cycle  # Cycles the LED pin duty
              cycle through the range of values

                         

















              #time.sleep(0.05)

              

                      for cycle in
              range(65534, 0, -10):  # Cycles through the PWM range
              backwards from 65534 to 0

                         

















              pwm.duty_cycle = cycle  # Cycles the LED pin duty
              cycle through the range of values

                         

















              #time.sleep(0.05)

                  except KeyboardInterrupt:

                      break

              

              pwm.duty_cycle = 0

              pwm.deinit()

◇ADCの追加
LinuxのADCはIIO Subsystem(IIO System Interface)でサポートされるようになりました。
この実装は比較的歴史が浅く、メチャクチャ、デバイスドライバーの作り方に依存します。
代表的なデバイスドライバーにADC、DAC、IMU、コンパス、温度センサーなどが有ります。
ファイルシステムがADCをサポートしているかどうかは、以下のコマンドで確認することができます。

$ ls /sys/bus/iio/devices/iio\:device*

              buffer  in_voltage0_raw  in_voltage_scale 
              of_node  scan_elements  trigger

              dev     in_voltage1_raw 
              name             

power   
subsystem     

























              uevent

              

              $ cat /sys/bus/iio/devices/iio\:device0/in_voltage0_raw

              1022

              

              $ cat /sys/bus/iio/devices/iio\:device0/in_voltage1_raw

              1022

              

              $ cat /sys/bus/iio/devices/iio\:device0/in_voltage_scale

              1.757812500

このコマンドで何も表示されなければ、LinuxのファイルシステムはADCをサポートしていません。
LinuxのファイルシステムはADCをADCデバイス番号とADCチャネル番号で識別します。
ADCデバイス番号はdeviceXの部分で、上の例では0がADCデバイス番号となります。
１つのADCデバイスは複数のADCチャネルをサポートします。
各デバイスがサポートするADCチャネル数はin_voltageX_rowの部分で、上の例ではデバイス番号=0は0/1の2チャネルを持っていることが分かります。
ADCデバイスに対しては、これ以外にin_voltage_scaleやin_voltage_rangeなどのデバイスが規定されていますが、
全チャネル共通のin_voltage_scale/in_voltage_rangeとして実装されていたり、
各チャネル個別のin_voltage0_scale/in_voltage1_scale/in_voltage0_rang /in_voltage1_rangとして実装されていたりとまちまちです。
実際上の例でもin_voltage_scaleは実装されていますが、in_voltage_rangeは実装されていません。
そのような背景で、Adafruit-Blinkaはin_voltage0_raw/in_voltage1_rawだけをサポートします。

in_voltage0_rawから読み取った値は生の値です。
この値を電圧に変換するときはin_voltage_scaleを使いますが、この値も１ビット当たりの[V]だったり、１ビット当たりの [mV]だったりとまちまちです。
上の例では１ビット当たりの[mV]が定義されているので、実際の電圧は
in_voltage0_raw * in_voltage_scale [mV]
となります。

上の例では１つのADCデバイスが２つのチャネルを持っているので、以下の組み合わせが完成します。

ADCデバイス番号	ADCチャネル番号	ADCインデックス名	ADCインデックス値
0	0
0	1

上の表にADCインデックス名をアサインします。
名前は何でも構わないので今回は、チャネル番号を元に以下の様にしました。

ADCチップ番号	ADCチャネル番号	ADCインデックス名	ADCインデックス値
0	0	ADC_IN0	0
0	1	ADC_IN1	1

最後にADCインデックス名に値を設定します。
インデックス値はユニークな値であれば何でも構いません。
今回はADCチャネル番号をアサインしました。
この組み合わせを以下の形式で指定します。
このボードはアナログ入力ポートしかありませんが、アナログ出力ポートが有るときは、analogOutsを同様の形式で指定します。

# ADC IN

              ADC_IN0 = 0

              ADC_IN1 = 1

              

              # SysFS analog inputs, Ordered as analog analogInId,
              device, and channel

              analogIns = (

                      (ADC_IN0, 0,
              0),

                      (ADC_IN1, 0,
              1),

              )

analogInsを定義した時はanalogio.pyでAnalogInクラスを追加します。

elif detector.chip.RV1106:

                  from
              adafruit_blinka.microcontroller.generic_linux.sysfs_analogin
              import AnalogIn

analogOutsも定義した時はanalogio.pyでAnalogOutクラスを追加します。

elif
              detector.board.any_siemens_simatic_iot2000:

                  from
              adafruit_blinka.microcontroller.am65xx.analogio import
              AnalogIn

                  from
              adafruit_blinka.microcontroller.am65xx.analogio import
              AnalogOut

実際にADCを使うときはADCのインデックス値を指定します。
ライブラリ内部で、ADCのインデックス値を元に、ADCデバイス番号とADCチャネル番号を求め、
ADCデバイス番号とADCチャネル番号を使ってデバイスを制御します。
このスクリプトを実行するADC_IN0（=/sys/bus/iio/devices/iio\:device0 /in_voltage0_raw)の値を読み取ります。
1.757812500はin_voltage_scaleの値で、これを使って電圧値に変換しています。

# SPDX-FileCopyrightText: 2021 Melissa
              LeBlanc-Williams for Adafruit Industries

              #

              # SPDX-License-Identifier: MIT

              """Analog in demo"""

              import time

              import board

              from analogio import AnalogIn

              

              analog_in = AnalogIn(board.ADC_IN0)

              

              def get_voltage(pin):

                      return
              (pin.value * 1.757812500) / 1000

              

              while True:

                      try:

                             




















              print("value = {}".format(analog_in.value))

                             




















              print("voltage = {}".format(get_voltage(analog_in)))

                             




















              time.sleep(1.0)

                      except
              KeyboardInterrupt:

                             




















              break

ボリュームを使ってGPIO4_C0に加える電圧を変えると、読み取った値と変換した電圧値を表示します。

$ sudo -E python3 ./analog.py

              value = 860

              voltage = 1.543359375

              value = 864

              voltage = 1.51875

              value = 817

              voltage = 1.434375

              value = 755

              voltage = 1.346484375

              value = 666

              voltage = 1.18125

              value = 591

              voltage = 1.044140625

              value = 528

              voltage = 0.931640625

              value = 520

LinuxのADCについては、こちらやこちらに例が公開されています。
この２つを見てもファイルシステムの実装が違うのが分かります。

◇ボード定義の追加
「adafruit_blinka/borad/ボード名.py」のファイルを作成し、そのボードで使用することが出来るGPIOポートを定義します。
ボードがシリーズ製品の場合は、「adafruit_blinka/borad/シリーズ名/ボード名.py」となります。
今回は「borad/luckfox」のディレクトリを作成し、ここに以下のボード定義ファイルを追加しました。
LuckFox Pico ProとLuckFox Pico Maxは、メモリサイズが違うだけなので同じボードとして認識され、ボード定義はどちらもluckfoxpico_max.pyを使います。
・adafruit_blinka/borad/luckfox/luckfoxpico.py
・adafruit_blinka/borad/luckfox/luckfoxpico_mini.py
・adafruit_blinka/borad/luckfox/luckfoxpico_plus.py
・adafruit_blinka/borad/luckfox/luckfoxpico_max.py

以下が今回追加したluckfoxpico_max.pyです。
pinオブジェクトは「microcontroller/rockchip/rv1106/pin.py」から取り込みます。
GPIOポートの名前はGxxでもIOxxでもGPIOxxでも何でも構いません。
注意点として、この定義にSCLとSDAが無いとi2cが使えません。
また、この定義にSCLK、MOSI、MISOが無いとSPIが使えません。
SPIのチップセレクトについてはこのライブラリは何も関与しません。
/dev/spidev0.0の様にCS0ポートがCSとして使われている場合、このライブラリではCS0のポートは使えません。
今回はG48がCS0に該当します。

# SPDX-FileCopyrightText: 2021 Melissa
              LeBlanc-Williams for Adafruit Industries

              #

              # SPDX-License-Identifier: MIT

              """Pin definitions for the Lockfox Pico Pro/Max."""

              

              from adafruit_blinka.microcontroller.rockchip.rv1106
              import pin

              

              G42 = pin.GPIO1_B2

              G43 = pin.GPIO1_B3

              G55 = pin.GPIO1_C7

              G54 = pin.GPIO1_C6

              G53 = pin.GPIO1_C5

              G52 = pin.GPIO1_C4

              G58 = pin.GPIO1_D2

              G59 = pin.GPIO1_D3

              G73 = pin.GPIO2_B1

              G48 = pin.GPIO1_C0 # This port is in use as CS0. This port
              is not available.

              G49 = pin.GPIO1_C1

              G50 = pin.GPIO1_C2

              G51 = pin.GPIO1_C3

              G72 = pin.GPIO2_B0

              G56 = pin.GPIO1_D0

              G57 = pin.GPIO1_D1

              G68 = pin.GPIO2_A4

              G69 = pin.GPIO2_A5

              G64 = pin.GPIO2_A0

              G65 = pin.GPIO2_A1

              G66 = pin.GPIO2_A2

              G67 = pin.GPIO2_A3

              G70 = pin.GPIO2_A6

              G71 = pin.GPIO2_A7

              

              # UART

              UART3_TX = pin.UART3_TX_M1

              UART3_RX = pin.UART3_RX_M1

              UART4_TX = pin.UART4_TX_M1

              UART4_RX = pin.UART4_RX_M1

              

              # Default UART

              TX = UART3_TX

              RX = UART3_RX

              TXD = UART3_TX

              RXD = UART3_RX

              

              # I2C

              I2C3_SCL = pin.I2C3_SCL_M1

              I2C3_SDA = pin.I2C3_SDA_M1

              

              # Default I2C

              SCL = I2C3_SCL

              SDA = I2C3_SDA

              

              # SPI

              SPI0_MISO = pin.SPI0_MISO_M0

              SPI0_MOSI = pin.SPI0_MOSI_M0

              SPI0_SCLK = pin.SPI0_CLK_M0

              SPI0_CS0 = pin.SPI0_CS0_M0

              SPI0_CS1 = pin.SPI0_CS1_M0

              

              # Default SPI

              MISO = SPI0_MISO

              MOSI = SPI0_MOSI

              SCLK = SPI0_SCLK

              

              # PWM

              PWM5 = pin.PWM5

              PWM6 = pin.PWM6

              PWM10 = pin.PWM10

              PWM11 = pin.PWM11

              

              # ADC

              ADC_IN0 = pin.ADC_IN0

              ADC_IN1 = pin.ADC_IN1

LuckFox Pico MaxにはI2Cが3組ありますが、実際に使えるのはI2C3_SCL/I2C3_SDA です。
そこで、これをデフォルトI2Cとしています。

同様に、LuckFox Pico MaxにはUARTが5組ありますが、実際に使えるのはUART3/UART4です。
そこで、UART3をデフォルトUARTとしています。

こちらがluckfoxpico_mini.pyです。ピン数が少ないのでさすがに小さいです。

# SPDX-FileCopyrightText: 2021 Melissa
              LeBlanc-Williams for Adafruit Industries

              #

              # SPDX-License-Identifier: MIT

              """Pin definitions for the Lockfox Pico Mini."""

              

              from adafruit_blinka.microcontroller.rockchip.rv1106
              import pin

              

              G42 = pin.GPIO1_B2

              G43 = pin.GPIO1_B3

              G48 = pin.GPIO1_C0 # This port is in use as CS0. This port
              is not available.

              G49 = pin.GPIO1_C1

              G50 = pin.GPIO1_C2

              G51 = pin.GPIO1_C3

              G52 = pin.GPIO1_C4

              G53 = pin.GPIO1_C5

              G56 = pin.GPIO1_D0

              G57 = pin.GPIO1_D1

              G58 = pin.GPIO1_D2

              G59 = pin.GPIO1_D3

              G54 = pin.GPIO1_C6

              G55 = pin.GPIO1_C7

              G4 = pin.GPIO0_A4

              

              # UART

              UART3_TX = pin.UART3_TX_M1

              UART3_RX = pin.UART3_RX_M1

              UART4_TX = pin.UART4_TX_M1

              UART4_RX = pin.UART4_RX_M1

              

              # Default UART

              TX = UART3_TX

              RX = UART3_RX

              TXD = UART3_TX

              RXD = UART3_RX

              

              # I2C

              I2C3_SCL = pin.I2C3_SCL_M1

              I2C3_SDA = pin.I2C3_SDA_M1

              

              # Default I2C

              SCL = I2C3_SCL

              SDA = I2C3_SDA

              

              # SPI

              SPI0_MISO = pin.SPI0_MISO_M0

              SPI0_MOSI = pin.SPI0_MOSI_M0

              SPI0_SCLK = pin.SPI0_CLK_M0

              SPI0_CS0 = pin.SPI0_CS0_M0

              SPI0_CS1 = pin.SPI0_CS1_M0

              

              # Default SPI

              MISO = SPI0_MISO

              MOSI = SPI0_MOSI

              SCLK = SPI0_SCLK

              

              # PWM

              PWM10 = pin.PWM10

              PWM11 = pin.PWM11

              

              # ADC

              ADC_IN0 = pin.ADC_IN0

              ADC_IN1 = pin.ADC_IN1

◇ボード判定処理の追加
「boards.py」にボード判定処理を追加します。
board_idはPlatformDetectが検出したボードIDです。
ap.boardはPlatformDetectに定義されている全てのボードの集合体です。
今回は以下の4つのボード判定処理を追加しました。

elif board_id == ap_board.LUCKFOX_PICO:

                  from
              adafruit_blinka.board.luckfox.luckfoxpico import *

              

              elif board_id == ap_board.LUCKFOX_PICO_MINI:

                  from
              adafruit_blinka.board.luckfox.luckfoxpico_mini import *

              

              elif board_id == ap_board.LUCKFOX_PICO_PLUS:

                  from
              adafruit_blinka.board.luckfox.luckfoxpico_plus import *

              

              elif board_id == ap_board.LUCKFOX_PICO_MAX:

                  from
              adafruit_blinka.board.luckfox.luckfoxpico_max import *

◇マイクロコントローラー情報の追加
以下のファイルに新しく追加したマイクロコントローラーの情報(rockchip.rv1106)を追加します。
microcontroller/pin.py と microcontroller/__init__.py は非常によく似た内容ですが、i2cとSPIを使うときにインポートされます。

digitalio.py:141:   
              from adafruit_blinka.microcontroller.rockchip.rv1106.pin
              import Pin

              microcontroller/pin.py:145:    from
              adafruit_blinka.microcontroller.rockchip.rv1106.pin import
              *

              microcontroller/__init__.py:150:    from
              adafruit_blinka.microcontroller.rockchip.rv1106 import *

以下のスクリプトを実行することで修正結果を確認することができます。

$ cat boards.py

              import board

              print(vars(board))

このスクリプトを実行してエラーにならなければ、新しいマイクロコントローラーとボードの追加は完了です。
boardオブジェクトのメンバー変数が表示されます。

動作確認が終わったら、変更したファイルをgithubのマスターリポジトリに反映する手続きを行います。
githubのリポジトリは以下の4種類に分類されます。
・master-remoteリポジトリ　所有者は作者様(今回はAdafruit)です。
・master-localリポジトリ　master-remoteリポジトリをローカル環境にcloneしたリポジトリで、変更しても master-remoteリポジトリに反映できません。
・fork-remoteリポジトリ　master-remoteリポジトリをforkしたリポジトリで、所有者は貴方になります。
・fork-localリポジトリ　fork-remoteリポジトリをローカル環境にcloneしたリポジトリで、変更した内容をfork- remoteリポジトリに反映することができます。

githubのmasterリポジトリの変更は以下の手順で行います。
・master-remoteリポジトリ(ここ)をforkして fork-remoteリポジトリを作る。
・fork-remoteリポジトリをローカルにcloneしてfork-localリポジトリを作る。
・fork-localリポジトリで修正、テストを行う。
・fork-localリポジトリの修正結果をfork-remoteリポジトリに反映する。
・fork-remoteリポジトリの変更をmaster-remoteリポジトリに反映する。(PullRequestを発行して作者に承認、反映してもらう)

Adafruitのこのレポジトリを開いてリポジトリをforkします。
これで自分のアカウントにfork-remoteリポジトリが追加されます。
fork-remoteリポジトリの所有者は貴方なので、新しいBranchを作ることもできます。
fork-remoteリポジトリをローカル環境(自分のPC)にcloneします。
master-remoteリポジトリをcloneする場合も、fork-remoteリポジトリをcloneする場合も、clone先のディレクトリは同じになるので
事前にmaster-localリポジトリは削除しておきます。
fork-localリポジトリとpipでインストールしたパッケージとの関係は以下の様になります。
これが、pipでインストールしたパッケージの内容です。

$ ls -l
              $HOME/.local/lib/python3.10/site-packages/*.py

              -rw-rw-r-- 1 pico pico  18781 Jun  1 14:59
              /home/pico/.local/lib/python3.10/site-packages/adafruit_bmp280.py

              -rw-rw-r-- 1 pico pico  13970 May 30 13:45
/home/pico/.local/lib/python3.10/site-packages/adafruit_connection_manager.py

              -rw-rw-r-- 1 pico pico  24905 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/adafruit_requests.py

              -rw-rw-r-- 1 pico pico   3230 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/analogio.py

              -rw-rw-r-- 1 pico pico   4535 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/bitbangio.py

              -rw-rw-r-- 1 pico pico  14448 Jun  1 12:28
              /home/pico/.local/lib/python3.10/site-packages/board.py

              -rw-rw-r-- 1 pico pico  22233 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/busio.py

              -rw-rw-r-- 1 pico pico   9895 Jun  1 14:36
/home/pico/.local/lib/python3.10/site-packages/digitalio.py

              -rw-rw-r-- 1 pico pico  18823 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/keypad.py

              -rw-rw-r-- 1 pico pico    626 May 30 13:45
/home/pico/.local/lib/python3.10/site-packages/micropython.py

              -rw-rw-r-- 1 pico pico   1360 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/neopixel_write.py

              -rw-rw-r-- 1 pico pico   1326 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/onewireio.py

              -rw-rw-r-- 1 pico pico    918 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/pulseio.py

              -rw-rw-r-- 1 pico pico   2597 Jun  1 14:54
              /home/pico/.local/lib/python3.10/site-packages/pwmio.py

              -rw-rw-r-- 1 pico pico   1181 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/rainbowio.py

              -rw-rw-r-- 1 pico pico 133435 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/typing_extensions.py

              -rw-rw-r-- 1 pico pico  24778 May 30 13:45
              /home/pico/.local/lib/python3.10/site-packages/usb_hid.py

              

              $ ls -l
              $HOME/.local/lib/python3.10/site-packages/adafruit_blinka/

              total 20

              -rw-rw-r--  1 pico pico 2385 May 30 13:45 __init__.py

              drwxrwxr-x  2 pico pico 4096 May 30 13:45 __pycache__

              drwxrwxr-x  3 pico pico 4096 May 30 13:45 agnostic

              drwxrwxr-x 22 pico pico 4096 Jun  1 14:47 board

              drwxrwxr-x 37 pico pico 4096 May 30 13:45 microcontroller

これが、fork-localリポジトリの内容です。

$ ls -l $HOME/Adafruit_Blinka/src/*.py

              -rw-rw-r-- 1 pico pico   186 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/__version__.py

              -rw-rw-r-- 1 pico pico  3230 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/analogio.py

              -rwxrwxr-x 1 pico pico  4535 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/bitbangio.py

              -rw-rw-r-- 1 pico pico 14337 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/board.py

              -rw-rw-r-- 1 pico pico 22233 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/busio.py

              -rw-rw-r-- 1 pico pico  9796 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/digitalio.py

              -rw-rw-r-- 1 pico pico 18823 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/keypad.py

              -rwxrwxr-x 1 pico pico   626 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/micropython.py

              -rw-rw-r-- 1 pico pico  1360 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/neopixel_write.py

              -rw-rw-r-- 1 pico pico  1326 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/onewireio.py

              -rw-rw-r-- 1 pico pico   918 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/pulseio.py

              -rw-rw-r-- 1 pico pico  2597 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/pwmio.py

              -rw-rw-r-- 1 pico pico  1181 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/rainbowio.py

              -rw-rw-r-- 1 pico pico 24778 Jun  1 10:51
              /home/pico/Adafruit_Blinka/src/usb_hid.py

              

              $ ls -l $HOME/Adafruit_Blinka/src/adafruit_blinka

              total 16

              -rwxrwxr-x  1 pico pico 2385 Jun  1 10:51
              __init__.py

              drwxrwxr-x  2 pico pico 4096 Jun  1 10:51
              agnostic

              drwxrwxr-x 20 pico pico 4096 Jun  1 10:51 board

              drwxrwxr-x 36 pico pico 4096 Jun  1 10:51
              microcontroller

修正したファイルをpipのパッケージディレクトリからlocalリポジトリにコピーします。
ここが一番面倒な部分です。

$ cd
              $HOME/.local/lib/python3.10/site-packages

              

              $ cp board.py $HOME/Adafruit_Blinka/src/

              

              $ cp digitalio.py $HOME/Adafruit_Blinka/src/

              

              $ cp pwmio.py $HOME/Adafruit_Blinka/src/

              

              $ cp analogio.py $HOME/Adafruit_Blinka/src/

              

              $ cp microcontroller/__init__.py
              $HOME/Adafruit_Blinka/src/microcontroller/

              

              $ cp microcontroller/pin.py
              $HOME/Adafruit_Blinka/src/microcontroller/

              

              $ cd adafruit_blinka

              

              $ cp -r board $HOME/Adafruit_Blinka/src/adafruit_blinka/

              

              $ cp -r microcontroller
              $HOME/Adafruit_Blinka/src/adafruit_blinka/

これで、localリポジトリのファイルと、pipでインストールしたパッケージのファイルが一致します。
Adafruitのリポジトリ(master-remoteリポジトリ)はpre-commitというツールで、コーディング規則が決められています。
そこで、localリポジトリのファイルに対して、pre-commitを実行します。

$ python3 -m pip install pre-commit

              

              $ cd $HOME/Adafruit_Blinka

              

              $ pre-commit run --all-files

              [INFO] Initializing environment for
              https://github.com/python/black.

              [INFO] Initializing environment for
              https://github.com/fsfe/reuse-tool.

              [INFO] Initializing environment for
              https://github.com/pre-commit/pre-commit-hooks.

              [INFO] Initializing environment for
              https://github.com/pycqa/pylint.

              [INFO] Installing environment for
              https://github.com/python/black.

              [INFO] Once installed this environment will be reused.

              [INFO] This may take a few minutes...

              [INFO] Installing environment for
              https://github.com/fsfe/reuse-tool.

              [INFO] Once installed this environment will be reused.

              [INFO] This may take a few minutes...

              [INFO] Installing environment for
              https://github.com/pre-commit/pre-commit-hooks.

              [INFO] Once installed this environment will be reused.

              [INFO] This may take a few minutes...

              [INFO] Installing environment for
              https://github.com/pycqa/pylint.

              [INFO] Once installed this environment will be reused.

              [INFO] This may take a few minutes...

black....................................................................Passed

reuse....................................................................Passed

              check
yaml...............................................................Passed

              fix end of
              files.........................................................Passed

              trim trailing
              whitespace.................................................Passed

              pylint (library
              code)....................................................Passed

              pylint (example code)................................(no
              files to check)Skipped

              pylint (test code)...................................(no
              files to check)Skipped

エラーが有るときは、エラーの内容に応じてファイルを修正します。
この様にファイルのインデントや空白の数など、書式に問題があるときは、blackでエラーになります。

# OrangePI

              _ORANGE_PI_IDS = (

                  ORANGE_PI_PC,

                  ORANGE_PI_R1,

                  ORANGE_PI_ZERO,

                  ORANGE_PI_ONE,

                  ORANGE_PI_LITE,

                  ORANGE_PI_PC_PLUS,

                  ORANGE_PI_PLUS_2E,

                  ORANGE_PI_2,

              ORANGE_PI_PC2,

                  ORANGE_PI_ZERO_PLUS_2H5,

                  ORANGE_PI_ZERO_PLUS,

                  ORANGE_PI_ZERO_2,

                  ORANGE_PI_3,

                  ORANGE_PI_3B,

                  ORANGE_PI_3_LTS,

                  ORANGE_PI_4,

                  ORANGE_PI_4_LTS,

                  ORANGE_PI_5,

                  ORANGE_PI_5_PLUS,

              )

これがblackでエラーとなった時のログです。

$ pre-commit run --all-files

black....................................................................Failed

              - hook id: black

              - files were modified by this hook

              

              reformatted adafruit_platformdetect/constants/boards.py

              

              All done! ? ? ?

              葦 file reformatted, 9 files left unchanged.

自動的に正しい書式にフォーマットしてくれます。

# OrangePI

              _ORANGE_PI_IDS = (

                  ORANGE_PI_PC,

                  ORANGE_PI_R1,

                  ORANGE_PI_ZERO,

                  ORANGE_PI_ONE,

                  ORANGE_PI_LITE,

                  ORANGE_PI_PC_PLUS,

                  ORANGE_PI_PLUS_2E,

                  ORANGE_PI_2,

                  ORANGE_PI_PC2,

                  ORANGE_PI_ZERO_PLUS_2H5,

                  ORANGE_PI_ZERO_PLUS,

                  ORANGE_PI_ZERO_2,

                  ORANGE_PI_3,

                  ORANGE_PI_3B,

                  ORANGE_PI_3_LTS,

                  ORANGE_PI_4,

                  ORANGE_PI_4_LTS,

                  ORANGE_PI_5,

                  ORANGE_PI_5_PLUS,

              )

pre-commitはけっこう重いので、環境によっては、修正、テストを実施したSBC上でpre-commitが動かない場合が有ります。
その様なときは、IA64のUbuntuマシンやDebianマシンに、一旦修正ファイルを転送してからpre-commitを実行する必要が有ります。

$ USER="転送先ホストのユーザ名"

              

              $ HOST="192.168.10.20"

              

              $ HOMEX="転送先ホストの$HOME"

              

              $ cd $HOME/.local/lib/python3.10/site-packages

              

              $ scp board.py
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/

              

              $ scp digitalio.py
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/

              

              $ scp pwmio.py
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/

              

              $ scp analogio.py
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/

              

              $ scp microcontroller/__init__.py
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/microcontroller/

              

              $ scp microcontroller/pin.py
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/microcontroller/

              

              $ cd adafruit_blinka

              

              $ scp -r board/luckfox
              ${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/adafruit_blinka/board/

              

              $ scp -r microcontroller/rockchip/rv1106
${USER}@${HOST}:${HOMEX}/Adafruit_Blinka/src/adafruit_blinka/microcontroller/rockchip/

自動成形されたときは、もう１度pre-commitを実行してエラーが無いことを確認します。
pre-commitが終了したらlocalリポジトリ→fork-remoteリポジトリにファイルを反映しますが、
修正作業中にmaster-remoteリポジトリに新しい変更が加わっている可能性が有ります。
そこで、master-remoteリポジトリの変更を、fork-remoteリポジトリに取り込みます。
これはgithubのwebページで「Sync Fork」のボタン一発で取り込むことができます。

git diff でlocalリポジトリとremoteリポジトリの差分を確認することができます。
git configは最初の1度だけ必要です。

$ git status

              $ git diff

              

              $ git config --global user.email "あなたのメールアドレス"

              $ git config --global user.name "あなたのgithubアカウント"

              

              $ git add .

              $ git commit -m "適当なコメント"

              $ git push

              Username for 'https://github.com': xxxxxxxxxx  
              -> githubアカウント

              Password for 'https://xxxxxxxxxx@github.com':  
              -> github Personal Access Token

              

              Enumerating objects: 11, done.

              Counting objects: 100% (11/11), done.

              Delta compression using up to 4 threads

              Compressing objects: 100% (6/6), done.

              Writing objects: 100% (6/6), 681 bytes | 136.00 KiB/s,
              done.

              Total 6 (delta 3), reused 0 (delta 0), pack-reused 0

              remote: Resolving deltas: 100% (3/3), completed with 3
              local objects.

              To https://github.com/xxxxxxxxxxAdafruit_Python_Blinka

                 a0261fb..e1bc181  main -> main

githubのforkリポジトリを開いて変更が反映されていることを確認します。
githubのforkリポジトリから「Contibute」のボタンを押すと、masterリポジトリにPull Requestを発行することができます。
あとはmasterリポジトリにPRがマージされるのを待ちましょう。

これを書き終わった後に気が付きましたが、同じ内容がこちらに公開されています。