This Readme contains basic info about the RasPiCamcorder 2 by Alex Eames of RasPi.TV ============================= Released under the Creative Commons Attribution 3.0 Unported (CC BY 3.0) http://creativecommons.org/licenses/by/3.0/ You may do whatever your like with this software. If you release a derivative it must contain at or near the top of the documentation... "Based on RasPiCamcorder scripts by Alex Eames of http://RasPi.TV/ https://github.com/raspitv/RasPiCamcorder/" That is your ONLY obligation. ============================= Basically there are three major parts... Video recording [sudo python picamcorder2.py] Stills capture (plus DropBox upload) [sudo python picamstills-db.py] Video streaming [python picamstreamer.py] These are currently three separate programs. See below for details. Photos and further info on the http://RasPi.TV blog or YouTube... http://raspi.tv/?p=3424 and http://youtu.be/dSgj4bUFBCQ Buttons ======= Basically you need a button connected between GPIO 23 and GND. This is the "shoot video or photo" button. (Mine is the blue one in this photo http://raspi.tv/wp-content/uploads/2013/06/DSC_4467.jpg). You also need a button between GPIO 24 and 3V3, which is the "stop shooting" button. It also doubles as the close program and shutdown button depending on how long you press it for. (Mine is the black one in this photo http://raspi.tv/wp-content/uploads/2013/06/DSC_4467.jpg). Pressing this button for >1s stops the program (useful if you are running automatically on boot). Pressing it for >3s shuts down the Pi. LEDs ==== The camera LED is on GPIO 5. I have an additional LED (I wanted one on the back) on GPIO 22 Setting up camera led control (script may not work properly without this) ----------------------------- sudo nano /boot/config.txt Add this line to your config.txt disable_camera_led=1 Usage ===== Video ----- To run the video recording program manually, you can type sudo python picamcorder2.py Add a 0 (zero) if you want to disable the front LED (assuming you have added the necessary tweak to your config file) sudo python picamcorder2.py 0 Stills ------ To run the stills program manually, you can type sudo python picamstills-db.py or sudo python picamstills-db.py 0 (if you want to disable the front LED) Video Streaming --------------- This uses two scripts to separate the GPIO and non-GPIO parts since VLC can't run as root, but RPi.GPIO has to run as root. To start the video streaming program (it works just as the recording program except it streams to port 8090 rather than recording) just type... python picamstreamer.py or python picamstreamer.py 0 (if you want to disable the front LED) This program handles the streaming part, but the GPIO part is handled by picamstream-sudo.py (which is called by picamstreamer.py). Then, on your receiving device, you need to have VLC running and looking at a network stream from... http://ip_address_of_your_pi:8090 Further instructions about VLC streaming here http://raspi.tv/?p=3099 I haven't yet managed to get streaming working automatically at boot because VLC won't run as root. I'm sure there's a way though. Setting up your Pi ================== Setting up for auto start on boot --------------------------------- Add this line to your /etc/rc.local /home/pi/picamcorder.sh Which runs a simple bash script on boot, allowing us a 10s time delay. picamcorder.sh will have to be executable for this to work chmod +x picamcorder.sh The bash script picamcorder.sh just contains this... sleep 10 sudo python /home/pi/picamcorder2.py & ...which slows things down at startup, just enough to make it work and puts the process in the background. If you prefer to auto-start-up the stills or streaming programs instead of video, just edit picamcorder.sh to call the program you want to run. Setting up for small screen use ------------------------------- sudo dpkg-reconfigure console-setup lets you increase console font size for small screens Setting Up Dropbox Upload for Stills mode ----------------------------------------- Blog article here http://raspi.tv/?p=3572 shows full instructions on how to set up DropBox Uploader on your Pi and basic usage. Full documentation at the author's GitHub https://github.com/andreafabrizi/Dropbox-Uploader To set up as a user, should only take an hour or so. A lot less if you already have a DropBox account. Hardware Component list ======================= 1 model A Raspberry Pi 1 Raspberry Pi camera board 1 switching regulator board ~$3 ebay LM2596 DC-DC Step-down Adjustable 1 Bluetooth serial adaptor $8 dx.com SKU: 104299 battery & connectors female .1" pin headers wire 0605 LED 150R 1206 for led Cyntech case White tack hot glue gun buttons bit of stripboard 4x2 angled header Possible Future Development =========================== LED on the back to show recording --> DONE camera LED toggle to disable front LED, maybe with an argv argument? --> DONE leds flashing on program exit and shutdown --> DONE indication of how much recording time/disk space left --> DONE micro USB adaptor so Pi can be stood up at SD card end --> DONE 52mm thread adaptor for adding lenses --> DONE Stills button or button combo need a mount for it possibly pan and tilt possibly a rotating base for all-round work - either stepper or highly geared it would be nice to have a third button for stills too, but getting errors after adding port 25 for stills, so all parts referring to GPIO25 are commented out for now. It seems that raspivid and raspistill don't play nicely together in the same script - (I got MMAL errors which only cleared on reboot), so had to remove the stills option from the script and implement it separately.