Starting a new thread here so as not to overload the original EmonTx4 thread with documentation updates (See original thread AVR-DB: emonTx V4, new hardware in progress - #261 by TrystanLea). The new emonTx4 documentation is available here: https://docs.openenergymonitor.org We are in the process of moving from the old guide documentation to this new site based on ‘Read the docs’. This will house both the existing documentation e.g emonPi and emonTx v3 in addition to the new hardware. This new implementation builds directly from the documentation placed in e.g the emonTx4 GitHub repository itself, so you can choose to either view the same documentation on github or with the nice ‘Read the docs’ theme.

I think there may be a small spelling error on this page. Note: by default the new version of the emonBase with the RFMSPI is NOT compatible with **order** hardware e.g emonTx V3 and emonTH V2. Please contact us if you would like a version which is compatible with older hardware. I think that order should be older.

I’ve updated the documentation with some of your earlier feedback @borpin [image] borpin: Perhaps amend this to say emonBase or emonPi [image] borpin: On Arduino instructions, as a new user, it took me an age to work out where the ‘libraries’ folder should go! [image] borpin: before the ‘select chip’ can be done. All amended/improved. [image] whitecitadel: I think the cable was determined to be 1mm^2 in the EmonTX4 discussion? Just a note. fixed this, thanks [image] whitecitadel: Are the new CT directional? There is a marking added a note on this, thanks. The USB-C connector orientation images are also added in now. I’ve also modified emoncms to first fetch the available firmware list from the github repository which should after one more system update not then require further system updates just to make the latest firmware available in the firmware update list.

@borpin not covered everything you’ve mentioned re emonTx3 firmware yet, but here’s a start: Firmware — OpenEnergyMonitor 0.0.1 documentation I’ve also copied more of the wiki page content over onto the technical page: emonTx Technical Overview — OpenEnergyMonitor 0.0.1 documentation more work to do on that as well.

Great @TrystanLea. Have you found how to point the docs page back to the source file yet?

Yes finally worked out a solution for the edit source links, so far applied this to the emonTx4 pages. Need to extend to the rest of the documentation. I’ve also moved the github repository for the documentation to: https://github.com/openenergymonitor/docs and improved the way the separate emonTx4, emonTx3, emoncms etc repositories are linked into that to make it much easier to install and update. Im back to using git submodules but structuring the directory differently.

[image] TrystanLea: to make it much easier to install and update But is it going to be easy for users to find what they’re looking for? This is the most important part.

This is just the structure of the back end source, not the display. So far it looks much better, easier to search etc. Yes there could be issues, but easier to fix as the source to content part is simpler I think.

Is the guide for extending emontx3 CTs still valid for the voltage based emontx4 CTs? If so, perhaps include a link to Learn | OpenEnergyMonitor in the emontx4 docs?

Yes, no change to front end display structure in yesterdays update. Yes the CT extension guide is still valid. I will link that in, thanks @menocar

Community

OpenEnergyMonitor

OpenEnergyMonitor Community

EmonTx4 Documentation

Organisation Documentation