TriStar MPPT MODBUS® Specification V10.2 5 December 2011 Morningstar Corporation 8 Pheasant Run Newtown, PA 18940 www.morningstarcorp.com info@morningstarcorp.
General Information The TriStar MPPT supports the industry standard MODBUS® application protocol via its serial RS-232 and EIA-485 interfaces and MODBUS TCP via the Ethernet port (TS-MPPT-60 models only). This document assumes the user is familiar with both MODBUS® protocols. Please refer to the documents listed in the References section for more information. MODBUS® is a registered trademark of Modbus-IDA (www.modbus-ida.org) Parameters The TriStar MPPT supports RTU mode only.
TriStar MPPT MODBUS Document v10 Supported MODBUS Functions Read Holding Registers (0x03) and Read Input Registers (0x04) RAM PDU Addr Logical Addr Variable name Variable description 0x0000 0x0001 0x0002 0x0003 0x0004 0x0005 – 0x0017 1 2 3 4 5 6-9 V_PU hi V_PU lo I_PU hi I_PU lo ver_sw Scaling Values Voltage scaling, whole term Voltage scaling, fractional term Current scaling, whole term Current scaling, fractional term Software Version 0x0018 0x0019 25 26 adc_vb_f_med adc_vbterm_f 0x001A 27
TriStar MPPT MODBUS Document 0x0034 0x0035 0x0036 0x0037 0x0038 0x0039 53 54 55 56 57 58 Ahc_r HI Ahc_r LO Ahc_t HI Ahc_t LO kwhc_r kwhc_t 0x003A 0x003B 0x003C 0x003D 0x003E 0x003F 59 60 61 62 63 64 power_out_shadow power_in_shadow sweep_Pin_max sweep_vmp sweep_voc 0x0040 0x0041 0x0042 0x0043 0x0044 0x0045 0x0046 0x0047 0x0048 0x0049 0x004A 0x004B 0x004C 0x004D 65 66 67 68 69 70 71 72 73 74 75 76 77 78 vb_min_daily vb_max_daily va_max_daily Ahc_daily whc_daily flags_daily Pout_max_daily Tb_min_dail
TriStar MPPT MODBUS Document v10 0x1024 0x1025 NetFlags string 0x4000=DHCP Enabled, 0x0=DHCP disabled MAC Address Bytes 0x1026 MACAddress[1],[0] 0x1027 0x1028 0x1029– 0x1030 MACAddress[3],[2] MACAddress[5],[4] NetBIOS Name MAC Address Bytes MAC Address Bytes String of 16 bytes, 00 terminates string Logical Addr Variable name Variable description 0x151B 0x151C 0x151D 0x151E 0x151F 0x1520 5404 5405 5406 5407 5408 5409 0x1521 5410 HTTPPort MBIPPort NetRules SNMPTrapRecPort Ethernet Power Save
TriStar MPPT MODBUS Document v10 0xE011 0xE012 0xE013 0xE014 0xE015 57362 57363 57364 57365 57366 ETb_max ETb_min 0xE016 57367 EV_soc_gy_y 0xE017 0xE018 0xE019 0xE01A 57368 57369 57370 57371 EV_soc_y_yr EV_soc_yr_r Emodbus_id Emeterbus_id 0xE01D 57374 EIb_lim 0xE020 0xE021 57377 57378 EVa_ref_fixed_init EVa_ref_fixed_pct_init 0xE080 0xE081 0xE082 0xE083 0xE084 0xE085 0xE086 0xE087 0xE088 0xE089 0xE08A 0xE08B 0xE08C … 0xE0C0– 0xE0C3 0xE0CC 0xE0CD 57473 57474 57475 57476 57477 57478 57479 57
TriStar MPPT MODBUS Document v10 Read Coils (0x01), Read Discrete Inputs (0x02), Write Single Coil (0x05) PDU Addr 0x0000 0x0001 0x0002 … 0x0010 0x0011 0x0012 0x0013 0x0014 0x0015 0x0016 0x0017 0x0018 0x0019 … 0x00F0 … 0x00FF 0x1000 0x1001 0x1002 0x1003 0x10FF Logical Addr 1 2 3 4-16 17 18 19 20 21 22 23 24 25 26 27-240 241 242-255 256 4096 4097 4098 4099 4351 Variable description Equalize triggered reserved Charge disconnect (1 will force charger into a disconnect state) reserved Clear Ah 7esettable (s
TriStar MPPT MODBUS Document v10 Variables and Definitions Variable_name [Logical Address][PDU Address] (Units). Short description. Definition. Read Holding and Read Input Registers Located in processor RAM, updated continuously. V_PU hi, V_PU lo [1,2][0x0000, 0x0001] (V). voltage scaling. The scaling value for all voltages. The scaling value is defined as: Vscaling = whole.fraction = [V_PU hi].
TriStar MPPT MODBUS Document v10 Filtered ADC Vb [25][0x0018] (V). battery voltage, filtered. Battery voltage used for regulation by the TS-MPPT. This voltage will be the same as the Battery Sense voltage if the sense connections are connected and valid. Otherwise, this value is the same as Vb_term voltage. Vb_term [26][0x0019] (V). battery terminal voltage, filtered. Voltage measured directly at the battery power connections on the TriStar MPPT. Vb_sense [27][0x001A] (V).
TriStar MPPT MODBUS Document v10 Vmeter [33][0x0020] (V). MeterBus supply voltage. MeterBus power supply voltage. Vp1.8 [34][0x0021] (V). 1.8 volt supply. 1.8 Volt power supply voltage. V_ref [35][0x0022] (V). reference voltage. External voltage reference Temperatures T_hs [36][0x0023] (C). Heatsink Temperature. Sunsaver MPPT Heatsink temperature. Reported in degrees C. T_rts [37][0x0024] (C). RTS Temperature. Temperature as measured by the optional Remote Temperature Sensor(RTS).
TriStar MPPT MODBUS Document v10 Heavily filtered charging current value. Vb_min [41][0x0028] (V). minimum battery voltage. Long term minimum battery voltage. Resets when Ah(resettable) is reset. Vb_max [42][0x0029] (V). maximum battery voltage . Long term maximum battery voltage. Resets when Ah(resettable) is reset. hourmeter_HI / hourmeter_LO [43, 44][0x002A, 0x002B] (hrs).hour meter counter. Reports total hours of operation. Faults [45][0x002C] (bit-field). TS-MPPT self-diagnostic faults.
TriStar MPPT MODBUS Document v10 alarm_HI / alarm_LO [47, 48][0x002E, 0x002F] (bitfield).Controller self-diagnostics alarms. Reports alarms identified by self diagnostics. Each bit corresponds to a specific alarm.
TriStar MPPT MODBUS Document Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 v10 LED State LED_START LED_START2 LED_BRANCH FAST GREEN BLINK SLOW GREEN BLINK GREEN BLINK, 1HZ GREEN_LED UNDEFINED YELLOW_LED UNDEFINED BLINK_RED_LED RED_LED R-Y-G ERROR R/Y-G ERROR R/G-Y ERROR R-Y ERROR (HTD) R-G ERROR (HVD) R/Y-G/Y ERROR G/Y/R ERROR G/Y/R x 2 Charger Charge_state [51][0x0032] ( ). Charge state. Reports the charge state.
TriStar MPPT MODBUS Document v10 V_target [52][0x0033] (V). Target Voltage. Voltage to which the battery will be charged at any given time. This value changes with each charge stage and is temperature compensated. Ahc_r_HI / Ahc_r_LO [53,54][0x0034, 0x0035] (ah).Charge amp-hours (reset-able counter). Reports total solar amp-hours since last ah reset. Ahc_t_HI / Ahc_t_LO [55,56][0x0036, 0x0037] (ah).Charge amp-hours (Total cumulative counter). Reports total solar amp-hours since last ah reset.
TriStar MPPT MODBUS Document v10 Sweep_Vmp [62][0x003D] (V). Solar array Vmp. Maximum power voltage of the solar array found during last sweep. Sweep_Voc [63][0x003E] (V). Solar array Voc. Open circuit voltage of the solar array found during last sweep. Logger Vb_min_daily [65][0x0040] (V). Today’s minimum battery voltage. Minimum battery voltage measured today. This value is stored in the daily record at the end of each charging day. A new daily record is created X hours after NIGHT state.
TriStar MPPT MODBUS Document v10 Reports daily flags, as defined below, that occurred today. Bit 0 (LSB) 1 2 3 4 Flag Reset detected Equalize triggered Entered float an alarm occurred a fault occurred Pout_max_daily [71][0x0046] (bit-field). Maximum power out today. Reports maximum power delivered to the battery today. Tb_min_daily [72][0x0047] (bit-field). Today’s minimum battery temperature. Reports the lowest battery temperature that occurred today. Tb_max_daily [73][0x0048] (bit-field).
TriStar MPPT MODBUS Document v10 time_eq_daily [79][0x004E] (s). Cumulative time in Equalization today. Reports the cumulative number of seconds the battery has been in the Equalization charge stage today. Counter resets at night. time_fl_daily [80][0x004F] (s). Cumulative time in Float today. Reports the cumulative number of seconds the battery has been in the Float charge stage today. Counter resets at night. Vb_ref_slave [90][0x0059] (V).
TriStar MPPT MODBUS Document v10 EEPROM TCP Network Settings HTTPPort [5404][0x151B](). HTTP port number Port number assigned to the web server. Port 80 default. MBIPPort [5405][0x151C](). MODBUS IP port number Port number used for MODBUS IP requests to the controller. Port 502 default. NetRules [5406][0x151D](). Enable / Disable IP bridging to EIA-485 Set the register bit 0 = 1 to enable bridging of MODBUS requests via Ethernet to the EIA-485 port.
TriStar MPPT MODBUS Document v10 Charge Settings EV_absorp [57345][0xE000](V). Absorption voltage @ 25ºC. The battery will charge at 100% charge current until battery voltage reaches this setpoint. The controller will begin to taper input current so that this setpoint is maintained, but not exceeded. EV_float [57346][0xE001](V). Float voltage @ 25ºC After Et_float seconds in absorption, when the battery is fully charged, the battery will transition to this lower voltage charge setting to reduce gassing.
TriStar MPPT MODBUS Document v10 Battery equalize voltage. Periodic equalization equalizes cell voltages, bubbles the electrolyte, and helps prevent sulfation of the battery. Set to zero to disable equalization Et_eqcalendar [57353][0xE008](days). days between eq cycles Specify the number of days between equalizations. Equalizing on a calendar basis ensures proper maintenance of batteries. Et_eq_above [57354][0xE009](seconds) equalize time limit above Vreg.
TriStar MPPT MODBUS Document v10 Evb_ref_lim [57361][0xE010](V) Maximum regulation limit An absolute limit on the battery regulation voltage. This is not a temperature compensated value. Protects high voltage sensitive system loads. Set to zero to disable. ETb_max [57362][0xE011](C) Maximum temperature compensation limit Maximum temperature to clamp temperature compensation. ETb_min [57363][0xE012](C) Minimum temperature compensation limit Maximum temperature to clamp temperature compensation.
TriStar MPPT MODBUS Document v10 Emeter _id [57371][0xE01A](). MeterBus ID Address which uniquely identifies the controller on the Morningstar proprietary Meter Bus network. Devices are daisy-chained on the Meter Bus network via the RJ-11 connections. Addresses are limited to the range of 1-15 EIb_lim [57374][0xE01D](A). Battery Current Limit Set to a non-zero value to limit the maximum battery current. Set to zero to use the default 60 Amp current limit. EVa_ref_fixed_init [57377][0xE020](V).
TriStar MPPT MODBUS Document v10 Read-Only Variables Ehourmeter_LO / Ehourmeter_HI [57473,57474][0xE080,0xE081](hours). Hourmeter Cumulative hours the controller has been running. Non-volatile, written every 24hrs. EAhc_r_LO / EAhc_r_HI [57475,57476][0xE082,0xE083](amp-hours). Charge resetable Ah Cumulative amp-hours typically used for short-term logging. Resetable. EAhc_t_LO / EAhc_t_HI [57477,57478][0xE084,0xE085](amp-hours). Charge total Ah Cumulative amp-hours for long term logging.
TriStar MPPT MODBUS Document v10 Etmr_eqcalendar [57484][0xE08B](V). Equalize calendar timer Number of days since last equalize. Etmr_batt_service [57485][0xE08C](days). days since last battery service Reports the number of days since the last battery service reminder. Eserial [57537-57540][0xE0C0 – 0xE0C3](ASCII). Controller serial number ASCII string of characters that represents the serial number.
TriStar MPPT MODBUS Document v10 Examples Read Holding Register, Scaling a voltage value Read and scale the following value: Variable (RAM): Battery Voltage Register Address: 0x0018 The voltage scaling term is stored in variable V_PU at addresses 0x0000 and 0x0001. Suppose the following values are read from RAM: Address 0x0000 0x0001 0x0018 Value(hex) 0x007B 0xE041 0x0DB0 Variable Name V_PU HI byte V_PU LO byte Battery Voltage value 1.
TriStar MPPT MODBUS Document v10 References Visit http://www.modbus-ida.org/ for full protocol documentation, news, and technical resources MODBUS® Protocol Reference Guide, Modicon, June 1996, PI-MODBUS-300 Rev.J MODBUS® Application Protocol Specification, modbus.
