Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SDK Rework and matter.js addition #31

Closed
wants to merge 11 commits into from
3 changes: 2 additions & 1 deletion AUTHORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,5 @@ The following people have contributed to the contents of this site.
- Jeff Bumgardner
- Joni Thrift
- Juan Carlos Pacheco
- Sam Machin
- Sam Machin
- Ingo Fischer
67 changes: 67 additions & 0 deletions content/Certification/MatterFastTrackRecertificationFAQ.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
+++
title = "Matter FastTrack Recertification FAQ"

chapter = false
weight = 10
+++

**What is Matter FastTrack Recertification?**

Matter FastTrack Recertification is a new program for recertification of previously certified Matter products that reduces the cost and friction involved in releasing software updates for these products. With FastTrack, Alliance Member companies that are trained in the proper use of Matter Certification tools can perform their own testing of updated products and obtain Matter certification of the result for no additional Alliance fee. The conformance of every certified Matter product is initially validated by an Alliance-approved Authorized Test Lab (ATL), but with FastTrack, qualified Member companies in many cases can validate their own conformance of software updates to their certified Matter product without being required to return to the ATL.

**Why did we create this new program?**

As with any new standard and its implementation, the first few generations of products incorporate improvements in many areas such as reliability, resiliency, scalability, features, and even simple bug fixes. With Matter we have found that the best products issue software updates to pick up these improvements, but feedback from Matter product makers has been that the cost and overhead of recertification can create obstacles to providing such updates. We took that feedback seriously and to that end introduced the Matter FastTrack Recertification and Portfolio Certification programs to Members in November 2024. The new FastTrack Recertification program streamlines the recertification process for product makers, reducing costs and overhead for releasing important updates. Both FastTrack and Portfolio programs can help reduce the TCO for high-quality Matter end products and families of products.

**What can Members do now that they weren’t able to do before?**

FastTrack Recertification enables Members who are trained in the use of certification tools to perform their own testing and validation of software updates. This Trust-but-Verify approach to recertification eliminates many of the costs and additional time-consuming steps for product makers, decreasing overall TCO for high-quality Matter end products.
FastTrack allows Members to self-test without additional Log Review by an Authorized Test Lab (ATL) or additional Alliance fees. In order to qualify for the FastTrack Recertification program, a Member company must meet certain qualifications such as tool training, and must submit two units of their product to the Alliance Interoperability Testing Facility (Interop Lab) within a certain time period. By providing product samples to the Interop Lab, additional testing can be done to verify the behavior of the latest version of products on the market.

**What other benefits does FastTrack Recertification provide?**

* Encourages Rapid Improvement in Quality Products
* Members may deploy bug and security fixes without external schedule dependencies such as ATL validation or waiting for completion of Alliance recertification documentation verification and payment processing. It reduces obstacles to Members upgrading their products to the latest version of Matter, improving the experience for Matter product customers.
* Reduces Certification Fees
* With this new approach, recertification fees paid to ATLs and the Alliance can be reduced to zero. Initial certification which requires ATL validation and Alliance certification fees is still required, but subsequent recertifications can be issued without these costs.
* Clarifies Total Cost of Certification
* Helps provide predictability in the business case for making Matter products, because Members will better understand the total cost associated with certification over the lifetime of products, during which software updates are expected.
* Enhances End User Experience
* Each iteration of Matter includes bug fixes and performance improvements. Enabling Members to quickly and cost-effectively upgrade to the latest version of the Matter SDK enables a better user experience for Matter products.

**Why should I update to the latest version of the Matter SDK?**

The open source SDK includes the latest optimizations and bug fixes to improve the user experience of Matter products. By keeping up-to-date with the latest version of Matter, you can take advantage of new features, bug fixes, security enhancement, performance improvements, and interoperability improvements, increasing customer satisfaction.

**I have a Certified product. What do I need to do now to take advantage of this program?**

* **Step 0** Train Members of your development team to become qualified to use this program by attending formally approved Rapid Recert Training programs
* **Step 1** Test internally using the established Alliance-provided test suite. This will confirm protocol compliance.
* **Step 2** Submit your documents to the Alliance Certification Team.
* **Step 3** Send 2 units to the Alliance Interoperability Testing Facility (Interop Lab). Alliance engineers will perform tests across Operating Systems and Ecosystems to confirm that your product works in the real world. It is not necessary to wait for the completion of the interop testing. You are permitted to implement your s/w update on your product, and ship it/OTA upgrade to deployed devices, as soon as step 2 is completed.
It’s important to note that while you don’t need to have tests run at an ATL, you do need to run the tests internally and keep the logs for 5 years.


**How do I know if my product qualifies for FastTrack Recertification?**

