ラズパイ公式カメラモジュール その2
スポンサーリンク
前回の続きです。
部品を購入したところで取り付けないと始まりません。
前提条件と準備
前提条件は以下の通り。
- Camera Module V2.1
- Raspberry Pi 3 model B
- Raspbian Jessie
過去記事で使っている環境にカメラが追加されただけです。
注意点など
- Raspbian をアップデートした状態に
- GL Driver は無効化*1しておく
以下のコマンドを実行してOSをアップデート。
$ sudo apt update $ sudo apt upgrade
念の為、ファームウェアもアップデートしておく。
$ sudo rpi-update
正常終了したら再起動。
以下、参考。
$ uname -a Linux raspberrypi 4.4.38-v7+ #938 SMP Thu Dec 15 15:22:21 GMT 2016 armv7l GNU/Linux
接続と設定
カメラモジュールは静電気に弱いらしいので、周囲の金属に触れるなどして静電気を逃がしてから作業する*2。
- ラズパイの電源を切り、しばらく待っってから*3、電源ケーブルを取り外しておく
- カメラ接続用のコネクタ(HDMIポートの隣)の両端の黒いツメを垂直方向に引き上げる
- 向きに注意しつつ、コネクタにケーブルを差し込む。青い文字の印刷されている側がUSBポート側になるように
- しっかり押し込んだ状態で、コネクタの黒いツメを押し込んで固定する
接続後の状態
反対側から
通電状態で作業しても問題ないのかもしれませんが、気軽に電源の入った状態で抜き差しできるUSBが特別なのであって、本来周辺機器は電源オフで取り外すべきかと思います。
ソフトウェア側の設定
GUI環境の場合
- 画面左上端のメインメニューから「設定」「Raspberry Piの設定」をクリックして設定画面へ
- 「インターフェイス」タブの「カメラ:」の有効というラジオボタンをクリック
- 「OK」をクリックすると再起動を促してくるので素直に再起動
CLI(CUI)環境
sudo rasps-config
から設定。"5. Interfacing Options"から"P1 Camera"と順に進んで行けばOK。
特に説明は不要なはず
補足:エラーの例など
ケーブルがしっかり刺さっていない(もしくはRaspbian側でカメラ用のインターフェイスが有効になっていない)状態でカメラにアクセスすると下記のようなエラーが表示される。
$ raspistill -w 1920 -h 1080 -o try.jpg mmal: Cannot read cameara info, keeping the defaults for OV5647 mmal: mmal_vc_component_create: failed to create component 'vc.ril.camera' (1:ENOMEM) mmal: mmal_component_create_core: could not create component 'vc.ril.camera' (1) mmal: Failed to create camera component mmal: main: Failed to create camera component mmal: Camera is not detected. Please check carefully the camera module is installed correctly
ピント調整時にケーブルを引っ張ってしまったせいで遭遇しました。
なお、カメラモジュール自体が故障している場合のエラーは不明です*4。
フォーカス調整
マクロよりの条件で撮影したい場合のみ。監視カメラなどの用途であれば不用意に弄らない方がベターだと思います。もちろん自己責任で。
調整用の治具
付属の治具*5の裏側をよく見ると、微妙に凹みがあるのでその部分をカメラの先端部にはめ込む*6。
初回のみ強めに押し付けた状態で軽く時計回りにひねってやると固定用の糊が外れるのか、すんなり回転するようになります*7。
初期状態では無限遠方にピントが合うように設定されているため、時計方向にはほとんど回らないはずです。
近方にピントを合わせたいときは反時計回りに、遠方にピントを合わせたいときは時計回りに。反時計回りに回しすぎると完全なピンボケ状態になる。
時計回りに締め込んで行くとほぼ出荷時の状態に戻る。
ピント調整は接続したままの状態で問題ないです。用途に応じて撮影結果を確認しながら調整(静電気対策もお忘れなく)。
例えば以下のようにコマンドにraspistill
(後述)の-t
オプションに"0"ミリ秒を指定するとCtrl+C
を入力するまでプレビュー画像を撮影し続けるのでかなり楽(raspvid
でも可)。
$ raspistill -t 0
raspistill
とraspvid
でプレビュー表示の見え方が微妙に違うので目的にあった方のコマンドで確認しながら調整する。
専用コマンドで撮影
公式ドキュメントによると、カメラモジュール専用のコマンドとして、raspistill
、raspivid
、raspistillyuv
の3つが紹介されている。
しかしながら現在のところ、raspistillyuv
ではなくraspiyuv'に名称が変更されていたり、
raspividyuv`が追加されているので結局全部で4つとなっている。
- raspistill : 静止画用の画像データ取得コマンド
- raspiyuv : YUV形式でデータ画像を取得するコマンド
- raspivid : H264形式で動画を撮影するコマンド
- raspividyuv : YUV420形式で動画を撮影するコマンド
それぞれオプションなし、もしくは-?
オプション付きで実行するとオプション一覧が表示される。なおこれらのコマンドはlibraspberrypi-bin
というパッケージに含まれており、基本的に最初からインストールされている。
基本的なオプションは下記のページに一通り記載されてる。
- githubリポジトリのページ : userland/host_applications/linux/apps/raspicam at master · raspberrypi/userland · GitHub
- 公式ドキュメント(やや古い):Raspberry Pi Camera Module - Raspberry Pi Documentation
Interface(インターフェース) 2016年09月号にカメラモジュール自体と、付属コマンドの解説が載っているのでそちらも参考に。
静止画の撮影
静止画を撮影するには-o
オプションでファイル名を指定したうえで実行する。もうひとつ重要なのは画像を回転させるための-rot
オプション。
また、-h
で撮影する画像の高さ、-w
で撮影する画像の幅を指定する。省略した場合は最大解像度(3280x2464)。
最大解像度未満の値を指定すると、不要な部分を切り捨てるケースと指定された解像度に縮小するケースがある。結果として指定する高さと幅の比率が画角に影響する。
$ raspistill -w 1280 -h 800 -o test.jpg
コマンドを実行するとプレビューが表示された後、画像が保存される。プレビュー画像の表示位置と解像度は-p
オプションで変更可能。
デフォルトではコマンドが実行されてから5000ミリ秒(つまり5秒)ほど待機してから撮影される。これは-t
オプションで変更可能。
以下は2秒後に撮影する例:
$ raspistill -t 2000 -o image.jpg
png形式で保存する(可逆圧縮):
$ raspistill -o image.png -e png
-e
で保存する形式を指定しない限りファイル名の拡張子によらずJPEG形式で保存される((jpg, bmp, gif, png)の4種が指定できる)。
他にもカメラの設定を変更するオプションと、夜景や花火などの特定の撮影シチュエーション向けのモード指定オプション、撮影した画像にエフェクトをかけるオプション*8がある。
撮影してみた画像
そのままでは固定できないので、Amazonで購入したクリップで挟んで固定。
なんとも微妙な絵面。
下記のように画像サイズを指定する。
$ raspistill -w 1280 -h 800 -o testimage.jpg
撮影した画像は以下のとおり(フォーカス変更前)。
普通にいい感じに見える。
フォーカスをいじった後の画像。
ちょっとマクロよりに調整しずぎでピントが甘い。
ちょうどいい被写体がないので微妙ですが、マクロの例(だいたい8cmぐらい)。
その1
その2
Interfaceの記事の通り、5cmぐらいまではいけるのは確認済み。マクロよりにすると焦点の合う範囲が狭くなるのも記事の通り。
動画は面倒なので省略。
おわりに
静電気に弱いらしいのと、オートフォーカスがない点を除けば非常にいい感じだという印象です。
気が向いたらPytonのPiCamera
モジュールを使うサンプルにトライするつもりです。
トランジスタ技術なりInterfaceの記事を参考に遊んでみたいとは思っています。
ひとまずこんな感じです。
その他・関連リンク

これ1冊でできる! ラズベリー・パイ 超入門 改訂第4版 Raspberry Pi 1+/2/3/Zero/Zero W対応
- 作者: 福田和宏
- 出版社/メーカー: ソーテック社
- 発売日: 2017/06/03
- メディア: 単行本
- この商品を含むブログを見る