SunSpec SunSpec Model 307 — Base Met Modbus TCP template

SunSpec Model 307 — Base Met

SunSpec Model 307 — Base Met is the SunSpec Alliance standard information model for meteorological stations deployed at solar and distributed energy sites. Via Modbus TCP, this template reads the complete Base Met fixed block: ambient temperature, relative humidity, barometric pressure, wind speed and direction, rainfall and snowfall, precipitation type, atmospheric electric field, surface wetness, and soil moisture. Importing this template into your ModbusCloud portal gives any SunSpec-compliant weather station a structured, labelled data stream that feeds dashboards, alerts, and long-term site correlation analysis without manual register mapping.

Protocol
Modbus TCP
Connection
Ethernet, Modbus TCP
Registers
13, read only
Brand
SunSpec
Last updated

Registers (13)

13 read, 0 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
idRead
lRead
tmpamb°CRead
rhPctRead
presHPaRead
wndspdmpsRead
wnddirdegRead
rainmmRead
snwmmRead
pptRead
elecfldVmRead
surwetkORead
soilwetPctRead

Loading registers…

Send your device list

If a device is not in the library yet, we build the template for free as soon as we have the register data.

Use cases

  • Monitor ambient temperature and relative humidity continuously to correlate site climate conditions with inverter thermal derating events.
  • Track wind speed and direction over time to verify safe operating conditions for rooftop PV arrays and external mounting structures.
  • Alert on surface wetness resistance dropping below threshold to detect condensation or rainfall risk affecting outdoor electrical equipment.
  • Compare barometric pressure trends against energy yield data to identify weather-driven generation patterns across multiple sites.
  • Report soil moisture and precipitation type alongside plant performance metrics for agricultural or ground-mount solar site management.

Installation

  1. Enable Modbus TCP on the weather station or connected data logger under the communication or Modbus section of its configuration interface, noting the assigned IP address and TCP port (default 502).

  2. Connect the weather station or logger to the same LAN segment as the ModbusCloud Gateway, ensuring no firewall blocks TCP port 502 between the two devices.

  3. In the ModbusCloud portal, add a new device, import the SunSpec Model 307 — Base Met template with one click, and assign the correct unit ID matching the station's Modbus slave address.

  4. Verify the connection by checking live values for tmpamb and wndspd in the portal register view; confirm readings match the station's local display or manufacturer diagnostic tool.

Things to watch for

All registers return the SunSpec NaN value. What is wrong?

Many weather stations and loggers only populate registers that their hardware sensor suite actually supports. A NaN in rh, pres, elecfld, surwet, or soilwet is normal if the physical sensor for that point is not installed. Confirm which sensors are fitted by consulting the station datasheet and cross-check against the PICS document for your specific device.

The gateway connects but the model ID register reads an unexpected value.

SunSpec devices expose multiple models in a chain starting at a base address, typically 40001. If you poll the Model 307 block at the wrong offset, the id register will not return 307. Use SunSpec auto-discovery or manually confirm the absolute Modbus address of the Model 307 block by reading the chain from the base address forward past the Common Model block.

Wind direction reads zero continuously even when wind is present.

A persistent zero on wnddir can indicate that the sensor is not connected, the vane is physically stuck, or the station firmware maps north as zero and genuinely reports zero during calm conditions. Check the physical wind vane for obstruction, verify sensor wiring at the station terminal block, and test with a known wind direction by rotating the vane manually.

The ppt register returns an integer I cannot interpret. What do the values mean?

The ppt field is an enumerated type with no physical unit. The SunSpec Model 307 specification defines discrete integer codes for precipitation type, such as none, rain, snow, or mixed. The exact code table depends on the implementing device's firmware. Consult the device manufacturer's PICS or application note to map the integer to the correct precipitation category.

Want to see how it works?

Electrician working in an open distribution board