Skip to content
Snippets Groups Projects
README.md 4.89 KiB
Newer Older
Justin Wood's avatar
Justin Wood committed
# Connected Home over IP

Justin Wood's avatar
Justin Wood committed
[![Build Status](https://travis-ci.com/project-chip/connectedhomeip.svg?token=hBypqqXx6Ha9n3zZgyp7&branch=master)](https://travis-ci.com/project-chip/connectedhomeip)
[![codecov](https://codecov.io/gh/project-chip/connectedhomeip/branch/master/graph/badge.svg?token=KP9791CN9W)](https://codecov.io/gh/project-chip/connectedhomeip)
Justin Wood's avatar
Justin Wood committed

# Getting started with CHIP

All documentation is inside of the [docs section](./docs/README.md)

Instructions about how to build and develop CHIP can be found
[here](./docs/README.md#building-and-developing).
Justin Wood's avatar
Justin Wood committed

# Need help?

There are numerous avenues for CHIP support:

-   Bugs and feature requests
    [submit to the Issue Tracker](https://github.com/project-chip/connectedhomeip/issues)
-   Stack Overflow
    [post questions using the chip tag](http://stackoverflow.com/questions/tagged/chip)
Justin Wood's avatar
Justin Wood committed

# Directory Structure

The CHIP repository is structured as follows:

| File / Folder                 | Contents                                                                                                      |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `.default-version`            | Default CHIP version if none is available via source code control tags, `.dist-version`, or `.local-version`. |
| `bootstrap`                   | GNU autotools bootstrap script for the CHIP build system.                                                     |
| `bootstrap-configure`         | Convenience script that will bootstrap the CHIP build system, via `bootstrap`, and invoke `configure`.        |
| `build/`                      | Build system support content and build output directories                                                     |
| `BUILDING.md`                 | More detailed information on configuring and building CHIP for different targets                              |
| `CODE_OF_CONDUCT.md`          | Code of Conduct for CHIP, and contributions to it                                                             |
| `CONTRIBUTING.md`             | Guidelines for contributing to CHIP                                                                           |
| `CONTRIBUTORS.md`             | Contributors to CHIP                                                                                          |
| `docs/`                       | Documentation                                                                                                 |
| `examples/`                   | Example firmware applications that demonstrate use of CHIP technology                                         |
| `integrations/`               | Third party integrations related to this project                                                              |
| `integrations/github/`        | GitHub integrations related to this project                                                                   |
| `integrations/github/actions` | GitHub actions related to this project                                                                        |
| `integrations/docker/`        | Docker scripts and Dockerfiles                                                                                |
| `images/`                     | Images                                                                                                        |
| `LICENSE`                     | CHIP License file (Apache 2.0)                                                                                |
| `Makefile-Android`            | Convenience makefile for building CHIP against Android.                                                       |
| `Makefile-iOS`                | Convenience makefile for building CHIP against iOS.                                                           |
| `Makefile-Standalone`         | Convenience makefile for building CHIP as a standalone package on desktop and server systems.                 |
| `README.md`                   | This file                                                                                                     |
| `src/`                        | Implementation of CHIP                                                                                        |
| `tests/`                      | Tests for CHIP                                                                                                |
| `third_party/`                | Third-party code used by CHIP.                                                                                |
| `tools/`                      | Tools needed to work with the CHIP repo, as well as develop in the repository                                 |
Justin Wood's avatar
Justin Wood committed

# Contributing

We would love for you to contribute to CHIP and help make it even better than it
is today! See the [CONTRIBUTING.md](./CONTRIBUTING.md) file for more
information.
Justin Wood's avatar
Justin Wood committed

# License

CHIP is released under the [Apache 2.0 license](./LICENSE) Please read more
details therein