EmonTx4 Documentation

borpin · 2022-12-01T07:52:08.763Z

Looks great! Couple of bits

The OEM icon is not appearing in the browser tab - perhaps do something so it is easy to distinguish the docs from the other OEM tabs I have open

Couple of other bits (as I’m not sure

Perhaps amend this to say emonBase or emonPi Firmware — OpenEnergyMonitor 0.0.1 documentation

On Arduino instructions, as a new user, it took me an age to work out where the ‘libraries’ folder should go!
:

Please add to docs

The libraries folder is a folder that must be added to your Sketchbook folder (location found in preferences).

Simply create the folder named libraries in that folder and place the libraries you need, there.

Select Board - this needs to be added under ‘Compilation’

image841×215 8.82 KB

before the ‘select chip’ can be done.

TrystanLea · 2022-12-01T13:39:13.516Z

Thanks @borpin will incorporate these, much appreciated.

Robert.Wall · 2022-12-01T13:41:29.028Z

The “old” Installing Libraries documentation says (or used to say) this quite clearly - plus the reason for it.

TrystanLea · 2022-12-01T13:44:12.971Z

Latest updates today:

Fixed quite a few formatting issues for the learn section, brings it closer to the ‘read the docs’ conventions. E.g https://docs.openenergymonitor.org/electricity-monitoring/ct-sensors/installation.html
PV Diversion section is now included: https://docs.openenergymonitor.org/pv-diversion/mk2/index.html
New: EmonHub overview page: https://docs.openenergymonitor.org/emonhub/overview.html (also accessible on from the emonhub github repository directly e.g: emonHub Overview — OpenEnergyMonitor 0.0.1 documentation)
EmonHub configuration from the github repository is now accessible too, which is nice as this was a bit hidden away before for people accessing the documentation via the guide: https://docs.openenergymonitor.org/emonhub/configuration.html
EmonHub interfacers page moved from the guide https://docs.openenergymonitor.org/emonhub/emonhub-interfacers.html - there is some duplication with content on the configuration page that needs a bit more work here.

TrystanLea · 2022-12-02T15:41:09.025Z

Documentation updates so far today:

Applications pages moved over from the original guide, more work required to update these for the emonTx4 hardware. Heat Pump Monitoring — OpenEnergyMonitor 0.0.1 documentation
emonTx3 and emonPi documentation moved over from the original guide.
emonTx3 User Guide — OpenEnergyMonitor 0.0.1 documentation
emonPi User Guide — OpenEnergyMonitor 0.0.1 documentation
Resources page copied across: Resources — OpenEnergyMonitor 0.0.1 documentation
System overview page copied and simplified for now (more work required) System Overview — OpenEnergyMonitor 0.0.1 documentation
New: emonTx4 ESP8266 Adafruit Huzzah adapter board details on the expansion boards page:
Expansion boards — OpenEnergyMonitor 0.0.1 documentation
Front page, & forum header links updated to point to the new docs location, as well as keeping a link to the original guide for now until all documentation is available in the new location.

There’s a lot more updating of the older documentation to do. We’re focusing on getting the new structure worked out and documentation moved across first, so please bear with us if some parts look a bit disjointed

Rincewind · 2022-12-02T18:19:43.148Z

Documentation states default wifi AP for setup is ‘emonpi’ and password emonpi2016. My TX4 just arrived (ordered release day), the AP is actually emonSD, after a few combination guesses I’ve found password is emonsd2022

TrystanLea · 2022-12-02T19:33:42.565Z

Thanks @Rincewind, fixed and improved a few other formatting related items.

TrystanLea · 2022-12-04T15:17:42.210Z

There is now a new emonTx4 documentation page on using the temperature sensing, pulse counting and analog input (available either via the RJ45 socket or the pluggable terminal blocks. Please see:

emonTx4 documentation: Temperature, Pulse & Analog

The analog input documentation discusses how to use the analog input for use with a Sika VFS flow meter which has an analog voltage output.

AndyS · 2022-12-06T14:59:56.724Z

Thanks Trystan: very useful as always. Is it worth mentioning in this section that the default firmware does not automatically align the T1,T2,T3 outputs with the three ports? I’m presuming that the sensor ID could be hardcoded to a port as in the past. Fortunately, I did the “finger test” before attaching to the ASHP!

TrystanLea · 2022-12-07T12:05:59.209Z

Thanks Andy, that’s a good point. Will add that as a note.

whitecitadel · 2022-12-08T10:48:05.992Z

Direct installation: The emonVs can be hardwired by a suitably competent person into a 6A or lower circuit protection device in the fuse board (consumer unit) or a 3A fused spur. The supplied emonVs mains power cable has a cross sectional area of 1.5mm2. This can provide a tidy installation if no socket is available and helps ensure higher monitoring uptime if sockets are at risk of being unplugged for use by other appliances.

I think the cable was determined to be 1mm^2 in the EmonTX4 discussion? Just a note.

whitecitadel · 2022-12-08T10:56:08.248Z

It would also be good to add in the docs what the default node is - it looks like its Node 17? And also what the individual feeds in the node are - I just get inputs 1-26.

Assuming Node 17 is the EmonTX4, I assume I can apply the profile in the feeds setting for EmonTX4 and it will name the inputs - be good to cover that in the docs for those adding to existing systems that do not recognise it by default.

EDIT: Sorry found it now under existing install config:
https://docs.openenergymonitor.org/emontx4/emontx4_emonpi_install.html#emonhub-configuration

borpin · 2022-12-09T08:31:59.264Z

@TrystanLea did you get anywhere adding the GitHub source links?

whitecitadel · 2022-12-09T11:07:12.986Z

Are the new CT directional? There is a marking

K->L

L is load? No mention in the documentation?

TrystanLea · 2022-12-09T11:19:10.476Z

Yes that’s correct, L is in direction of the load

TrystanLea · 2022-12-09T11:23:12.095Z

They are directional in the sense that when they are coupled with the emonVs voltage measurement, L to load will give you a +power reading whilst the opposite will give -reading.

On the house grid connection with exporting solar that would read negative power and positive when importing

whitecitadel · 2022-12-09T12:12:01.703Z

Thanks, that’s what I assumed.

Further feedback: In the serial section:
https://docs.openenergymonitor.org/emontx4/configuration.html#using-the-web-tool

It might be worth adding a note that if you cannot get a connection with the USB-C in either orientation, to try another cable in case the one your using is only wired for power.

Don’t ask how I know… (the Anker print should have been a clue!)

TrystanLea · 2022-12-09T14:30:19.408Z

Good point, yes that’s easily done

borpin · 2022-12-10T17:37:41.065Z

@TrystanLea I think this extended info on the DS18B20 sensors would be worth condensing for posterity. It is really useful and probably also worth mentioning in the docs that ‘cheap’ sensors can cause issues (I think it came up recently again IRRC). Ds18b20 and emonTX3CM firmware - #78 by dBC #pleaseaddtothedocs

whitecitadel · 2022-12-11T18:12:22.499Z

I did find that slightly confusing. I have 3 temp sensors to add for my hot water system, I read the paragraph:

However it is worth noting that due to the way that the one wire protocol works, specifically it’s requirement for precise timing requiring brief periods of disabling other interrupts on the microcontroller, that there is a minor negative impact on energy monitoring performance as you add more temperature sensors. This can manifest as a ±1-4W error on some CT channels. This effect can be mitigated to some extent by reducing the electricity monitoring sample rate.

So does this apply to the 3 separate inputs, the RJ45, all of them, is there a priority to follow? Should the EmonPi be used first if available to preserve accuracy on the EmonTX4 where possible etc?

Also the lack of connector for two of the inputs is an oversight in the shop listing IMHO