ハードウェア: Raspberry Pi 4B / 5

スクリーン: Osoyoo 3.5インチ SPI タッチスクリーン 480×320 (モデル番号: 2022013800)

システム: Raspberry Pi OS Bookworm / Trixie (バージョン: 2025-10-01 以降)

購入リンク:

目次

• ステップ 1: OSイメージの書き込み
• ステップ 2: HDMIモニタの接続
• ステップ 3: インターネットへの接続
• ステップ 4: SSHの有効化
• ステップ 5: IPアドレスの取得
• ステップ 6: SPIスクリーンの取り付け
• ステップ 7: 電源を入れる
• ステップ 8: SSHリモートアクセス
• ステップ 9: ドライバの構成
• ステップ 10: config.txt の編集
• ステップ 11: 自動起動の設定
• ステップ 12: CLIオートログインの設定
• ステップ 13: タッチ操作の構成
• トラブルシューティング
• 既知の制限事項
• リファレンス チュートリアル
• テクニカルサポート

1OSイメージの書き込み

デスクトップ版の Raspberry Pi OS (Bookworm または Trixie) を TFカード/micro SDカードに書き込み、そのカードを Raspberry Pi に挿入します。

OSのダウンロードはこちらから: Raspberry Pi 公式サイト

2HDMIモニタの接続

Raspberry Pi を HDMIモニタまたはテレビに接続します。キーボードとマウスを Raspberry Pi の USBポートに接続します。

3インターネットへの接続

WiFi または イーサネット経由で Raspberry Pi をインターネットに接続します。

WiFi設定ガイドについては、こちらをご覧ください: Raspberry Pi 基本チュートリアル

4SSHの有効化

マウスを使用して以下のように操作します:

Raspberry Pi アイコン → Preferences → Control Centre → Interfaces → Enable SSH

その後、ウィンドウを閉じます。

5IPアドレスの取得

ターミナルを開き、以下のコマンドを入力して Raspberry Pi の IP アドレスを取得します:

hostname -I

6SPIスクリーン本体の取り付け

Raspberry Pi をシャットダウンし、HDMI/テレビモニタ、キーボード、マウスを取り外します。その後、3.5インチ SPIスクリーンを取り付けます。

7電源を入れる

SPIスクリーンを取り付けた状態で Raspberry Pi の電源を入れます。

8SSHリモートアクセス

SSH ツールを使用して、Raspberry Pi をリモートで操作します。
Windows では PuTTY を推奨します。PuTTY のセットアップガイドは: こちらをクリック

1. “Host Name” にステップ 5 で確認した IP アドレスを入力します。
2. “Port” に 22 を入力します (デフォルトの SSH ポート)。
3. “Open” をクリックします。
4. ユーザー名とパスワードでログインします。

9ドライバの構成

SSH 経由で Raspberry Pi のターミナルを開き、以下のコマンドを実行します:

sudo apt-get update
sudo apt-get install unzip cmake -y
cd ~
sudo wget https://osoyoo.com/driver/osoyoo35b.zip
sudo unzip ./osoyoo35b.zip
sudo cp osoyoo35b.dtbo /boot/overlays/

10config.txt の編集

sudo nano /boot/firmware/config.txt

