EmonTx4 Documentation

Organisation Documentation
4

Looks great! Couple of bits :slight_smile:

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 :rofl:

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!
:
image

Please add to docs

The libraries folder is a folder that must be added to your Sketchbook folder (location found in preferences).
image
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’

image
image841×215 8.82 KB

before the ‘select chip’ can be done.

1 Like
5

Thanks @borpin will incorporate these, much appreciated.

6

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

2 Likes
7

Latest updates today:

1 Like
8

Documentation updates so far today:

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 :slight_smile:

1 Like
9

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

1 Like
10

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

2 Likes
11

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.

1 Like
12

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!

1 Like
13

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

1 Like
14

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.

15

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

16

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

17

Are the new CT directional? There is a marking

K->L

L is load? No mention in the documentation?

18

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

19

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

20

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… :roll_eyes: (the Anker print should have been a clue!)

1 Like
21

Good point, yes that’s easily done

1 Like
22

@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

23

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