hauke / philips-hue-bsb002

Source code for Philips Hue Bridge 2.0

CCS Release: Hue Bridge 2.0, version 1811120916

This package includes the Complete Corresponding Machine-readable Source Code as defined in the GPLv2 for the Hue Bridge 2.0.

The following is included:

1. All the source code for open-source licensed modules in the product.
2. All associated interface definition files.
3. The scripts used to compile compilation.
4. The scripts (instructions) used to install the resulting executables.

Cryptographic lock-down

The Hue Bridge 2.0 is cryptographically locked down. We would have loved to ship a fully hackable device, but certification requirements can sometimes get in the way. We can therefore not provide you with usable installation instructions that will not void the waranty on your Hue Bridge 2.0.

Compilation

Prerequisites

To build the CCS, you need the following:

1. Linux distribution: Ubuntu 16.04.5 LTS
2. Required executables: gcc g++ objcopy patch bzip2 flex make xgettext pkg-config unzip svn gawk ocamlyacc cmake hg ocamlfind repo ubireader_extract_images unsquashfs openssl firejail srec_cat curl python3 pip3 pip3 mkdir repo git grep mkenvimage unix2dos
3. Required debian packages: libunwind-dev libssl-dev zlib1g-dev liblzo2-dev
4. Required Python packages (installed with pip): yaml magic openpyxl git xmlrunner lzo lxml

Notes:

• The required executables is not an exaustive list. It should however cover at least the non-default packages for Ubuntu 16.04.5 LTS.
• If you try to call any missing executables on the command-line, Ubuntu 16.04.5 LTS should suggest the missing package.

Steps

1. From the directory containing this README.md file, simply run:make
2. The output images (and contained executables) are copied to bridge/build/bsb002/release/product/factory/bsb002

Installation

WARNING: The installation instructions will void your warranty. If you are not careful, you might also permanently damage your Hue Bridge 2.0.

Prerequisites

You will need the following:

1. A PCB solder and rework station.
2. A flash programmer capable of programming the following:

• A GigaDevice GD25Q41BTIGR 3.3V SPI NOR flash part
• A GigaDevice GD5F1GQ4UCYIG 3.3V SPI NAND flash part

Steps

To install the images (and contained executables) to the Hue Bridge 2.0, follow these steps:

1. Open your bridge by removing the screws under the rubber feet.
2. De-solder parts SU9 and SU11 from the PCB, being careful not to damage the pads on the PCB or the parts.
3. Set-up the programmer to correctly program a GigaDevice GD25Q41BTIGR 3.3V SPI NOR flash part.
4. Install SU11 into the flash programmer.
5. Erase address range 0x0 - 0x40000 within SU11, being careful not to erase anything else.
6. Flash bridge/build/bsb002/release/product/factory/bsb002/bsb002_uboot.bin into SU11 at offset 0x0.
7. Remove SU11 from the programmer.
8. Set-up the programmer to correctly program a GigaDevice GD5F1GQ4UCYIG 3.3V SPI NAND flash part:

• Configure erase blocks marked bad to be skipped when erasing.
• Configure erase blocks marked bad to be skipped when programming.

9. Install SU9 into the flash programmer.
10. Erase the entire SU9 device, but do not reset bad block markers.
11. Flash bridge/build/bsb002/release/product/factory/bsb002/kernel.bin into SU9 at both offset 0x0 and 0x2C00000
12. Flash bridge/build/bsb002/release/product/factory/bsb002/root.bin into SU9 at both offset 0x400000 and 0x3000000.
13. Flash bridge/build/bsb002/release/product/factory/bsb002/overlay.bin into SU9 at offset 0x5800000.
14. Remove SU9 from the programmer.
15. Re-solder parts SU9 and SU11 onto the PCB, being careful not to damage the pads on the PCB or the parts.

Export control restrictions

Please read the terms (export control related) in the Code download section as downloading the code implies acceptance of those terms.

Regarding export controls; the source code package includes source code classified as ECCN 5D002 and has been exported in accordance with the Export Administration Regulations under License Exception ENC (740.17)(a)(2). Diversion contrary to U.S. law is prohibited.

By downloading the source code using the link below, you represent and warrant that:

• you understand that the source code is subject to export controls under the Export Administration Regulations ("EAR") which are implemented and enforced by the US Department of Commerce, Bureau of Industry and Security;
• you are not located in a prohibited destination country or are prohibited under the EAR or US sanctions regulations;
• you will not export, re-export, or transfer the source code to any prohibited destination, entity, or individual without the necessary export license(s) or authorizations(s) from the US Government;
• you will not use or transfer the source code for use in any sensitive nuclear, chemical, or biological weapons or missile technology end-uses unless authorized by the US Government by regulation or specific license and
• you understand that countries other than the US may restrict the import, use, or export of encryption products and that you will be solely responsible for compliance with any such import, use, or export restrictions.