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.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]