Home

Awesome

<p align="center"> <img height="200" src="https://user-images.githubusercontent.com/39277388/90162474-f5629b80-dd94-11ea-874b-74e6b15424b6.png"> </p> <p align="center"> <a target="_blank" href="https://github.com/roleoroleo/sonoff-hack/releases"> <img src="https://img.shields.io/github/downloads/roleoroleo/sonoff-hack/total.svg" alt="Releases Downloads"> </a> </p>

Custom firmware for Sonoff camera (model GK-200MP* see below)

This firmware is based on the yi-hack-Allwinner project. https://github.com/roleoroleo/yi-hack-Allwinner

It's a clone made for Sonoff camera based on Goke platform.

This firmware doesn't overwrite the original one, simply it add some features. For example: RTSP stream is provided through the sonoff original application.

Thanks to @EpicLPer for writing the hack guide for this cam: https://github.com/EpicLPer/Sonoff_GK-200MP2-B_Dump

I have no time to support the project, so feel free to clone/fork this git and modify it as you want.

Table of Contents

Contributing and Bug Reports

See CONTRIBUTING

Features

This firmware contains the following features.

Performance

The performance of the cam is not so good (CPU, RAM, etc...). If you enable all the services you may have some problems. 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:

USE AT YOUR OWN RISK.

Do not try to use this fw on an another model

Getting Started

  1. Check that you have a correct Sonoff camera.

  2. Get a microSD card, 16gb or less, and format it by selecting FAT32 File System.

  3. Get the correct firmware file from the releases section (https://github.com/roleoroleo/sonoff-hack/releases).

  4. Decompress the file (tgz format) on root path of microSD card.

  5. Remove power to the camera, insert the microSD card, turn the power back ON.

  6. Wait a minute.

  7. Go in the browser and access the web interface of the camera as a website (http://IP-CAM). Find the IP address on your router's portal (see connected devices).

  8. Don't remove the microSD card (yes this hack requires a dedicated microSD card).

  9. Done.

URLs, Ports and Default RTSP Password

For both streams if you've set a custom username and password on the config screen don't forget to replace "hack" at the beginning of the URLs! First one is username, second is password. If you want to view the stream in, as example, VLC and haven't set a password you need to enter "hack" for both user and pass.

PTZ not working

If the PTZ controls aren't working at all even on the Web Interface you may have to experiment which of the PTZ control binaries you need.
Connect via SSH onto your camera and first run ptz -a right to confirm that it's indeed not moving. Afterwards try ptz_h -a right or ptz_p -a right and see which one makes your camera move.
Once you found which one works go to your SD card (or connect via SSH/FTP) and rename the corrosponding ptz_h or ptz_p file in "sonoff-hack/bin/" (for SSH/FTP it's "/mnt/mmc/sonoff-hack/bin/") to just ptz. Reboot your camera and enjoy some movement :)
More infos here: https://github.com/roleoroleo/sonoff-hack/issues/93#issuecomment-1351556506

Home Assistant integration

Are you using Home Assistant?

Once MQTT is configured on the cam, Home Assistant will automatically discover the camera and create the mqtt motion sensors. You just need to find your camera under device settings and add these to your dashboard.

Do you want to integrate more features of your cam?

Try this custom integration: https://github.com/roleoroleo/yi-hack_ha_integration

Build your own firmware

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

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.

Acknowledgments

Special thanks to the following people for the previous projects I started from.


License

GPLv3

DISCLAIMER

I AM NOT 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 me a beer :)

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

<p align="center"> <img src="https://github.com/roleoroleo/sonoff-hack/assets/39277388/2a9d66e2-6fbc-4125-ad86-8aa2b1be6439"/> </p>