User Tools

Site Tools


supported_hardware:genmon

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
supported_hardware:genmon [2021/08/26 14:55] – created James Sentmansupported_hardware:genmon [2023/02/13 14:52] (current) – external edit 127.0.0.1
Line 29: Line 29:
  
 ====XTension Units:==== ====XTension Units:====
-{{:supported_hardware:genmon_units.png?600 |}} The plugin will create some subset of the shown units depending on what data is available from your specific generator model. There may be others that the genmon interfaces shows or that are listed under the “unsupported sensors” portion that I could add support for if they contain useful information for you. The genmon software will also read 1-wire and 1-wire based thermocouple temperature sensors connected to the pi which can be quite valuable. As of this moment I don’t have any connected and so have not written in support for them but I do plan to do this also in the future. Let me know if this is something you need sooner than that.+ 
 +{{ :supported_hardware:genmon_units.png?800 |}}  
 + 
 +The plugin will create some subset of the shown units depending on what data is available from your specific generator model. There may be others that the genmon interfaces shows or that are listed under the “unsupported sensors” portion that I could add support for if they contain useful information for you. The genmon software will also read 1-wire and 1-wire based thermocouple temperature sensors connected to the pi which can be quite valuable. As of this moment I don’t have any connected and so have not written in support for them but I do plan to do this also in the future. Let me know if this is something you need sooner than that.
  
 The default unit names will be the name of the interface and then the data name as genmon shares it. Once the unit is created you can edit the units and give them any name you wish, or just remove the interface name portion if that makes your interface easier to read and work with. Do not change the address of the units as this is how the data gets to the right unit. The default unit names will be the name of the interface and then the data name as genmon shares it. Once the unit is created you can edit the units and give them any name you wish, or just remove the interface name portion if that makes your interface easier to read and work with. Do not change the address of the units as this is how the data gets to the right unit.
Line 78: Line 81:
  
 **KW Hours in the last 30 days:** How much power it’s generated for you in the last 30 days. **KW Hours in the last 30 days:** How much power it’s generated for you in the last 30 days.
 +
 +**Alarm Log:** The description of this unit will be set to the last Alarm Log entry. When the value changes you can catch that in the on descriptionChanged event in the Unit’s ON script. The unit will also be sent an ON whenever the log line changes. You can use a “Unit Description As Text” control type to add this display to a web interface or an XTension view.
 +
 +**Service Log:** The description of this unit will be set to the last Service Log entry. When the value changes you can catch that in the on descriptionChanged event in the Unit’s ON script. The unit will also be sent an ON whenever the log line changes. You can use a “Unit Description As Text” control type to add this display to a web interface or an XTension view.
 +
 +**Run Log:** The description of this unit will be set to the last Run Log entry. When the value changes you can catch that in the on descriptionChanged event in the Unit’s ON script. The unit will also be sent an ON whenever the log line changes. You can use a “Unit Description As Text” control type to add this display to a web interface or an XTension view.
  
 ----- -----
Line 87: Line 96:
 You may wish to edit some of the units like the battery charger sensor and the utility voltage units, go to the advanced tab and check the “don’t log new values” checkbox. These units are updated a lot and will spam your log unnecessarily with value received messages that are probably not helpful. The data will still be available in XTension and for graphing in [[:xtdb|XTdb]]. You may wish to edit some of the units like the battery charger sensor and the utility voltage units, go to the advanced tab and check the “don’t log new values” checkbox. These units are updated a lot and will spam your log unnecessarily with value received messages that are probably not helpful. The data will still be available in XTension and for graphing in [[:xtdb|XTdb]].
  
-As of this moment it may not catch every alert or error condition that might possible be sent. It will not alert you to maintenance due or display the most recent log items though I can do all these things in the future and plan to as I get to know my own generator better. Please let me know if you wish to capture some of this data from your own machine to speed up the process.+As of this moment it may not catch every alert or error condition that might possible be sent. It will not alert you to maintenance due. Please let me know if you wish to capture some of this data from your own machine to speed up the process of supporting them all in the future.
  
 ----- -----
Line 97: Line 106:
  
 The “Maintenance” data is updated only every minute and includes the ambient temperature sensor as well as the run hours and total fuel use data. The “Maintenance” data is updated only every minute and includes the ambient temperature sensor as well as the run hours and total fuel use data.
 +
 +If the genmon process or pi is restarting you will get errors in the log as it attempts to reconnect and probably many others as the initial messages do not have any data in them. Ignore that for the moment as I look into properly ignoring messages that are not really errors while still being able to handle the condition where the pi or the genmon process goes offline unexpectedly.
  
 ----- -----
supported_hardware/genmon.1629989752.txt.gz · Last modified: 2023/02/13 14:51 (external edit)