Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 

README.md

matter.js CHIP container

This is the source for ghcr.io/matter-js/chip published here: https://github.com/matter-js/matter.js-chip

Usage

The matter.js test harness pulls this image automatically when running CHIP tests.

The bin directory contains additional helper scripts you can use on the host:

  • build builds the image
  • rebuild builds the image from scratch
  • shell starts an interactive bash shell inside a local container
  • tool runs chip-tool inside a local container
  • publish pushes the image to GHCR with "latest" tag
  • pull pulls the image from GHCR

The container currently requires host networking and access to a local Avahi for MDNS. In the future we will run Avahi in a utility container and convert to a bridge network.

Building

The Dockerfile implements a multistage buildx that produces a relatively lightweight final image with chip-tool and connectedhomeip certification tests.

Run build to build.

See publish for details on how to push updated images.

We currently build for linux/amd64 and use emulation on Arm Macs. x86 is appropriate for GitHub CI. Building for Arm under emulation is way to slow and running under emulation on MacOS works fine.

Cross-compilation is theoretically possible with chip tooling. Patient volunteers with buildx, gn and ninja experience welcome. 😉