[Request] Guidelines for Upstreaming a New Platform Based on Linux

Author: yifanliamlCreated Sep 15, 2026Updated Sep 17, 2026

We would like to upstream our platform-specific code to the upstream repository.

Our platform is based on Linux, and a significant portion of the platform implementation has been developed based on the existing Linux platform code. If we want to introduce a new platform implementation, for example, our own platform based on Linux, could you please advise us on the recommended approach and requirements for upstreaming it?

We have the following questions:

  1. Should we copy the relevant Linux platform source code into the new platform directory, or should we continue to reuse the existing Linux platform implementation?

  2. Is it sufficient for us to organize and prepare the code locally and then submit a PR for upstream review? The upstream team could then review the implementation and provide feedback through the PR process.

  3. Are there any other requirements, coding guidelines, directory structure conventions, or considerations that we should follow when introducing a new platform?

Thank you for your guidance.

Source: project-chip/connectedhomeip