{
  "spec_version": 1,
  "slug": "eko-ms-80s",
  "manufacturer": "EKO Instruments",
  "model": "MS-80S pyranometer (Modbus RTU variant of the MS-80 series)",
  "category": "Sensor",
  "supplier_url": "https://eko-instruments.com/downloads/ms-80-pyranometer/",
  "default_configuration": {
    "protocol": "modbus_rtu",
    "unit_id": 1,
    "addressing": "zero_based",
    "byte_order": "BigEndian",
    "word_order": "HighFirst",
    "native_interface": "rs485",
    "serial": {
      "baud_rate": 19200,
      "parity": "Even",
      "data_bits": 8,
      "stop_bits": 1
    }
  },
  "coils": [],
  "discrete_inputs": [],
  "input_registers": [
    {
      "address": 0,
      "count": 1,
      "name": "Model number",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "U16 model number; the MS-80S reports 0x0110."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Fixed value 0",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "The document prints a fixed value of 0 in this register."
    },
    {
      "address": 2,
      "count": 2,
      "name": "Solar irradiance, temperature- and linearity-compensated",
      "data_type": "Float32",
      "units": "W/m²",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Comp.Irr: irradiance after temperature and linearity compensation (F32, two registers, high word first). Updated about every 110 ms."
    },
    {
      "address": 8,
      "count": 2,
      "name": "Sensor temperature (Pt100)",
      "data_type": "Float32",
      "units": "°C",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Pt100 sensor temperature of the pyranometer body (F32)."
    },
    {
      "address": 14,
      "count": 2,
      "name": "X-axis tilt angle",
      "data_type": "Float32",
      "units": "°",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "X-axis component of the tilt angle (F32). Updated about every 110 ms."
    },
    {
      "address": 16,
      "count": 2,
      "name": "Y-axis tilt angle",
      "data_type": "Float32",
      "units": "°",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Y-axis component of the tilt angle (F32)."
    },
    {
      "address": 18,
      "count": 2,
      "name": "Solar irradiance before correction",
      "data_type": "Float32",
      "units": "W/m²",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Raw.Irr: irradiance before the temperature/linearity correction (F32)."
    },
    {
      "address": 20,
      "count": 2,
      "name": "Sensor output voltage",
      "data_type": "Float32",
      "units": "mV",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "ADmV: the raw sensor output voltage in mV (F32)."
    },
    {
      "address": 22,
      "count": 2,
      "name": "Internal temperature",
      "data_type": "Float32",
      "units": "°C",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Temperature measured by the internal temperature sensor (F32)."
    },
    {
      "address": 24,
      "count": 2,
      "name": "Internal humidity",
      "data_type": "Float32",
      "units": "%RH",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Relative humidity measured by the internal humidity sensor (F32)."
    },
    {
      "address": 26,
      "count": 2,
      "name": "Alerts for internal humidity of the pyranometer",
      "data_type": "UInt32",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "U32 alert word: normal = 0, an abnormality in the internal humidity is reported as 1."
    },
    {
      "address": 96,
      "count": 1,
      "name": "Company name (characters 0,1)",
      "data_type": "Ascii",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "One 16-bit register holding the first two characters of the four-character company name, 'EK'."
    },
    {
      "address": 97,
      "count": 1,
      "name": "Company name (characters 2,3)",
      "data_type": "Ascii",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "One 16-bit register holding characters 3 and 4 of the company name, 'O' followed by the 0x20 padding character."
    },
    {
      "address": 98,
      "count": 1,
      "name": "Firmware version",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "U16 firmware version number."
    },
    {
      "address": 99,
      "count": 1,
      "name": "Hardware version",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "U16 hardware version number."
    }
  ],
  "holding_registers": [
    {
      "address": 101,
      "count": 1,
      "name": "Modbus address",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "U16 Modbus slave address (1...247). Factory value: see the notes - the guide derives it from the serial number, its example setting report prints 1."
    },
    {
      "address": 102,
      "count": 1,
      "name": "Serial communication setting",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "U16 enum that sets bit rate and parity together (Table A4-3): 0 = 2400 None, 1 = 2400 Even, 2 = 2400 Odd, 3 = 4800 None, 4 = 4800 Even, 5 = 4800 Odd, 6 = 9600 None, 7 = 9600 Even, 8 = 9600 Odd, 9 = 19200 None, 10 = 19200 Even (default), 11 = 19200 Odd, 12 = 38400 None, 13 = 38400 Even, 14 = 38400 Odd, 15 = 115200 None, 16 = 115200 Even, 17 = 115200 Odd."
    },
    {
      "address": 103,
      "count": 1,
      "name": "Register type",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "U16 register-type setting that selects which of the four No. 0-49 register maps the device serves. This seed transcribes the S-series type (the MS-80S default, Table A4-9)."
    },
    {
      "address": 106,
      "count": 1,
      "name": "Analog current output setting",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "U16 analog output setting (Tables A4-17/A4-18); the 4...20 mA mode is enabled by default with 0 W/m² at 4 mA and 1600 W/m² at 20 mA."
    }
  ],
  "combined_registers": [],
  "notes": "Source: EKO INSTRUMENTS 'INSTRUCTION MANUAL - Pyranometer MS-80/80S/80U', Ver. 8 (file dated 2023-10-13), chapter 4 'About RS485 Modbus RTU connection [MS-80S]', Table 5-10, Appendix A-4 'Communication Specifications (Modbus RTU)' (Tables A4-1 to A4-3), A-6 to A-10 (register maps and details) and A-9 'MS-80S Setting Report'; vendor-hosted PDF at https://eko-instruments.com/wp-content/uploads/2024/08/ms-80_80s_80u_manual20231013v8.pdf (SHA-256 159e0df960d3165ab463a224812569b267679470cbc43b0cef5b4844e20f1035). Factory serial settings: Modbus RTU is the default interface and the default communication setting is 19200 bps with even parity (Table A4-3 setting 10, marked default; Table 5-10 prints 'Baud rate 19200, Parity Even'); the stop bit follows parity (one with parity, two without) and the word is always 8 data bits, so the frame is 19200 8E1. Unit ID: Table 5-10 gives the factory address as the last two digits of the serial number (100 when they are '00'), while the example report in A-9 prints address 1; the seed stores 1 as a verify-on-site placeholder: set the unit ID from address register 101. Addressing: A-6 states that the register map starts from address 0 and A4-3 confirms addresses start from 0, so the seed is zero_based. Word order: Table A4-8 shows a 32-bit value as 0x1234 (MSW) at address n and 0x5678 (LSW) at n+1, so BigEndian + HighFirst. The device does not distinguish holding from input register addresses (A4-2): measurements are listed as input registers and settings as holding registers, but either function code reaches both. Not seeded: the coils (only 'Reboot' at coil 1 and 'Save' at coil 3 are documented, both write-only, which this schema's coil area cannot express), the analog-output scaling rows from register 131 on (Table A4-15's decimal column drifts against its description column there), the calibration history block (200-219) and the M/SMP/SRD register types that register 103 can select."
}
