dlink-dcs-reversing/README.md
2020-10-27 17:38:25 +01:00

73 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# D-Link DCS reversing
### An effort to simplify firmware analysis and firmware updating on D-Link's DCS line of products
***
## Project goal
The short-term goal of this project is to provide the necessary tools to easily analyze and modify D-Link's firmware for its DCS line of products (such as their network cameras).
A long-term goal is to be able to provide an alternative firmware with only the bare essentials to use the camera in order to fully disable all cloud aspects of the camera and to potentially make it HomeKit-compatible.
## What's in the box
### Scripts
#### Firmware
The `./scripts/download-firmware.sh` script downloads the firmware for a specific product. For example, one can download the latest firmware for the DCS-936L like so:
```sh
./scripts/download-firmware.sh <model> <output directory> [firmware index]
./scripts/download-firmware.sh dcs-936l firmware 1
```
The `./scripts/unpack-firmware.sh` script decrypts, unpacks and carves date from the firmware file. It can be used like so:
```sh
./scripts/unpack-firmware.sh <path to firmware> <output directory>
./scripts/unpack-firmware.sh firmware/DCS-936L_fw_revA1_1-07-04_eu_multi_20180918.zip dump
```
Example (shallow) directory structure for the unpacking script:
```
tree -L 4 -d dump/
dump/
├── carved
│   └── _update.extracted
│   ├── squashfs-root
│   └── squashfs-root-0
│   ├── empty -> /tmp
│   ├── lib -> /tmp
│   ├── lock -> /tmp
│   ├── log -> /tmp
│   ├── run -> /tmp
│   ├── shares
│   ├── tmp -> /tmp
│   └── www
└── extracted
```
### Tools
The `./tools` directory contains dockerized tools such as Binwalk. The tools can be built and used using the following script:
```sh
./tools/build.sh
docker run -it binwalk
```
## Previous art
https://github.com/bmork/defogger
## Contributing
Any contribution is welcome. If you're not able to code it yourself, perhaps someone else is - so post an issue if there's anything on your mind.
### Development
Clone the repository:
```
git clone https://github.com/AlexGustafsson/dlink-dcs-reversing && cd dlink-dcs-reversing
```