module Matter::SetupPayload

Overview

SetupPayload handles encoding and decoding of Matter onboarding payloads

Matter devices use two types of setup codes:

  1. Manual Pairing Code: 11-digit decimal code (formatted as xxxx-xxx-xxxx)
  2. QR Code: Longer base38-encoded string with additional device information

Manual Pairing Code Format (Matter Core Spec § 5.1.4.1):

The 11-digit code is computed as: (discriminator << 27) | PIN Then the Verhoeff check digit is appended.

Defined in:

matter/setup_payload.cr

Class Method Summary

Class Method Detail

def self.default_pin : UInt32 #

Generate a default PIN for testing/examples Returns a valid PIN that's easy to remember


[View source]
def self.format_manual_code(code : String) : String #

Format an 11-digit code as xxxx-xxx-xxxx


[View source]
def self.generate_manual_code(discriminator : UInt16, pin : UInt32, validate : Bool = true) : String #

Generate a manual pairing code from discriminator and PIN

@param discriminator Device discriminator (12-bit value, 0-4095) @param pin Setup PIN code (27-bit value, 1-99999998, excluding invalid PINs) @param validate Whether to validate PIN security requirements (default: true) @return 11-digit manual pairing code string (formatted as xxxx-xxx-xxxx)

Algorithm from matter.js PairingCodeSchema.ts (Matter Core Spec § 5.1.4.1)


[View source]
def self.generate_random_discriminator : UInt16 #

Generate a random discriminator (12-bit value, 0-4095) Each device instance should have a unique discriminator


[View source]
def self.generate_random_pin : UInt32 #

Generate a random valid PIN that meets Matter requirements

  • Must be 1-99999998
  • Cannot be all same digit (11111111, etc.)
  • Cannot be 12345678 or 87654321

[View source]
def self.generate_serial_number : String #

Generate a serial number


[View source]
def self.generate_unique_id : String #

Generate a unique ID (UUID-like format)


[View source]
def self.parse_manual_code(formatted_code : String) : Tuple(UInt16, UInt32) #

Parse a formatted manual code back to discriminator and PIN

@param formatted_code Manual code in xxxx-xxx-xxxx format (or with spaces/dashes stripped) @return Tuple of {discriminator, pin}

Note: Manual pairing codes only encode the SHORT discriminator (top 4 bits of the full 12-bit discriminator). This function reconstructs the full discriminator from those 4 bits by assuming the lower 8 bits are zero. Algorithm from matter.js PairingCodeSchema.ts


[View source]
def self.short_discriminator(discriminator : UInt16) : UInt16 #

Compute the short discriminator (4 bits: bits 8-11 of the full 12-bit discriminator) This is what gets encoded in manual pairing codes


[View source]
def self.test_vendor_id : UInt16 #

generate a test vendor id


[View source]