* First, you need a Matter certified product. All Matter devices must go through Initial Certification.
* Second, you must attend a training to become qualified for the self-testing; there are two paths to completion. The first path is to attend a specification validation event (SVE); the second path is to attend Rapid Recertification Training offered during Alliance Member meetings.
* The scope of changes permitted is limited to basic software updates; any additional changes to Matter-related functionality must go through General Recertification (including ATL testing). The scope of permissible changes includes:
* Security fixes
* Critical bug fixes
* Fixes to improve interoperability
* Updates to a newer spec version
* A spec version that is certifiable at the time of applying for recertification using FRP
* The Alliance reserves the right to restrict the use of FastTrack for certain specification updates
* SDK updates recommended by Matter SC and approved by the TCOC
* Device improvements and bug fixes

**How do I send my products to the Interoperability Testing Facility?**

You can find more information about the [Interop Lab](https://csa-iot.org/certification/interop-lab/) and its additional benefits on the Alliance’s website. You can also contact <interop@csa-iot.org>.

**Can I use the Fast Track Recert program with the Certification Transfer Program (CTP)?**

* Provided that you obtained your original certification via a Certification Transfer, you can subsequently use the Fast Track Recert program to obtain an Expedited Transfer when your original device developer (Transfer partner Member) updates their original product using the Fast Track program. In the case of an Expedited Transfer, the application process is the same as the original transfer, however, there is no certification fee associated with obtaining the recertification for your updated transfer product.
* As there is no testing involved in a certification obtained by CTP or Expedited Transfer, this allows those Members who are not able to access Rapid Recert training, to benefit from the Fast Track Recert program.

11 changes: 11 additions & 0 deletions content/Certification/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
+++
title = "Certification"
chapter = true
weight = 4
pre = "<b>4. </b>"
+++

# Certification

This section contains information on the Matter certification process, including requirements for different certification programs, and steps for obtaining certification.

43 changes: 43 additions & 0 deletions content/Development/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
+++
title = "Development"
chapter = true
weight = 4
pre = "<b>4. </b>"
+++

# Matter Development

Developers have multiple options for creating Matter-certified devices, bridges, or controllers. The official Matter SDK is the recommended choice for most projects, but alternative implementations, such as JavaScript, also offer compelling features for certain use cases.

The following table provides a general overview of various use cases for the available SDKs:

| Use Case | Official SDK | JavaScript SDK |
|---------------------------------------------------------------------------|--------------|----------------|
| Compliant with Matter version | 1.4 | 1.3 |
| Participate in development of new Matter features | X | – |
| Use for embedded platforms with strict memory and performance constraints | X | – |
| Chipset-specific implementations (e.g. Wi-Fi/Thread) | X | – |
| Use on OS-based platforms: Linux, macOS | X | X |
| Use on Windows | – | X |
| Ideal for rapid prototyping and testing | – | X |

## The official Matter SDK

The official Matter SDK, written in C++, is fully aligned with the latest Matter specifications and optimized for embedded devices with strict memory and performance constraints. It serves as the foundation for most chipset-specific SDKs.

The SDK is compatible with Linux and Darwin platforms and supports integration as a binary dependency for Python, Objective-C, and Java bindings. It includes several example applications for different platforms and supports configuration for various endpoints and clusters using the ZAP tool.

To learn more, go to the [Matter SDK Documentation](https://project-chip.github.io/connectedhomeip-doc/index.htm).

## matter.js - The Matter JavaScript SDK

The JavaScript SDK implements Matter in pure JavaScript, utilizing TypeScript’s typing system for automatic data and system model compliant development. It can be used to build devices, bridges, and controllers running an operating system where a JavaScript runtime, like Node.js, is available.

This SDK includes ready-to-use example projects and is particularly suited for rapid prototyping and testing, thanks to its compliance-by-default approach and the simple but powerful API design.

To learn more, go to the [Matter JavaScript SDK documentation](https://matter-js.github.io/docs/index.html).

Note: Some features of the Matter protocol are not yet implemented in the JavaScript SDK. For details about this check the [matter.js Compatibility Information](https://github.com/project-chip/matter.js/blob/main/docs/MATTER_COMPATIBILITY.md).



4 changes: 2 additions & 2 deletions content/Glossary/_index.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
+++
title = "Glossary"
chapter = true
weight = 6
pre = "<b>6. </b>"
weight = 7
pre = "<b>7. </b>"
+++

# Glossary & Acronym Decoder
Expand Down
4 changes: 2 additions & 2 deletions content/Guides/_index.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
+++
title = "Guides"
chapter = true
weight = 5
pre = "<b>5. </b>"
weight = 6
pre = "<b>6. </b>"
+++

# Guides
Expand Down
9 changes: 0 additions & 9 deletions content/SDK/_index.md

This file was deleted.

Loading