10a. 以下の行をコメントアウトする (行頭に # を追加):

#dtoverlay=vc4-kms-v3d

10b. ファイルの最後に以下を追加する:

# ========== SPI Screen Configuration ==========
dtparam=spi=on
dtoverlay=osoyoo35b:speed=20000000
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
hdmi_cvt 480 320 60 6 0 0 0
hdmi_drive=2
display_rotate=2

保存して終了: Ctrl+X を押し、次に Y、そして Enter を押します。

11自動起動の設定

11a. .bash_profile の構成

.bash_profile ファイルを開くか、作成します:

sudo nano ~/.bash_profile

以下のコードを追加します:

export FRAMEBUFFER=/dev/fb1
startx 2> /tmp/xorg_errors

11b. 99-fbturbo.conf の構成 (ファイルが存在する場合)

ファイルが存在するか確認し、内容を検証します:

sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf

存在する場合は、fbdev が /dev/fb0 に設定されていることを確認してください:

Section "Device"
        Identifier      "Allwinner A10/A13 FBDEV"
        Driver          "fbturbo"
        Option          "fbdev" "/dev/fb0"
        Option          "SwapbuffersWait" "true"
EndSection

12CLIオートログインの設定

sudo raspi-config nonint do_boot_behaviour B2
sudo raspi-config nonint do_wayland W1
sudo reboot

13タッチ操作の構成

デスクトップが動作したら、SSH 経由で接続し、キャリブレーション ソフトウェアをインストールします:

sudo apt-get install xserver-xorg-input-evdev xinput-calibrator -y
sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf /usr/share/X11/xorg.conf.d/45-evdev.conf

キャリブレーション構成ファイルを作成します:

sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf

以下の内容を追加します:

Section "InputClass"
    Identifier "calibration"
    MatchProduct "ADS7846 Touchscreen"
    Option "Calibration" "241 3854 3885 240"
    Option "SwapAxes" "1"
EndSection

再起動してタッチ設定を適用します:

sudo reboot

診断コマンド

画面が起動ページで止まっている、または白く表示されている場合は、SSH 経由で以下のコマンドを実行してください:

# X Server のエラーを確認
cat /tmp/xorg_errors

# X のログを確認
cat ~/.local/share/xorg/Xorg.0.log

# フレームバッファ デバイスを確認
ls -l /dev/fb*

# SPI オーバーレイがロードされているか確認
dmesg | grep -i osoyoo

# config.txt の変更内容を確認
cat /boot/firmware/config.txt | grep -E "(kms|spi|osoyoo)"

# Wayland が無効になっているか確認 (X11 と表示されるべき)
echo $XDG_SESSION_TYPE

よくあるエラーと解決策

cat /boot/firmware/config.txt | grep -E "(kms|spi|osoyoo)"

sudo raspi-config nonint do_wayland W1
sudo reboot

DISPLAY=:0 xinput_calibrator

ワンクリック セットアップ スクリプト

以下を setup-spi.sh として保存し、次のコマンドで実行します:

chmod +x setup-spi.sh && ./setup-spi.sh

#!/bin/bash
echo "=== RPi4/5 + Osoyoo 3.5 SPI Screen Setup ==="

# システムの更新
sudo apt-get update

# ステップ 9: ドライバのインストール
sudo apt-get install -y unzip cmake
cd ~
sudo wget -q https://osoyoo.com/driver/osoyoo35b.zip
sudo unzip -o -q ./osoyoo35b.zip
sudo cp osoyoo35b.dtbo /boot/overlays/

# ステップ 10: config.txt の編集
sudo sed -i 's/^dtoverlay=vc4-kms-v3d/#dtoverlay=vc4-kms-v3d/' /boot/firmware/config.txt
sudo sed -i 's/^dtoverlay=vc4-fkms-v3d/#dtoverlay=vc4-fkms-v3d/' /boot/firmware/config.txt

if ! grep -q "osoyoo35b" /boot/firmware/config.txt; then
    sudo tee -a /boot/firmware/config.txt > /dev/null << 'CONF' # ========== SPI Screen Configuration ========== dtparam=spi=on dtoverlay=osoyoo35b:speed=20000000 hdmi_force_hotplug=1 max_usb_current=1 hdmi_group=2 hdmi_mode=1 hdmi_mode=87 hdmi_cvt 480 320 60 6 0 0 0 hdmi_drive=2 display_rotate=2 CONF fi # ステップ 11: .bash_profile の構成 cat > 
~/.bash_profile << 'EOF' export FRAMEBUFFER=/dev/fb1 startx 2> /tmp/xorg_errors
EOF

# ステップ 12: 起動動作の設定と X11 への切り替え
sudo raspi-config nonint do_boot_behaviour B2
sudo raspi-config nonint do_wayland W1

# ステップ 13: タッチサポートのインストール
sudo apt-get install -y xserver-xorg-input-evdev xinput-calibrator
sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf \
            /usr/share/X11/xorg.conf.d/45-evdev.conf

sudo tee /usr/share/X11/xorg.conf.d/99-calibration.conf > /dev/null << 'EOF'
Section "InputClass"
    Identifier "calibration"
    MatchProduct "ADS7846 Touchscreen"
    Option "Calibration" "241 3854 3885 240"
    Option "SwapAxes" "1"
EndSection
EOF

echo "=== セットアップ完了。
再起動します... ==="
sleep 3
sudo reboot

お使いの Raspberry Pi モデルと OS バージョンに一致するチュートリアルを選択してください:

どれを選べばよいかわかりませんか？
• Piモデルを確認する: cat /proc/device-tree/model
• OSバージョンを確認する: cat /etc/os-release

ご不明な点やフィードバックがございましたら、チケットを送信してください。弊社のチームが通常 1〜2営業日 以内に回答いたします。お待ちいただきありがとうございます！

営業時間: 午前9時 〜 午後6時 GMT+8 (月曜日 〜 金曜日)

お問い合わせ先: [email protected]

© 2026 Osoyoo | osoyoo.com

最終更新日: 2026-02-10