Difference between revisions of "The Basics"

From StereoPi Wiki
Jump to navigation Jump to search
m
m (Quick equipment test)
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== How to insert RPi Compute Module ==
 
== How to insert RPi Compute Module ==
While inserting Compute Module 3(CM3) in to the SteroPi, first insert it in the SO-DIMM connector at a  45-degree angle and firmly press down until you hear a “click”. If you will not insert it correctly (with a 45 degree angle), you may still hear a “click”, but some CM3 contacts may not make contact with the SO DIMM connector pins. If the device is powered up in this configuration, it will either will not boot, or will die a painful death!  So, do yourself a favor and remove and install the StereoPi with a 45 degree angle!
+
While inserting Raspberry Pi Compute Module (CM) in to the SteroPi, first insert it in the SO-DIMM connector at a  45-degree angle and firmly press down until you hear a “click”. If you will not insert it correctly (with a 45 degree angle), you may still hear a “click”, but some CM contacts may not make contact with the SO DIMM connector pins. If the device is powered up in this configuration, it will either will not boot, or will die a painful death!  So, do yourself a favor and remove and install the StereoPi with a 45 degree angle!
  
 
== How to prepare Raspbian image ==
 
== How to prepare Raspbian image ==
You may download latest Raspbian image and write it on MicroSD card. To add support of both cameras you need just to put dt-blob.bin file in a “boot” partition. This file is available in the folder with this manual
+
You may download latest Raspbian image and write it on MicroSD card. To add support of both cameras you need just to put dt-blob.bin file in a “boot” partition.  
 +
 
 +
