ハードウェア: Raspberry Pi 3B/3B+/4B/5/Zero 2W

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

システム: Raspberry Pi OS Bookworm (2025-05-13以前にリリースされたもの)

手法: fbcp (フレームバッファ・コピー)

購入リンク:

目次

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

1OSイメージの書き込み

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

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

2HDMIモニタの接続

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

3インターネット接続

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

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

4IPアドレスの取得

ターミナルを開き、以下のコマンドを入力してください:

hostname -I

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

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

6電源投入

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

7SSHリモートアクセス

PuTTY (Windows) またはターミナル (Mac/Linux) を使用して、Raspberry Pi に SSH 接続します。
PuTTY ガイド

1. ステップ 4 で確認した IP アドレスを入力します
2. ポート: 22
3. “Open” をクリックしてログインします

8fbcpのダウンロードとコンパイル

SSH 経由で実行します:

sudo apt install libraspberrypi-dev -y
sudo apt-get install unzip cmake -y
sudo wget https://osoyoo.com/driver/osoyoo35b.zip
sudo unzip ./osoyoo35b.zip
sudo cp osoyoo35b.dtbo /boot/overlays/
sudo wget https://osoyoo.com/driver/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo rm -rf build
sudo mkdir build
cd build
sudo cmake ..
sudo make -j4
sudo install fbcp /usr/local/bin/fbcp

9config.txt の編集

sudo nano /boot/firmware/config.txt

9a. 以下の行をコメントアウトする:

#dtoverlay=vc4-kms-v3d

9b. ファイルの最後に追加する:

# ========== 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 を押します。

10自動起動の設定

10a. .bash_profile の構成

sudo nano ~/.bash_profile

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

if [ "$(cat /proc/device-tree/model | cut -d ' ' -f 3)" = "5" ]; then
    # RPi 5B の設定
    export FRAMEBUFFER=/dev/fb1
    startx 2> /tmp/xorg_errors
else
    # Pi5 以外の設定 (RPi 3/4)
    export FRAMEBUFFER=/dev/fb0
    fbcp &
    startx 2> /tmp/xorg_errors
fi

10b. 99-fbturbo.conf の構成 (存在する場合)

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

存在する場合は、内容が以下のようになっているか確認してください:

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

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

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

12タッチ操作の構成

デスクトップが表示されたら、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

診断コマンド

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

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

# fbcp が動作しているか確認 (RPi 3/4)
ps aux | grep fbcp

# SPI オーバーレイの確認
dmesg | grep -i osoyoo

よくあるエラー

cd ~/rpi-fbcp/build && sudo make && sudo install fbcp /usr/local/bin/fbcp

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

setup-spi-fbcp.sh として保存し、実行してください:

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

#!/bin/bash
echo "=== RPi3/4/5 + Osoyoo 3.5 SPI Screen Setup (fbcp) ==="

sudo apt-get update
sudo apt install libraspberrypi-dev -y
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/
sudo wget -q https://osoyoo.com/driver/Rpi-fbcp.zip
sudo unzip -o -q ./Rpi-fbcp.zip
cd rpi-fbcp/ && sudo rm -rf build && sudo mkdir build && cd build
sudo cmake .. && sudo make -j4 && sudo install fbcp /usr/local/bin/fbcp

cd ~
sudo sed -i 's/^dtoverlay=vc4-kms-v3d/#dtoverlay=vc4-kms-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 cat > ~/.bash_profile << 'EOF' if [ "$(cat /proc/device-tree/model |
cut -d ' ' -f 3)" = "5" ]; then export FRAMEBUFFER=/dev/fb1 startx 2> /tmp/xorg_errors
else
    export FRAMEBUFFER=/dev/fb0
    fbcp &
    startx 2> /tmp/xorg_errors
fi
EOF

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

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