Home

Awesome

<p align="center"> <img height="200" src="https://user-images.githubusercontent.com/39277388/96489837-43d26180-1240-11eb-9d0e-5cfa84040fe1.png"> </p> <p align="center"> <a target="_blank" href="https://github.com/roleoroleo/yi-hack-Allwinner-v2/releases"> <img src="https://img.shields.io/github/downloads/roleoroleo/yi-hack-Allwinner-v2/total.svg" alt="Releases Downloads"> </a> </p>

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

Table of Contents

Installation

Backup

It's not easy to brick the cam but it can happen. So please, make your backup copy: https://github.com/roleoroleo/yi-hack-Allwinner-v2/wiki/Dump-your-backup-firmware-(SD-card)

Anyway, the hack procedure will create a backup for you.

Install Procedure

If you want to use the original Yi app, please install it and complete the pairing process before installing the hack.

Otherwise, check setep 4.

  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. Your card should appear with this structure:
|-- Factory/
|-- yi-hack/
|-- lower_half_init.sh
  1. (Optional) If you want to set wifi credentials, rename the file Factory/configure_wifi.cfg.ori to Factory/configure_wifi.cfg and edit the file with your username and password.
  2. Insert the SD Card and reboot the camera
  3. Wait a minute for the camera to update.
  4. Check the hack opening the web interface http://IP-CAM (where IP-CAM is the IP address of the cam assigned by your router).
  5. Don't remove the microSD card (yes this hack requires a dedicated microSD card).
  6. Check the FAQ if you have a problem: https://github.com/roleoroleo/yi-hack-Allwinner-v2/wiki/FAQ

Online Update Procedure

  1. Go to the "Maintenance" web page
  2. Check if a new release is available
  3. Click "Upgrade Firmware"
  4. Wait for cam reboot

Manual Update Procedure

Check the wiki: https://github.com/roleoroleo/yi-hack-Allwinner-v2/wiki/Manual-firmware-upgrade

Optional Utilities

Several optional utilities are avaiable, some supporting experimental features like text-to-speech.

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.

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 snapshots may cause frequent reboots. So, enable swap file even if this will waste the sd

Supported cameras

Currently this project supports only the following cameras:

CameraSN prefixFirmwareFile prefixRemarks
Yi 1080p HomeBFUS - IFUS - RFUS9.0.19*y21ga-
Yi 1080p HomeBFUS - IFUS - RFUS12.1.19*y21ga-
Yi 1080p HomeIFUS - QFUS - RFUS9.0.36*y211ga-
Yi 1080p HomeIFUS - QFUS - RFUS12.0.37*y211ga-
Yi 1080p HomeQFUS - RFUS9.0.35*y291ga-
Yi 1080p HomeQFUS - RFUS12.0.35*y291ga-
Yi Outdoor 1080pIFUS - RFUS9.0.26*h30ga-
Yi Outdoor 1080pIFUS - RFUS11.1.26*h30ga-
Yi 1080p Dome*FUS9.0.05*r30gbbeta version (check this issue https://github.com/roleoroleo/yi-hack-Allwinner-v2/issues/484)
Yi 1080p Dome*FUS12.1.05*r30gbbeta version (check this issue https://github.com/roleoroleo/yi-hack-Allwinner-v2/issues/484)
Yi Dome GuardYRS9.0.05*r30gbbeta version (check this issue https://github.com/roleoroleo/yi-hack-Allwinner-v2/issues/484)
Yi Dome Camera U (Full HD)BFUS - SFUS9.0.22*h52ga-
Yi Dome Camera U (2K)BFUS - SFUS9.0.21*h51ga-
Yi Dome U Pro 2KLFUS9.0.27*h60ga-
Yi Outdoor 1080pQFUS9.0.45*r40ga-
Yi Home Y4IFCN9.0.09*y29ga-
Yi Dome GuardQFUS9.0.46*r35gb-
Yi Dome GuardQFUS12.1.47*r35gb-
Yi Dome GuardYRS9.0.46*r35gb-
Yi Dome GuardYRS12.1.47*r35gb-
Yi Pro 2K HomeRFUS - YFUS - ZFUS12.0.51*y623-
Kami mini homeIFUS9.0.20*y28ga-
MIBAO G1 1296p dome-9.0.04*qg311r-
BLITZWOLF BW-YIC1-9.0.41*b091qp-
ESCAM PT202-9.0.41*b091qphttps://github.com/roleoroleo/yi-hack-Allwinner-v2/discussions/624#discussioncomment-5816561
YS-QC-02-9.0.41*b091qphttps://github.com/roleoroleo/yi-hack_ha_integration/issues/84
Flood Light Camera Outdoor L850Y-US-9.0.41*b091qp-
Tovendor Mini Smart Home Camera-9.0.41*b091qp-

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

Is my cam supported?

If you want to know if your cam is supported, please check the serial number (first 4 letters) and the firmware version. If both numbers appear in the same row in the table above, your cam is supported. If not, check the other projects related to Yi cams:

Home Assistant integration

Are you using Home Assistant? Do you want to integrate your cam? Try these custom integrations:

You can also use the web services in Home Assistant -- here's one way to do that. (This example requires the nanotts optional utility to be installed on the camera.) Set up a rest_command in your configuration.yaml to call one of the web services.

rest_command:
  camera_announce:
    url: http://[camera address]/cgi-bin/speak.sh?lang={{language}}&voldb={{volume}}
    method: POST
    payload: "{{message}}"

Create an automation and use yaml in the action to send data to the web service.

service: rest_command.camera_announce
data:
  language: en-US
  message: "All your base are belong to us."
  volume: '-8'

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-v2
  3. Init modules: git submodule update --init
  4. Compile: ./scripts/compile.sh
  5. Pack the firmware: ./scripts/pack_fw.all.sh

Instead of installing the SDK on your host machine, there's also the option to use a devcontainer from within Visual Studio Code. Please ensure you have the Remote - Containers extension installed for this to work.

Unbricking

If your camera doesn't start, no panic. This hack is not a permanent change, remove your SD card and the cam will come back to the original state. If the camera still won't start, try the "Unbrick the cam" procedure https://github.com/roleoroleo/yi-hack-Allwinner-v2/wiki/Unbrick-the-cam.


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 :)

Click here or use the below QR code to donate via PayPal

<p align="center"> <img src="https://github.com/roleoroleo/yi-hack-Allwinner-v2/assets/39277388/37ff6496-0903-4633-b203-9569b28e0f1c"/> </p>