{
 "manufacturer": "Morningstar",
 "manufacturer_slug": "morningstar",
 "model": "TriStar TS-45 / TS-60 PWM charge, load and diversion controller (Modbus RTU)",
 "model_slug": "tristar-ts-45-ts-60",
 "short_model": "TriStar TS-45/60",
 "aliases": [
  "TS-45",
  "TS-60",
  "TriStar",
  "TriStar PWM"
 ],
 "equipment_type": "Solar charge controller (PWM charge / load / diversion)",
 "applies_to": "Morningstar TriStar TS-45 and TS-60 (non-MPPT) on the RS-232 port; Modbus specification V07 (31 Jan 2020).",
 "summary": "The TriStar TS-45/TS-60 is a PWM controller that runs as a solar charger, a load controller or a diversion regulator. Its RS-232 port speaks Modbus RTU: RAM registers carry battery, array/load voltage and currents, temperatures, Ah counters, control mode/state, alarm and fault bitfields and PWM duty; EEPROM registers hold setpoints, and coils trigger equalize, disconnect, resets and counter clears.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": 9600,
  "parity": "None",
  "data_bits": 8,
  "stop_bits": 2,
  "tcp_port": null
 },
 "addressing": {
  "convention": "hex 0-based",
  "note": "Morningstar lists a hex PDU address (used on the wire unchanged) and a logical address one higher. The spec says all listed addresses are request-PDU addresses; its scaling example reads battery voltage at PDU 0x0008."
 },
 "default_word_order": "ABCD",
 "firmware": "Alarm_HI (0x001D) needs software newer than 1.04.02; data logger needs firmware v13+.",
 "source": {
  "title": "TriStar MODBUS Specification",
  "doc_number": "V07",
  "revision_date": "2020-01-31",
  "url": "https://www.morningstarcorp.com/wp-content/uploads/technical-doc-tristar-modbus-specification-en.pdf",
  "pages": "p. 3 (parameters), pp. 4-7 (RAM, EEPROM, coils), pp. 10-13 (definitions), pp. 23-26 (coils, example, alarm/fault bits)"
 },
 "notes": [
  "Scaling: formulas n x 96.667 x 2^-15 (battery voltages), n x 139.15 x 2^-15 (array/load voltage), n x 66.667 x 2^-15 (charging current) and n x 316.67 x 2^-15 (load current) are converted to single multipliers. Example from the spec: 0x1007 = 4103 x 96.667 / 32768 = 12.1 V.",
  "Word order: the RAM table names each pair HI word first (Ah_r_HI 0x0011, Ah_r_LO 0x0012), so these are ABCD. The EEPROM Ah copies are printed LO first (EAh_r_LO 0xE028), so they are CDAB.",
  "The alarm bitfield is split: bits 0-15 at 0x0017 and bits 16-23 at 0x001D, so it is listed as two 16-bit registers.",
  "Control state codes mean different things in charge/diversion and in load/lighting mode; both meanings are given in the values.",
  "Left out: EEPROM kWh 0xE02C (no scaling or unit printed), lighting-mode and diversion EEPROM settings, calibration values and the 0x8000-0x85DF data logger. Registers 0x0000-0x0007 are internal use.",
  "Both FC 0x03 and FC 0x04 are supported for reading; EEPROM is written with Write Single Register (0x06)."
 ],
 "integration": {
  "summary": "Connect to the RS-232 port at 9600 8N2, ID 1, and read 0x0008-0x001D in one request. Convert voltages with 96.667/32768 (battery) or 139.15/32768 (array/load). Check control mode 0x001A before interpreting control state 0x001B.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 8,
    "why": "Battery voltage"
   },
   {
    "table": "holding_register",
    "address": 10,
    "why": "Array or load voltage"
   },
   {
    "table": "holding_register",
    "address": 11,
    "why": "Charging current"
   },
   {
    "table": "holding_register",
    "address": 26,
    "why": "Control mode"
   },
   {
    "table": "holding_register",
    "address": 27,
    "why": "Control state"
   },
   {
    "table": "holding_register",
    "address": 24,
    "why": "Fault bitfield"
   },
   {
    "table": "coil",
    "address": 1,
    "why": "Remote disconnect"
   }
  ],
  "enable": "Modbus is available on the RS-232 port at the factory settings (address 1); no enable step is described.",
  "watchdog": null,
  "quirks": [
   "Each analog channel has its own scaling constant; check which applies before converting.",
   "EEPROM values that need updating are written once every 24 hours; use coil 0x0016 to force it.",
   "Clearing faults does not clear those that need a power cycle (e.g. DIP switch change)."
  ],
  "setup": [
   "Serial: 9600 baud, 8 data bits, no parity, 2 stop bits, no flow control, RS-232 only."
  ],
  "gotchas": [
   "The spec describes Modbus on the RS-232 port only; an RS-485 network needs a converter."
  ]
 },
 "registers": [
  {
   "table": "coil",
   "address": 0,
   "documented": "0x0000",
   "name": "Equalize triggered",
   "description": "Equalizes while 1; set 0 to stop.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 1,
   "documented": "0x0001",
   "name": "Disconnect",
   "description": "1 forces DISCONNECT (MOSFETs off); 0 resumes.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 16,
   "documented": "0x0010",
   "name": "Clear Ah resettable",
   "description": "Set only; reads 0.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 17,
   "documented": "0x0011",
   "name": "Clear Ah total",
   "description": "Set only; reads 0.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 18,
   "documented": "0x0012",
   "name": "Clear kWh",
   "description": "Set only; reads 0.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 19,
   "documented": "0x0013",
   "name": "Reset battery service reminder",
   "description": "Set only.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 20,
   "documented": "0x0014",
   "name": "Clear faults",
   "description": "Some faults need 10 s before they can be cleared.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 21,
   "documented": "0x0015",
   "name": "Clear alarms",
   "description": "Set only.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 22,
   "documented": "0x0016",
   "name": "Force EEPROM update",
   "description": "Writes RAM values to EEPROM.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 23,
   "documented": "0x0017",
   "name": "LVD override for one cycle",
   "description": "Load/lighting mode: forces the load back on.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 255,
   "documented": "0x00FF",
   "name": "Reset control",
   "description": "Reboots the controller software.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8,
   "documented": "0x0008",
   "name": "adc_vb_f - battery voltage",
   "description": "Filtered (about 2.5 s).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9,
   "documented": "0x0009",
   "name": "adc_vs_f - battery sense voltage",
   "description": "At the battery sense terminals.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10,
   "documented": "0x000A",
   "name": "adc_vx_f - array / load voltage",
   "description": "PV input in charge mode, load terminals in load mode.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.00424652099609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 11,
   "documented": "0x000B",
   "name": "adc_ipv_f - charging current",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002034515380859375,
   "scale_factor_ref": null,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 12,
   "documented": "0x000C",
   "name": "adc_iload_f - load current",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.00966400146484375,
   "scale_factor_ref": null,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 13,
   "documented": "0x000D",
   "name": "Vb_f - battery voltage, slow filter",
   "description": "About 25 s filter.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 14,
   "documented": "0x000E",
   "name": "T_hs - heatsink temperature",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 15,
   "documented": "0x000F",
   "name": "T_batt - battery temperature",
   "description": "From the RTS; 0x80 if not connected.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 16,
   "documented": "0x0010",
   "name": "V_ref - charge regulation reference",
   "description": "Temperature compensated.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 17,
   "documented": "0x0011",
   "name": "Ah resettable",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.1,
   "scale_factor_ref": null,
   "units": "Ah",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 19,
   "documented": "0x0013",
   "name": "Ah total",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.1,
   "scale_factor_ref": null,
   "units": "Ah",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 21,
   "documented": "0x0015",
   "name": "Hourmeter",
   "description": "Hours of operation (24-bit range).",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "h",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 23,
   "documented": "0x0017",
   "name": "Alarm bitfield LO (bits 0-15)",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "RTS open",
    "1": "RTS shorted",
    "2": "RTS disconnected",
    "3": "Ths disconnected",
    "4": "Ths shorted",
    "5": "TriStar hot",
    "6": "Current limit",
    "7": "Current offset",
    "8": "Battery sense",
    "9": "Battery sense disconnected",
    "10": "Uncalibrated",
    "11": "RTS miswire",
    "12": "HVD",
    "13": "High d (duty)",
    "14": "Miswire",
    "15": "FET open"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 24,
   "documented": "0x0018",
   "name": "Fault bitfield",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "External short",
    "1": "Overcurrent",
    "2": "FET short",
    "3": "Software",
    "4": "HVD",
    "5": "TriStar hot",
    "6": "DIP switch changed",
    "7": "Setting edit",
    "8": "Reset?",
    "9": "Miswire",
    "10": "RTS shorted",
    "11": "RTS disconnected"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 25,
   "documented": "0x0019",
   "name": "DIP switch settings",
   "description": "Switch 1-8 at power-on in bits 0-7.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 26,
   "documented": "0x001A",
   "name": "Control mode",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": {
    "0": "Charge",
    "1": "Load",
    "2": "Diversion",
    "3": "Lighting"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 27,
   "documented": "0x001B",
   "name": "Control state",
   "description": "Meaning depends on control mode: charge/diversion name first, load/lighting second.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": {
    "0": "START",
    "1": "NIGHT CHECK / NORMAL (load)",
    "2": "DISCONNECT / LVD WARN (load)",
    "3": "NIGHT / LVD (load)",
    "4": "FAULT",
    "5": "BULK / DISCONNECT (load)",
    "6": "PWM / NORMAL OFF (lighting)",
    "7": "FLOAT / OVERRIDE LVD (lighting)",
    "8": "EQUALIZE"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 28,
   "documented": "0x001C",
   "name": "d_filt - PWM duty cycle",
   "description": "0-255; 230 and above = 100 %.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 29,
   "documented": "0x001D",
   "name": "Alarm bitfield HI (bits 16-23)",
   "description": "Not available on software 1.04.02 or older.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "P12 (alarm bit 16)",
    "1": "Load disconnect (alarm bit 17)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57344,
   "documented": "0xE000",
   "name": "EV_reg - regulation voltage @25°C",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57345,
   "documented": "0xE001",
   "name": "EV_float - float voltage @25°C",
   "description": "0 disables float.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57346,
   "documented": "0xE002",
   "name": "Et_float - time before float",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57350,
   "documented": "0xE006",
   "name": "EV_eq - equalize voltage @25°C",
   "description": "0 disables equalize.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57351,
   "documented": "0xE007",
   "name": "Et_eqcalendar - days between equalize",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "days",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57355,
   "documented": "0xE00B",
   "name": "EV_hvd - high voltage disconnect",
   "description": "0 disables HVD.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57356,
   "documented": "0xE00C",
   "name": "EV_hvr - high voltage reconnect",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57359,
   "documented": "0xE00F",
   "name": "EV_lvd - low voltage disconnect (load mode)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57360,
   "documented": "0xE010",
   "name": "EV_lvr - low voltage reconnect (load mode)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57364,
   "documented": "0xE014",
   "name": "Et_lvd_warn - LVD warning timeout",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "scale_factor_ref": null,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57384,
   "documented": "0xE028",
   "name": "EAh_r - resettable Ah (EEPROM)",
   "description": "LO word at 0xE028, HI at 0xE029.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "scale_factor_ref": null,
   "units": "Ah",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57386,
   "documented": "0xE02A",
   "name": "EAh_t - total Ah (EEPROM)",
   "description": "LO word at 0xE02A, HI at 0xE02B.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "scale_factor_ref": null,
   "units": "Ah",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57389,
   "documented": "0xE02D",
   "name": "EVb_min - minimum battery voltage",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57390,
   "documented": "0xE02E",
   "name": "EVb_max - maximum battery voltage",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.002950042724609375,
   "scale_factor_ref": null,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 57408,
   "documented": "0xE040",
   "name": "Emb_meterbus_id - MeterBus ID",
   "description": "1-15.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "page": "https://easymodbus.com/modbus-register-maps/morningstar/tristar-ts-45-ts-60",
 "address_note": "address = 0-based Modbus wire (PDU) address; documented = as printed in the source.",
 "note": "Re-typed from the manufacturer's public documentation (see source) and verified against it. Registers vary by firmware and options; verify against the live device before writing."
}
