2019-12-02 04:27:12 +01:00
|
|
|
.. _quickstart:
|
|
|
|
|
|
|
|
|
|
===============
|
|
|
|
|
Getting Started
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
|
|
|
|
|
Make sure your Pi is off while installing the camera module. Although it is
|
|
|
|
|
possible to install the camera while the Pi is on, this isn't good practice
|
|
|
|
|
(if the camera is active when removed, it's possible to damage it).
|
|
|
|
|
|
|
|
|
|
Connect your camera module to the CSI port on your Raspberry Pi; this is the
|
|
|
|
|
long thin port adjacent to the HDMI socket. Gently lift the collar on top of
|
|
|
|
|
the CSI port (if it comes off, don't worry, you can push it back in but try to
|
|
|
|
|
be more gentle in future!). Slide the ribbon cable of the camera module into
|
|
|
|
|
the port with the blue side facing the Ethernet port (or where the Ethernet
|
|
|
|
|
port would be if you've got a model A/A+).
|
|
|
|
|
|
|
|
|
|
Once the cable is seated in the port, press the collar back down to lock the
|
|
|
|
|
cable in place. If done properly you should be able to easily lift the Pi by
|
|
|
|
|
the camera's cable without it falling out. The following illustrations show
|
|
|
|
|
a well-seated camera cable with the correct orientation:
|
|
|
|
|
|
|
|
|
|
.. image:: good_connection.jpg
|
|
|
|
|
:width: 640px
|
|
|
|
|
:align: center
|
|
|
|
|
|
|
|
|
|
Make sure the camera module isn't sat on anything conductive (e.g. the Pi's
|
|
|
|
|
USB ports or its GPIO pins). Now, apply power to your Pi. Once booted, start
|
|
|
|
|
the Raspberry Pi Configuration utility and enable the camera module:
|
|
|
|
|
|
|
|
|
|
.. image:: enable_camera.png
|
|
|
|
|
:align: center
|
|
|
|
|
|
|
|
|
|
You will need to reboot after doing this (but this is one-time setup so you
|
|
|
|
|
won't need to do it again unless you re-install your operating system or switch
|
|
|
|
|
SD cards). Once rebooted, start a terminal and try the following command::
|
|
|
|
|
|
|
|
|
|
raspistill -o image.jpg
|
|
|
|
|
|
|
|
|
|
If everything is working correctly, the camera should start, a preview from the
|
|
|
|
|
camera should appear on the display and, after a 5 second delay it should
|
|
|
|
|
capture an image (storing it as ``image.jpg``) before shutting down the camera.
|
|
|
|
|
Proceed to the :ref:`recipes1`.
|
|
|
|
|
|
|
|
|
|
If something else happens, read any error message displayed and try any
|
|
|
|
|
recommendations suggested by such messages. If your Pi reboots as soon as you
|
|
|
|
|
run this command, your power supply is insufficient for running your Pi plus
|
|
|
|
|
the camera module (and whatever other peripherals you have attached).
|
|
|
|
|
|
