0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Radxa Cubie A7S を買ったら USB-C ドックのキーボードが動かなかった件のメモ

0
Posted at

Radxa Cubie A7S とは?

Radxa Cubie A7S。Allwinner A733 の小型 SBC です。
image.png

項目 内容
SoC Allwinner A733(Cortex-A76 ×2 + Cortex-A55 ×6)
NPU 3 TOPS (INT8)
RAM LPDDR5 8GB
ストレージ microSD
ネットワーク ギガビットイーサー
USB USB-C2 (USB 3.2 + DP Alt Mode + OTG)、USB-C1 (5V給電 + OTG)、USB-A (USB 2.0) ×1
OS Debian 13 (trixie) / kernel 6.6.98-aw2511 r7

8コア / 8GB / GbE で、Arm64 の Docker ホストにするのにちょうど良さそうだと思って買いました。実際、コンテナを何個か動かす用途ならスペックは十分そうです(NPUはおまけ)。

問題:ドックのキーボードが反応しない

USB-C1 に USB-C ドックを挿し、ドックの USB ポートにキーボードを挿しても認識されない。
仕方なく本体の USB-A にキーボードを直挿しすると動く、という状態。

原因

USB-C1 は給電入力と OTG の兼用ポートです。このボードは USB-C1 が唯一の電源入力なので、給電中は VBUS が常に存在します。
すると sunxi の OTG マネージャが「VBUS がある=デバイス側」と判断して、常にガジェットモードになります。
ホストモードにならないので、ドックもハブも列挙されません。

systemctl status usb-gadget.target   # active ならガジェットモード
cat /sys/class/udc/*/state           # not attached

修正方法

DTB の usbc0 ノードを HOST 固定にします。

以下の手順を行うと、USB-C1 はガジェット(adb / RNDIS / ECM など)として使えなくなります。
今回は「USB-C1 がホストとして動いてくれればいい」という用途なので、この割り切りで進めています。

sudo apt install device-tree-compiler

DTB=/usr/lib/linux-image-$(uname -r)/allwinner/sun60i-a733-cubie-a7s.dtb
sudo cp $DTB /boot/dtb-backup.dtb
sudo fdtput -t u $DTB /soc@3000000/usbc0@10 usb_port_type 1

usb_port_type は 0=OTG、1=HOST、2=DEVICE です。

続いて、OTG マネージャが役割を取り返そうとしてカーネルごと落ちるので、自動ロードを止めます。

echo 'blacklist sunxi_usbc' | sudo tee /etc/modprobe.d/99-usbc-host.conf
sudo reboot

確認:

lsusb -t            # Bus 003(4101000.ehci0)にドックが見えればOK
dmesg | grep ehci0  # ehci0-controller が bus を登録している

結果

起動から 8 秒ほどでドック配下のキーボードが usbhid として認識され、コンソールでも普通に打てるようになりました。
ついでにドック内蔵の Ethernet (RTL8153) と USB Audio も使える状態です。

Bus 003.Port 001: Dev 002, Class=Hub, Driver=hub/4p
    |__ Port 001: Dev 003, Class=Vendor Specific, Driver=r8152
    |__ Port 003: Dev 004, Class=Hub, Driver=hub/4p
        |__ Port 001: Dev 007, Class=Human Interface Device, Driver=usbhid

注意

  • USB-C1 のガジェット機能(adb / ecm / rndis など)は使えなくなります。ホスト固定なので当然。
  • カーネルを更新すると DTB が差し替わって元に戻るので、/etc/kernel/postinst.d/ に usb-c1-host-apply.sh を置いて再適用しています。
  • 元に戻すときは、バックアップした DTB を戻して blacklist を消して再起動。

同じボードで「USB-C ドックのキーボードだけ死ぬ」なら、まず usb-gadget.target を見るのが早いです。

Radxa Cubie A7S。Allwinner A733 の小型 SBC です。

項目 内容
SoC Allwinner A733(Cortex-A76 ×2 + Cortex-A55 ×6)
NPU 3 TOPS (INT8)
RAM LPDDR5 8GB
ストレージ eMMC 32GB + microSD
ネットワーク GbE、Wi-Fi 6 / BT 5.4
USB USB-C2 (USB 3.2 + DP Alt Mode + OTG)、USB-C1 (5V給電 + OTG)、USB-A (USB 2.0) ×1
OS Debian 13 (trixie) / kernel 6.6.98-aw2511

8コア / 8GB / eMMC / GbE で、Arm64 の Docker ホストにするのにちょうど良さそうだと思って買いました。実際、コンテナを何個か動かす用途ならスペックは十分そうです(NPU はおまけ)。

問題:ドックのキーボードが反応しない

USB-C1 に USB-C ドックを挿し、ドックの USB ポートにキーボードを挿しても認識されない。
仕方なく本体の USB-A にキーボードを直挿しすると動く、という状態。

原因

USB-C1 は給電入力と OTG の兼用ポートです。このボードは USB-C1 が唯一の電源入力なので、給電中は VBUS が常に存在します。
すると sunxi の OTG マネージャが「VBUS がある=デバイス側」と判断して、常にガジェットモードになります。
ホストにならないので、ドックもハブも列挙されません。

確認はこれ:

systemctl status usb-gadget.target   # active ならガジェットモード
cat /sys/class/udc/*/state           # not attached

直した

DTB の usbc0 ノードを HOST 固定にします。

sudo apt install device-tree-compiler

DTB=/usr/lib/linux-image-$(uname -r)/allwinner/sun60i-a733-cubie-a7s.dtb
sudo cp $DTB /boot/dtb-backup.dtb
sudo fdtput -t u $DTB /soc@3000000/usbc0@10 usb_port_type 1

usb_port_type は 0=OTG、1=HOST、2=DEVICE です。

続いて、OTG マネージャが役割を取り返そうとしてカーネルごと落ちるので、自動ロードを止めます。

echo 'blacklist sunxi_usbc' | sudo tee /etc/modprobe.d/99-usbc-host.conf
sudo reboot

確認:

lsusb -t            # Bus 003(4101000.ehci0)にドックが見えればOK
dmesg | grep ehci0  # ehci0-controller が bus を登録している

結果

起動から 8 秒ほどでドック配下のキーボードが usbhid として認識され、コンソールでも普通に打てるようになりました。
ついでに手持ちのドック内蔵の Ethernet (RTL8153) と USB Audio も使える状態です。

Bus 003.Port 001: Dev 002, Class=Hub, Driver=hub/4p
    |__ Port 001: Dev 003, Class=Vendor Specific, Driver=r8152
    |__ Port 003: Dev 004, Class=Hub, Driver=hub/4p
        |__ Port 001: Dev 007, Class=Human Interface Device, Driver=usbhid

注意

  • USB-C1 のガジェット機能(adb / ecm / rndis など)は使えなくなります。ホスト固定なので当然ではある。
  • カーネルを更新すると DTB が差し替わって元に戻るので、/etc/kernel/postinst.d/ に usb-c1-host-apply.sh を置いて再適用しています。
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?