OpenPuck/OpenPuck/puck_hid.h

// puck_hid.h -- the Steam Controller puck personality (MODE_STEAM + MODE_LIZARD).
//
// This is the controller that wears Valve's identity (28DE:1304) and exposes the four puck HID slot interfaces
// (interface N owns bond slot N). It implements:
//   - the puck feature COMMAND CHANNEL (handleSet/handleGet): reports 0x83/0xAE/0xB4/0xAD/0xA2/0xA3 the host
//     uses to read attributes/serials and read/write/clear bond slots, plus the host->controller haptic relay
//     ride-along on OUTPUT reports 0x80-0x86 and feature passthrough (report 0x01).
//   - the seamless LIZARD decision: when Steam is driving the gamepad (recent OUTPUT/heartbeat) we forward the
//     gamepad report 0x45; when Steam is closed we present keyboard+mouse on the SAME interface. lizardActive()
//     is the single source of truth, shared with the haptic gate so we never buzz while Steam isn't reading.
//   - the USB connection-state presentation (reports 0x79 / 0x7B) Steam reads to mark the controller connected.
#pragma once
#include "controllers.h"
#include <stdint.h>

// Steam mode: forward report 0x45 only when the seq advanced (dedupe like the real puck). Sending stale
// repeats makes Steam's trackpad smoothing stair-step. Toggle to A/B (WebUSB field 14).
extern uint8_t g_fwdNewOnly;

class SteamPuckController : public IController {
public:
  void begin() override;
  void onReport45(const uint8_t* rep, bool fresh, uint8_t bodyTlen) override;
  void task() override;
  bool isPuck() const override { return true; }
};
extern SteamPuckController g_steamPuck;