Skip to content

Latest commit

 

History

History
54 lines (42 loc) · 3.12 KB

README.md

File metadata and controls

54 lines (42 loc) · 3.12 KB
Raw

resin-cam-uv4l

A smart Raspberry Pi streaming camera based on UV4L.

It works on all the Raspberry Pi's with a camera connector—even the Pi Zero!

Bill of Materials

Getting started

  • Sign up on resin.io and follow our Getting Started Guide
  • Clone this repository to your local workspace
  • Set these variables in the Fleet Configuration application side tab
    • RESIN_HOST_CONFIG_gpu_mem = 196
    • RESIN_HOST_CONFIG_start_x = 1
  • Add the resin remote to your local workspace by running the useful command from the Resin dashboard
    Hint Adding the Resin remote.
  • Push code to your device with a simple git push resin master
    • See the magic happening, your device is getting updated Over-The-Air!
  • If you want your device to be accessible on WAN, enable its public URL
    • Select your device from the Devices side tab
    • Click the Actions side tab
    • Click the ENABLE PUBLIC DEVICE URL button
    • Note down your device's public URL!
  • When your device finishes updating visit your device's IP or public URL to watch your stream!
    • You can find your device's IP on the Resin dashboard.
  • Further explore UV4L's configuration options and edit the config file
  • Make sure to update your devices after every change you make! You can either:

    • Commit your changes and do another git push resin master

    • Learn more about the powerful resin-cli and how you can iterate and deploy to your devices rapidly!

      Running a simple resin sync in your working directory will sync your changes to local devices faster than a git push.

Configure via environment variables

Variable Name Default Description
width 640 video width
height 480 video height
framerate 30 video framerate
rotation 0 video rotation (0/90/180/270 degrees)

If you want to add more environment variables to control UV4L's config file add a line of this format set_option <UV4L_OPTION_NAME> $<ENV_VAR_NAME> <PATH_TO_CONFIG> to the start script. It will be easy once you see the existing lines.

License

Copyright 2017 Resinio Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.