/yi-hack-Allwinner

Primary LanguageHTMLMIT LicenseMIT

yi-hack-Allwinner is a modification of the firmware for the Allwinner-based Yi Camera platform.

Table of Contents

Installation

Update Procedure

  1. Format an SD Card as FAT32. It's recommended to format the card in the camera using the camera's native format function. If the card is already formatted, remove all the files.
  2. Download the latest release from the Releases page
  3. Extract the contents of the archive to the root of your SD card.
  4. Insert the SD Card and reboot the camera
  5. Wait for the camera to update. It will reboot a couple of times as the camera is rooted and the new firmware is applied. It can take up to an hour to update. Once the light is solid blue for at least a minute it is complete.

Contributing and Bug Reports

See CONTRIBUTING

Features

This custom firmware contains features replicated from the yi-hack-MStar project and similar to the yi-hack-v4 project.

  • FEATURES
    • RTSP server - allows a RTSP stream of the video (high and/or low resolution) and audio (thanks to @PieVo for the work on MStar platform).
      • rtsp://IP-CAM/ch0_0.h264 (high res)
      • rtsp://IP-CAM/ch0_1.h264 (low res)
      • rtsp://IP-CAM/ch0_2.h264 (only audio)
    • ONVIF server (with support for h264 stream, snapshot, ptz, presets and WS-Discovery) - standardized interfaces for IP cameras.
    • Snapshot service - allows to get a jpg with a web request.
    • MQTT - Motion detection and baby crying detection through mqtt protocol.
    • Web server - web configutation interface (port 8080).
    • SSH server - dropbear.
    • Telnet server - busybox.
    • FTP server.
    • FTP push: export mp4 video to an FTP server (thanks to @Catfriend1).
    • Authentication for HTTP, RTSP and ONVIF server.
    • Proxychains-ng - Disabled by default. Useful if the camera is region locked.
    • The possibility to change some camera settings (copied from official app):
      • camera on/off
      • video saving mode
      • detection sensitivity
      • AI human detection (thanks to @BenjaminFaal)
      • baby crying detection
      • status led
      • ir led
      • rotate
    • Management of motion detect events and videos through a web page.
    • View recorded video through a web page (thanks to @BenjaminFaal)
    • PTZ support through a web page (if the cam supports it).
    • The possibility to disable all the cloud features.
    • Swap File on SD
    • Online firmware upgrade
    • Load/save/reset configuration

Performance

The performance of the cam is not so good (CPU, RAM, etc...). Low ram is the bigger problem. If you enable all the services you may have some problems. For example, enabling both rtsp streams is not recommended. Disable cloud is recommended to save resources. If you notice problems and you have a SD to waste, try to enable swap file.

Supported cameras

Currently this project supports only the following cameras:

Camera Firmware File prefix Remarks
Yi 1080p Home 9FUS 8.2.0* y20ga -
Yi 1080p Home BFUS 8.2.0* y20ga -

USE AT YOUR OWN RISK.

Do not try to use a fw on an unlisted model

Do not try to force the fw loading renaming the files

Build your own firmware

If you want to build your own firmware, clone this git and compile using a linux machine. Quick explanation:

  1. Download and install the SDK as described here
  2. clone this git: git clone https://github.com/roleoroleo/yi-hack-Allwinner
  3. Init modules: git submodule update --init
  4. Compile: ./scripts/compile.sh
  5. Pack the firmware: ./scripts/pack_fw.all.sh

License

MIT

DISCLAIMER

NOBODY BUT YOU IS RESPONSIBLE FOR ANY USE OR DAMAGE THIS SOFTWARE MAY CAUSE. THIS IS INTENDED FOR EDUCATIONAL PURPOSES ONLY. USE AT YOUR OWN RISK.

Donation

If you like this project, you can buy Roleo a beer :) paypal