This dt-blob.bin file is available [[DIY Ninjas Section#Device tree (DTS and dt-blob.bin)|here in our Wiki]]
 +
 
 +
You can also use our [[SLP (StereoPi Livestream Playground) Raspbian Image#S.L.P. Raspbian image | S.L.P. Raspbian image]]
 +
 
 +
or our OpenCV Raspbian Image (link in this article [https://medium.com/stereopi/opencv-and-depth-map-on-stereopi-tutorial-62cb6792bbed Python and OpenCV first steps])
  
 
== How to connect cameras ==
 
== How to connect cameras ==
While connecting camera ribbons, the first step is PULLING black the fixator up 4-5 mm. After that insert camera ribbon by BLUE side to BLACK fixator. Check  that the cable is fully inserted  at a 90 degree angle. After that push the black fixator down to secure the ribbo
+
While connecting camera ribbons, the first step is PULLING black the fixator up 4-5 mm. After that insert camera ribbon by BLUE side to BLACK fixator. Check  that the cable is fully inserted  at a 90 degree angle. After that push the black fixator down to secure the ribbon.
 +
 
 +
== How to connect power ==
 +
'''Important.'''
 +
Please let me dispel the myth: The MicroUSB on StereoPi is not for power as with the classic RaspberryPi.
 +
 
 +
The MicroUSB on StereoPi is intended for uploading the eMMC firmware. Connecting the MicroUSB to StereoPi will place StereoPi in a special mode. There’s also one backdoor feature the MicroUSB permits, [https://wiki.stereopi.com/index.php?title=DIY_Ninjas_Section#Undeclared_feature:_usb_client_mode usb-client mode]. In this mode LAN9513 chip is physically disconnected from CM USB, so '''LAN and USB are disabled'''.
 +
 
 +
 
 +
* There is a two-pin white connector on board for connecting power supply. Included in your kit is a USB A power cable, with a special connector to power the StereoPi.
 +
[[File:Stereopi-usb-power-cable.jpg|none|400px|StereoPi USB power cable]]
 +
 
 +
 
 +
 
 +
* If space is tight inside your robot or enclosure, another cable, like this one, can be used to power the StereoPi instead of the USB cable.
 +
[[File:Stereopi-power-cable.jpg|none|400px|StereoPi power cable]]
 +
 
 +
== How to install cameras to support plates ==
 +
 
 +
[[File:wideangle-camera-installation.jpg|none|400px|Wideangle camera installation]]
 +
 
 +
Installation of a basic V1 and V2 cameras is obvious, but you might have some questions about wide angle cameras installation.
 +
 
 +
Here is a brief video of this process:
 +
 
 +
https://vimeo.com/332958013
 +
 
 +
== How to power up the StereoPi ==
 +
* If you are using power cable, you need to turn on power switch.
 +
* If you are using MicroUSB (advanced mode for firmware upload, [[DIY Ninjas Section#Undeclared feature: usb client mode|Undeclared feature: usb client mode]] ), power switch is ignored. In this case another powering logic is used. Device will be powered on as soon as you connect MicroUSB cable. Please notice, that in this case USB and LAN are disabled!
 +
 
 +
== Quick equipment test ==
 +
If you are using S.L.P. Raspbian image:
 +
 
 +
# Insert MicroSD in your cardreader. You'll see "BOOT" disk in your connected storage list.
 +
# Open "stereopi.conf" file.
 +
# Find row "video_mode=2D", change it to "video_mode=3D". Save file.
 +
# Insert your MicroSD to the StereoPi.
 +
# Connect 2 cameras and HDMI monitor. Power on your StereoPi.
 +
# If you see images from both cameras on your HDMI monitor, everything is Ok.
 +
 
 +
If you are using fresh-cooked Raspbian image, downloaded from [https://www.raspberrypi.org/downloads/ RaspberryPi.org], go this way:
 +
# We suggested you've already added "dt-blob.bin" to your BOOT partition, as mentioned [[The_Basics#How_to_prepare_Raspbian_image|here in our Wiki]].
 +
# Connect 2 cameras to your StereoPi, and power it on.
 +
# Open console.
 +
# Run "raspistill -cs 0". You will see 5 seconds preview from your first camera.
 +
# Run "raspistill -cs 1". You will see 5 seconds preview from your second camera.
 +
 
 +
Please notice, you can do this preview test in both GUI Raspbian mode and console (non-GUI) modes.

Revision as of 11:18, 8 May 2019

How to insert RPi Compute Module

While inserting Raspberry Pi Compute Module (CM) in to the SteroPi, first insert it in the SO-DIMM connector at a 45-degree angle and firmly press down until you hear a “click”. If you will not insert it correctly (with a 45 degree angle), you may still hear a “click”, but some CM contacts may not make contact with the SO DIMM connector pins. If the device is powered up in this configuration, it will either will not boot, or will die a painful death! So, do yourself a favor and remove and install the StereoPi with a 45 degree angle!

How to prepare Raspbian image

You may download latest Raspbian image and write it on MicroSD card. To add support of both cameras you need just to put dt-blob.bin file in a “boot” partition.

This dt-blob.bin file is available here in our Wiki

You can also use our S.L.P. Raspbian image

or our OpenCV Raspbian Image (link in this article Python and OpenCV first steps)

How to connect cameras

While connecting camera ribbons, the first step is PULLING black the fixator up 4-5 mm. After that insert camera ribbon by BLUE side to BLACK fixator. Check that the cable is fully inserted at a 90 degree angle. After that push the black fixator down to secure the ribbon.

How to connect power

Important. Please let me dispel the myth: The MicroUSB on StereoPi is not for power as with the classic RaspberryPi.

The MicroUSB on StereoPi is intended for uploading the eMMC firmware. Connecting the MicroUSB to StereoPi will place StereoPi in a special mode. There’s also one backdoor feature the MicroUSB permits, usb-client mode. In this mode LAN9513 chip is physically disconnected from CM USB, so LAN and USB are disabled.


  • There is a two-pin white connector on board for connecting power supply. Included in your kit is a USB A power cable, with a special connector to power the StereoPi.
StereoPi USB power cable


  • If space is tight inside your robot or enclosure, another cable, like this one, can be used to power the StereoPi instead of the USB cable.
StereoPi power cable

How to install cameras to support plates

Wideangle camera installation

Installation of a basic V1 and V2 cameras is obvious, but you might have some questions about wide angle cameras installation.

Here is a brief video of this process:

https://vimeo.com/332958013

How to power up the StereoPi

  • If you are using power cable, you need to turn on power switch.
  • If you are using MicroUSB (advanced mode for firmware upload, Undeclared feature: usb client mode ), power switch is ignored. In this case another powering logic is used. Device will be powered on as soon as you connect MicroUSB cable. Please notice, that in this case USB and LAN are disabled!

Quick equipment test

If you are using S.L.P. Raspbian image:

  1. Insert MicroSD in your cardreader. You'll see "BOOT" disk in your connected storage list.
  2. Open "stereopi.conf" file.
  3. Find row "video_mode=2D", change it to "video_mode=3D". Save file.
  4. Insert your MicroSD to the StereoPi.
  5. Connect 2 cameras and HDMI monitor. Power on your StereoPi.
  6. If you see images from both cameras on your HDMI monitor, everything is Ok.

If you are using fresh-cooked Raspbian image, downloaded from RaspberryPi.org, go this way:

  1. We suggested you've already added "dt-blob.bin" to your BOOT partition, as mentioned here in our Wiki.
  2. Connect 2 cameras to your StereoPi, and power it on.
  3. Open console.
  4. Run "raspistill -cs 0". You will see 5 seconds preview from your first camera.
  5. Run "raspistill -cs 1". You will see 5 seconds preview from your second camera.

Please notice, you can do this preview test in both GUI Raspbian mode and console (non-GUI) modes.