PacketCodec

ADC conversions the firmware spends on each channel per impedance measurement (5 settling + 20 measured). In impedance mode the device counter advances this many samples per active channel between two values.

Longest run of missing samples the decoder fills with dummies, in seconds of signal at the stream's rate. A longer jump is more likely a counter discontinuity than a real gap, so the cursor resyncs to the wire instead without dummies and DecodeState.counterJumps counts it.

Convert a 24-bit integer to 32-bit, preserving sign.

Decode one stream packet into typed EegFrames, advancing state. hardware decides the footer layout (accelerometer / gyroscope blocks present or not); it defaults to the V2 board of the config's model, which is every device without a readable Model Number. Returns true on success, false if the packet was malformed. See decodeRaw for the positional output.

Decode one stream packet, emitting a positional layout per sample: [ch_0 … ch_{A-1}, (accX, accY, accZ if accel), (gyroX, gyroY, gyroZ if gyro), sampleIndex, dummyFlag, battery], where dummy (gap-fill) samples use channelCount leading zeros and dummyFlag = 1. IMU values are raw int16 counts. Its sampleIndex column is a Float, exact only up to 2^24 — long recordings must take the index from decode instead.

Encode a DeviceConfig into the channel-config characteristic blob, the layout the firmware parses: