Smappee Connect Modbus registers

[myny-git]

I am playing around with the Modbus interface. Everything that works, will be in the docs. There are some items that I could not figure out yet.

I list here some input from the excel.

Encoding

• int16: 16bit integer, single register, big endian (Most Significant Byte first)
• int32: 32bit integer encoded in two consecutive registers, first register contains low word (low 16 bits), second register high word (high 16 bits)
• float: Single precision IEEE floating point encoded in two consecutive registers, first register contains low word , second register high word

Voltages

In the table, you can see always 1 second average, or fundamental voltage. I decided to only use the first item, not the fundamental voltage. Same for currents. Below you can find a yaml example for the first item in the table.

- name: smappee_modbus_voltage_L1_N
  slave: 61
  address: 0
  input_type: holding
  device_class: voltage
  data_type: float32
  state_class: measurement
  unit_of_measurement: V
  swap: word
  scan_interval: 5
  precision: 1

Modbus Address	Modbus Address (Hex)	Size	Type	Phase	Unit	R/W	Description
0	0x0000	2	Float	L1-N	Volt	R	Root Mean Square Voltage, 1 second average
2	0x0002	2	Float	L1-N	Volt	R	Root Mean Square Fundamental Voltage, 1 second average
4	0x0004	2	Float	L2-N	Volt	R	Root Mean Square Voltage, 1 second average
6	0x0006	2	Float	L2-N	Volt	R	Root Mean Square Fundamental Voltage, 1 second average
8	0x0008	2	Float	L3-N	Volt	R	Root Mean Square Voltage, 1 second average
10	0x000A	2	Float	L3-N	Volt	R	Root Mean Square Fundamental Voltage, 1 second average
12	0x000C	2	Float	L1-L2	Volt	R	Root Mean Square Voltage, 1 second average
14	0x000E	2	Float	L1-L2	Volt	R	Root Mean Square Fundamental Voltage, 1 second average
16	0x0010	2	Float	L2-L3	Volt	R	Root Mean Square Voltage, 1 second average
18	0x0012	2	Float	L2-L3	Volt	R	Root Mean Square Fundamental Voltage, 1 second average
20	0x0014	2	Float	L3-L1	Volt	R	Root Mean Square Voltage, 1 second average
22	0x0016	2	Float	L3-L1	Volt	R	Root Mean Square Fundamental Voltage, 1 second average
24	0x0018	2	Float	L1-N	Volt	R	Root Mean Square Third harmonic voltage, 1 second average
26	0x001A	2	Float	L2-N	Volt	R	Root Mean Square Third harmonic voltage, 1 second average
28	0x001C	2	Float	L3-N	Volt	R	Root Mean Square Third harmonic voltage, 1 second average
30	0x001E	2	Float	L1-L2	Volt	R	Root Mean Square Third harmonic voltage, 1 second average
32	0x0020	2	Float	L2-L3	Volt	R	Root Mean Square Third harmonic voltage, 1 second average
34	0x0022	2	Float	L3-L1	Volt	R	Root Mean Square Third harmonic voltage, 1 second average
36	0x0024	2	Float	L1-N	Volt	R	Root Mean Square Fifth harmonic voltage, 1 second average
38	0x0026	2	Float	L2-N	Volt	R	Root Mean Square Fifth harmonic voltage, 1 second average
40	0x0028	2	Float	L3-N	Volt	R	Root Mean Square Fifth harmonic voltage, 1 second average
42	0x002A	2	Float	L1-L2	Volt	R	Root Mean Square Fifth harmonic voltage, 1 second average
44	0x002C	2	Float	L2-L3	Volt	R	Root Mean Square Fifth harmonic voltage, 1 second average
46	0x002E	2	Float	L3-L1	Volt	R	Root Mean Square Fifth harmonic voltage, 1 second average

Energy

This is the configuration of the Energy. I have integrated this, but the numbers do not make any sense.

- name: smappee_modbus_energy_active_import_ch0
  slave: 61
  address: 12288
  input_type: holding
  device_class: energy
  data_type: int32
  state_class: total_increasing
  unit_of_measurement: Wh
  swap: word
  scan_interval: 60
  precision: 0

Modbus Address	Modbus Address (Hex)	Size	Type	Channel	Unit	R/W	Description
12288	0x0BB8	2	Int32	0	Watthour	RW	Active Import
12290	0x0BB9	2	Int32	0	Watthour	RW	Active Export
12292	0x0BBA	2	Int32	1	Watthour	RW	Active Import
12294	0x0BBB	2	Int32	1	Watthour	RW	Active Export
12296	0x0BBC	2	Int32	2	Watthour	RW	Active Import
12298	0x0BBD	2	Int32	2	Watthour	RW	Active Export
12300	0x0BBE	2	Int32	3	Watthour	RW	Active Import
12302	0x0BBF	2	Int32	3	Watthour	RW	Active Export
12304	0x0BC0	2	Int32	4	Watthour	RW	Active Import
12306	0x0BC1	2	Int32	4	Watthour	RW	Active Export
12308	0x0BC2	2	Int32	5	Watthour	RW	Active Import
12310	0x0BC3	2	Int32	5	Watthour	RW	Active Export
12312	0x0BC4	2	Int32	6	Watthour	RW	Active Import
12314	0x0BC5	2	Int32	6	Watthour	RW	Active Export
12316	0x0BC6	2	Int32	7	Watthour	RW	Active Import
12318	0x0BC7	2	Int32	7	Watthour	RW	Active Export
12320	0x0BC8	2	Int32	8	Watthour	RW	Active Import
12322	0x0BC9	2	Int32	8	Watthour	RW	Active Export
12324	0x0BCA	2	Int32	9	Watthour	RW	Active Import
12326	0x0BCB	2	Int32	9	Watthour	RW	Active Export
12328	0x0BCC	2	Int32	10	Watthour	RW	Active Import
12330	0x0BCD	2	Int32	10	Watthour	RW	Active Export
12332	0x0BCE	2	Int32	11	Watthour	RW	Active Import
12334	0x0BCF	2	Int32	11	Watthour	RW	Active Export
12336	0x0BD0	2	Int32	12	Watthour	RW	Active Import
12338	0x0BD1	2	Int32	12	Watthour	RW	Active Export
12340	0x0BD2	2	Int32	13	Watthour	RW	Active Import
12342	0x0BD3	2	Int32	13	Watthour	RW	Active Export
12344	0x0BD4	2	Int32	14	Watthour	RW	Active Import
12346	0x0BD5	2	Int32	14	Watthour	RW	Active Export
12348	0x0BD6	2	Int32	15	Watthour	RW	Active Import
12350	0x0BD7	2	Int32	15	Watthour	RW	Active Export
12352	0x0BD8	2	Int32	16	Watthour	RW	Active Import
12354	0x0BD9	2	Int32	16	Watthour	RW	Active Export
12356	0x0BDA	2	Int32	17	Watthour	RW	Active Import
12358	0x0BDB	2	Int32	17	Watthour	RW	Active Export
12360	0x0BDC	2	Int32	18	Watthour	RW	Active Import
12362	0x0BDD	2	Int32	18	Watthour	RW	Active Export
12364	0x0BDE	2	Int32	19	Watthour	RW	Active Import
12366	0x0BDF	2	Int32	19	Watthour	RW	Active Export
12368	0x0BE0	2	Int32	20	Watthour	RW	Active Import
12370	0x0BE1	2	Int32	20	Watthour	RW	Active Export
12372	0x0BE2	2	Int32	21	Watthour	RW	Active Import
12374	0x0BE3	2	Int32	21	Watthour	RW	Active Export
12376	0x0BE4	2	Int32	22	Watthour	RW	Active Import
12378	0x0BE5	2	Int32	22	Watthour	RW	Active Export
12380	0x0BE6	2	Int32	23	Watthour	RW	Active Import
12382	0x0BE7	2	Int32	23	Watthour	RW	Active Export
12384	0x0BE8	2	Int32	24	Watthour	RW	Active Import
12386	0x0BE9	2	Int32	24	Watthour	RW	Active Export
12388	0x0BEA	2	Int32	25	Watthour	RW	Active Import
12390	0x0BEB	2	Int32	25	Watthour	RW	Active Export
12392	0x0BEC	2	Int32	26	Watthour	RW	Active Import
12394	0x0BED	2	Int32	26	Watthour	RW	Active Export
12396	0x0BEE	2	Int32	27	Watthour	RW	Active Import
12398	0x0BEF	2	Int32	27	Watthour	RW	Active Export
12416	0x0C08	2	Int32	0	varh	RW	Reactive Import
12418	0x0C09	2	Int32	0	varh	RW	Reactive Export
12420	0x0C0A	2	Int32	1	varh	RW	Reactive Import
12422	0x0C0B	2	Int32	1	varh	RW	Reactive Export
12424	0x0C0C	2	Int32	2	varh	RW	Reactive Import
12426	0x0C0D	2	Int32	2	varh	RW	Reactive Export
12428	0x0C0E	2	Int32	3	varh	RW	Reactive Import
12430	0x0C0F	2	Int32	3	varh	RW	Reactive Export
12432	0x0C10	2	Int32	4	varh	RW	Reactive Import
12434	0x0C11	2	Int32	4	varh	RW	Reactive Export
12436	0x0C12	2	Int32	5	varh	RW	Reactive Import
12438	0x0C13	2	Int32	5	varh	RW	Reactive Export
12440	0x0C14	2	Int32	6	varh	RW	Reactive Import
12442	0x0C15	2	Int32	6	varh	RW	Reactive Export
12444	0x0C16	2	Int32	7	varh	RW	Reactive Import
12446	0x0C17	2	Int32	7	varh	RW	Reactive Export
12448	0x0C18	2	Int32	8	varh	RW	Reactive Import
12450	0x0C19	2	Int32	8	varh	RW	Reactive Export
12452	0x0C1A	2	Int32	9	varh	RW	Reactive Import
12454	0x0C1B	2	Int32	9	varh	RW	Reactive Export
12456	0x0C1C	2	Int32	10	varh	RW	Reactive Import
12458	0x0C1D	2	Int32	10	varh	RW	Reactive Export
12460	0x0C1E	2	Int32	11	varh	RW	Reactive Import
12462	0x0C1F	2	Int32	11	varh	RW	Reactive Export
12464	0x0C20	2	Int32	12	varh	RW	Reactive Import
12466	0x0C21	2	Int32	12	varh	RW	Reactive Export
12468	0x0C22	2	Int32	13	varh	RW	Reactive Import
12470	0x0C23	2	Int32	13	varh	RW	Reactive Export
12472	0x0C24	2	Int32	14	varh	RW	Reactive Import
12474	0x0C25	2	Int32	14	varh	RW	Reactive Export
12476	0x0C26	2	Int32	15	varh	RW	Reactive Import
12478	0x0C27	2	Int32	15	varh	RW	Reactive Export
12480	0x0C28	2	Int32	16	varh	RW	Reactive Import
12482	0x0C29	2	Int32	16	varh	RW	Reactive Export
12484	0x0C2A	2	Int32	17	varh	RW	Reactive Import
12486	0x0C2B	2	Int32	17	varh	RW	Reactive Export
12488	0x0C2C	2	Int32	18	varh	RW	Reactive Import
12490	0x0C2D	2	Int32	18	varh	RW	Reactive Export
12492	0x0C2E	2	Int32	19	varh	RW	Reactive Import
12494	0x0C2F	2	Int32	19	varh	RW	Reactive Export
12496	0x0C30	2	Int32	20	varh	RW	Reactive Import
12498	0x0C31	2	Int32	20	varh	RW	Reactive Export
12500	0x0C32	2	Int32	21	varh	RW	Reactive Import
12502	0x0C33	2	Int32	21	varh	RW	Reactive Export
12504	0x0C34	2	Int32	22	varh	RW	Reactive Import
12506	0x0C35	2	Int32	22	varh	RW	Reactive Export
12508	0x0C36	2	Int32	23	varh	RW	Reactive Import
12510	0x0C37	2	Int32	23	varh	RW	Reactive Export
12512	0x0C38	2	Int32	24	varh	RW	Reactive Import
12514	0x0C39	2	Int32	24	varh	RW	Reactive Export
12516	0x0C3A	2	Int32	25	varh	RW	Reactive Import
12518	0x0C3B	2	Int32	25	varh	RW	Reactive Export
12520	0x0C3C	2	Int32	26	varh	RW	Reactive Import
12522	0x0C3D	2	Int32	26	varh	RW	Reactive Export
12524	0x0C3E	2	Int32	27	varh	RW	Reactive Import
12526	0x0C3F	2	Int32	27	varh	RW	Reactive Export

General information

Modbus Address	Modbus Address (Hex)	Size	Type	Channel	Unit	R/W	Description
4480	0x1180	1	Int16			RW	use phantom voltages, 0: disabled, 1: 3phase 120 degrees, 2: 2 phase 180 degrees, 3: virtual star point
4481	0x1181	1	Int16			RW	modbus address
5232	0x1470	2	Float		VA	RW	start threshold for event detection
5234	0x1472	2	Float		VA	RW	end threshold for event detection
5236	0x1474	2	Float		VA	RW	extend threshold for event detection
5238	0x1476	1	Int16		100 ms	RW	waiting period
5232	0x1470	2	Float			R	Voltage L1 factory calibration factor
5234	0x1472	2	Float			R	Voltage L2 factory calibration factor
5236	0x1474	2	Float			R	Voltage L3 factory calibration factor
5238	0x1476	2	Float			R	Voltage N factory calibration factor
5240	0x1478	2	Float			RW	Voltage L1 calibration adjustment factor
5242	0x147A	2	Float			RW	Voltage L2 calibration adjustment factor
5244	0x147C	2	Float			RW	Voltage L3 calibration adjustment factor
5246	0x147E	2	Float			RW	Voltage N calibration adjustment factor
5664	0x1620	1	Int16			R	Device Type
5665	0x1621	1	Int16			R	Reserved
5666	0x1622	2	Int32			R	Serial Number
5668	0x1624	1	Int16			RW	Firmware minor version
5669	0x1625	1	Int16			RW	Firmware major version

[myny-git]

I created this for energy. To be evaluated.

###############
##
## Energy
##
###############

    - name: smappee_modbus_energy_L1_import_car
      slave: 61
      address: 12288
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0       
    - name: smappee_modbus_energy_L2_import_car
      slave: 61
      address: 12292
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0      
    - name: smappee_modbus_energy_L3_import_car
      slave: 61
      address: 12296
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0 
    - name: smappee_modbus_energy_L1_import_grid
      slave: 61
      address: 12300
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0     
    - name: smappee_modbus_energy_L2_import_grid
      slave: 61
      address: 12304
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0   
    - name: smappee_modbus_energy_L3_import_grid
      slave: 61
      address: 12308
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0 
    - name: smappee_modbus_energy_L1_import_PV
      slave: 61
      address: 12312
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0
    - name: smappee_modbus_energy_L2_import_PV
      slave: 61
      address: 12316
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0 
    - name: smappee_modbus_energy_L3_import_PV
      slave: 61
      address: 12320
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0


    - name: smappee_modbus_energy_L1_export_car
      slave: 61
      address: 12290
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0       
    - name: smappee_modbus_energy_L2_export_car
      slave: 61
      address: 12294
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0   
    - name: smappee_modbus_energy_L3_export_car
      slave: 61
      address: 12298
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0  
    - name: smappee_modbus_energy_L1_export_grid
      slave: 61
      address: 12302
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0
    - name: smappee_modbus_energy_L2_export_grid
      slave: 61
      address: 12306
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0
    - name: smappee_modbus_energy_L3_export_grid
      slave: 61
      address: 12310
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0
    - name: smappee_modbus_energy_L1_export_PV
      slave: 61
      address: 12314
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0
    - name: smappee_modbus_energy_L2_export_PV
      slave: 61
      address: 12318
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0
    - name: smappee_modbus_energy_L3_export_PV
      slave: 61
      address: 12322
      input_type: holding
      device_class: energy
      data_type: int32
      state_class: total_increasing
      unit_of_measurement: Wh
      swap: word
      scan_interval: 20
      precision: 0

[peterdedecker83]

Great work!

Question:
name: smappee_modbus_energy_L1_import_car
name: smappee_modbus_energy_L1_export_car

How do I have to interpret these? Is this a sensor for bidirectional power to and from the car, charging and V2G?

Is there a possibility to create kind of a sensor for total energy delivered to the car? Is that just a combination of the smappee_modbus_energy_L1_export_car, L2 and L3 sensors?

Thanks!

[peterdedecker83]

Actually, for the modbus_energy_l1_import_car it makes sense: that would be the counter of total energy delivered to the car. I see them softly increasing when the car is being charged. No increase when there is no power. Values look as expected.

[myny-git]

Excellent, it would be nice to evaluate the graphs later for all the energy sensors, next to the original integration of Smappee.
I did not charge my car recently, will do it soon.

[peterdedecker83]

Excellent, it would be nice to evaluate the graphs later for all the energy sensors, next to the original integration of Smappee. I did not charge my car recently, will do it soon.

It could indeed be interesting to compare them with the official Smappee data, but I would expect no difference. The main difference is that you get realtime local accurate data with the modbus probe.

With the P1-meter I have accurate updates every second. The batterij is connected over modbus with same accurate readings at 1Hz. We could also increase Smappee readings to 1 Hz, but in fact this is of less use as long you have the main sources at decent intervals for steering. Smappee are good counters and needed for actions, less important to have readings at 1 Hz.

[myny-git]

I checked it today as well during charging. Indeed, the import_car is the energy that is delivered to the car. I had to add up all three imports: L1 + L2 + L3. Then, you get a value Wh. But all energy requires kWh, so I divided still by 1000.

This is my template sensor.

   - name: smappee_energy_import_car
      unit_of_measurement: kWh
      device_class: energy
      state_class: total
      state: >
        {{
          (states('sensor.smappee_modbus_energy_L1_import_car') | float +
          states('sensor.smappee_modbus_energy_L2_import_car') | float +
          states('sensor.smappee_modbus_energy_L3_import_car') | float) / 1000
        }}

So far, so good! We can ignore the export_car for now, as I do not see this increasing.

[myny-git]

smappee_energy_import_pv

During the night, this seems off, during the day, this increases ... this is the energy realized by the PV-system

smappee_energy_export_pv

flat during the day, slightly increasing during the night (as the converter consumes some power.

smappee_energy_export_grid

This is flat during the night, so no export. Indeed, this implies the energy exported to the grid

smappee_energy_import_grid

Always increasing (not so sunny days and lots of charging of the car) -- real grid consumption

I think it makes sense and therefore updated the docs!

[ballydoon]

Single Phase Smappee Connect Modbus Registers

After some trial and error the modbus registers for single phase are-

Car Power 256
Grid Power 260
PV Power 264
Car Current 128
Grid Current 132
PV Current 136

[myny-git]

Thanks. Based on the 3-phase energy, I would consider:

Car import 12288 ## energy delivered to the car
Grid import 12292 ## energy imported from the grid - aka consumption
PV import 12296 ## PV-generated energy or production
Car export 12290
Grid export 12294 ## energy exported to the grid - aka grid feed-in
PV export 12298

All values in Wh, use template sensors (as described in the docs) to make kWh