pf1550_registers.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <cstdint>
 
namespace pf1550 {
 
inline constexpr uint8_t kDefaultI2cAddress = 0x08;
 
inline constexpr uint8_t kExpectedDeviceId = 0x7C;
 
inline constexpr uint16_t kVsnvsMillivolts = 3000;
 
inline constexpr uint8_t kChargerPageBase = 0x80;
 
enum class Register : uint8_t {
  // --- §12.1 — identity & metadata ---
  DeviceId       = 0x00,  
  OtpFlavor      = 0x01,  
  SiliconRev     = 0x02,  
 
  // --- §12.1 — top-level interrupt category mask ---
  IntCategory    = 0x06,  
 
  // --- §12.1 — switching regulator interrupt status / mask / sense ---
  SwIntStat0     = 0x08,  
  SwIntMask0     = 0x09,  
  SwIntSense0    = 0x0A,  
  SwIntStat1     = 0x0B,  
  SwIntMask1     = 0x0C,  
  SwIntSense1    = 0x0D,  
  SwIntStat2     = 0x0E,  
  SwIntMask2     = 0x0F,  
  SwIntSense2    = 0x10,  
 
  // --- §12.1 — LDO fault / temperature / ONKEY / MISC ---
  LdoIntStat0    = 0x18,  
  LdoIntMask0    = 0x19,  
  LdoIntSense0   = 0x1A,  
 
  TempIntStat0   = 0x20,  
  TempIntMask0   = 0x21,  
  TempIntSense0  = 0x22,  
 
  OnKeyIntStat0  = 0x24,  
  OnKeyIntMask0  = 0x25,  
  OnKeyIntSense0 = 0x26,  
 
  MiscIntStat0   = 0x28,  
  MiscIntMask0   = 0x29,  
  MiscIntSense0  = 0x2A,  
 
  CoinCellCtrl   = 0x30,  
 
  // --- §12.1 — Switch 1 (SW1 / BUCK1) ---
  Sw1Volt        = 0x32,  
  Sw1StbyVolt    = 0x33,  
  Sw1SlpVolt     = 0x34,  
  Sw1Ctrl        = 0x35,  
  Sw1Ctrl1       = 0x36,  
 
  // --- §12.1 — Switch 2 (SW2 / BUCK2) ---
  Sw2Volt        = 0x38,  
  Sw2StbyVolt    = 0x39,  
  Sw2SlpVolt     = 0x3A,  
  Sw2Ctrl        = 0x3B,  
  Sw2Ctrl1       = 0x3C,  
 
  // --- §12.1 — Switch 3 (SW3 / BUCK3) ---
  Sw3Volt        = 0x3E,  
  Sw3StbyVolt    = 0x3F,  
  Sw3SlpVolt     = 0x40,  
  Sw3Ctrl        = 0x41,  
  Sw3Ctrl1       = 0x42,  
 
  // --- §12.1 — VSNVS / VREFDDR ---
  VsnvsCtrl      = 0x48,  
  VrefDdrCtrl    = 0x4A,  
 
  // --- §12.1 — LDOs ---
  Ldo1Volt       = 0x4C,  
  Ldo1Ctrl       = 0x4D,  
  Ldo2Volt       = 0x4F,  
  Ldo2Ctrl       = 0x50,  
  Ldo3Volt       = 0x52,  
  Ldo3Ctrl       = 0x53,  
 
  // --- §12.1 — Power-control / debounce ---
  PwrCtrl0       = 0x58,  
  PwrCtrl1       = 0x59,  
  PwrCtrl2       = 0x5A,  
  PwrCtrl3       = 0x5B,  
 
  // --- §12.1 — Power-down sequencing ---
  Sw1PwrDnSeq    = 0x5F,  
  Sw2PwrDnSeq    = 0x60,  
  Sw3PwrDnSeq    = 0x61,  
  Ldo1PwrDnSeq   = 0x62,  
  Ldo2PwrDnSeq   = 0x63,  
  Ldo3PwrDnSeq   = 0x64,  
  VrefDdrPwrDnSeq = 0x65, 
 
  // --- §12.1 — Machine state / addressing / clock ---
  StateInfo      = 0x67,  
  I2cAddrReg     = 0x68,  
  Rc16Mhz        = 0x6B,  
 
  // --- §12.1 — OTP indirect read ---
  OtpKey1        = 0x6F,  
  ChargerLedDuty = 0x9C,  
  OtpKey2        = 0x9F,  
  ChargerLedCtrl = 0x9E,  
  VbusInCurrentLimit = 0x94, 
  FmrAddr        = 0xC4,  
  FmrData        = 0xC5,  
  TestRegKey3    = 0xDF,  
 
  // --- §12.2 — Charger sub-page (offset 0x80) ---
  ChgInt         = 0x80,  
  ChgIntMask     = 0x82,  
  ChgIntOk       = 0x84,  
  VbusSns        = 0x86,  
  ChgSense       = 0x87,  
};
 
struct IntCategoryBits {
  static constexpr uint8_t kChg   = 1u << 0; 
  static constexpr uint8_t kSw1   = 1u << 1; 
  static constexpr uint8_t kSw2   = 1u << 2; 
  static constexpr uint8_t kSw3   = 1u << 3; 
  static constexpr uint8_t kLdo   = 1u << 4; 
  static constexpr uint8_t kOnKey = 1u << 5; 
  static constexpr uint8_t kTemp  = 1u << 6; 
  static constexpr uint8_t kMisc  = 1u << 7; 
};
 
struct SwIntStat0Bits {
  static constexpr uint8_t kSw1Ls = 1u << 0; 
  static constexpr uint8_t kSw2Ls = 1u << 1; 
  static constexpr uint8_t kSw3Ls = 1u << 2; 
};
 
struct SwIntStat1Bits {
  static constexpr uint8_t kSw1Hs = 1u << 0; 
  static constexpr uint8_t kSw2Hs = 1u << 1; 
  static constexpr uint8_t kSw3Hs = 1u << 2; 
};
 
struct LdoIntStat0Bits {
  static constexpr uint8_t kLdo1Fault = 1u << 0; 
  static constexpr uint8_t kLdo2Fault = 1u << 1; 
  static constexpr uint8_t kLdo3Fault = 1u << 2; 
};
 
struct TempIntStat0Bits {
  static constexpr uint8_t kTherm110 = 1u << 0; 
  static constexpr uint8_t kTherm125 = 1u << 2; 
  static constexpr uint8_t kTempWarn = kTherm110; 
  static constexpr uint8_t kTempShdn = kTherm125; 
};
 
struct MiscIntStat0Bits {
  static constexpr uint8_t kPwrUp      = 1u << 0; 
  static constexpr uint8_t kPwrDn      = 1u << 1; 
  static constexpr uint8_t kPwrOn      = 1u << 2; 
  static constexpr uint8_t kLowSysWarn = 1u << 3; 
  static constexpr uint8_t kSysOvlo    = 1u << 4; 
  static constexpr uint8_t kVsysLow    = kLowSysWarn; 
  static constexpr uint8_t kVsysOv     = kSysOvlo;    
  [[deprecated("MISC_INT_STAT0 has no WDI bit (Table 108)")]] static constexpr uint8_t kWdiAssert = 0;
  [[deprecated("MISC_INT_STAT0 has no RESETBMCU bit (Table 108)")]] static constexpr uint8_t kResetBmcu = 0;
};
 
enum class PmicState : uint8_t {
  Wait        = 0b000000, 
  Run         = 0b001100, 
  Standby     = 0b001101, 
  Sleep       = 0b001110, 
  RegsDisable = 0b101011, 
  Unknown     = 0xFF,
};
 
enum class ChargerState : uint8_t {
  PreCharge       = 0,   
  FastCC          = 1,   
  FastCV          = 2,   
  EndOfCharge     = 3,   
  Done            = 4,   
  TimerFault      = 6,   
  ThermSuspend    = 7,   
  Off             = 8,   
  BatteryOv       = 9,   
  TempShutdown    = 10,  
  LinearOnly      = 12,  
  Unknown         = 0xFF,
};
 
enum class SwVoltageCode : uint8_t {
  V1_1  = 0x00, 
  V2_5  = 0x05, 
  V3_0  = 0x06, 
  V3_3  = 0x07, 
  V3_1  = 0x0D, 
};
 
enum class LdoVoltageCode : uint8_t {
  V1_0 = 0x05, 
  V1_2 = 0x09, 
  V1_8 = 0x00, 
};
 
struct SwCtrlBits {
  static constexpr uint8_t kEn         = 1u << 0; 
  static constexpr uint8_t kStbyEn     = 1u << 1; 
  static constexpr uint8_t kOMode      = 1u << 2; 
  static constexpr uint8_t kLpwr       = 1u << 3; 
  static constexpr uint8_t kDvsSpeed   = 1u << 4; 
  static constexpr uint8_t kFpwmInDvs  = 1u << 5; 
  static constexpr uint8_t kFpwm       = 1u << 6; 
  static constexpr uint8_t kRdisEnb    = 1u << 7; 
};
 
struct LdoCtrlBits {
  static constexpr uint8_t kEn       = 1u << 0; 
  static constexpr uint8_t kStbyEn   = 1u << 1; 
  static constexpr uint8_t kOMode    = 1u << 2; 
  static constexpr uint8_t kLpwr     = 1u << 3; 
  static constexpr uint8_t kLsEn     = 1u << 4; 
};
 
struct OtpUnlockKeys {
  static constexpr uint8_t kKey1Reg = static_cast<uint8_t>(Register::OtpKey1);
  static constexpr uint8_t kKey1Val = 0x15;
  static constexpr uint8_t kKey2Reg = static_cast<uint8_t>(Register::OtpKey2);
  static constexpr uint8_t kKey2Val = 0x50;
  static constexpr uint8_t kKey3Reg = static_cast<uint8_t>(Register::TestRegKey3);
  static constexpr uint8_t kKey3Val = 0xAB;
};
 
struct OtpRegion {
  static constexpr uint8_t kStart        = 0x1C; 
  static constexpr uint8_t kEndExclusive = 0x37; 
};
 
} // namespace pf1550