Initial choices for a new user

[5iver (Scott Rushworth)]

@BHall

I have really struggled with getting the file structure correct since I see differences when looking around.

The directory names are case sensitive and must be in lower case.

@BHall

It would be nice if the references to the file structure would show the full file path and be clear if Windows 10 or another operating system.

Ignore all documentation for scripted automation except for this… Helper Libraries for openHAB Scripted Automation — openHAB Helper Libraries documentation.

For the directory structure, see… File Locations — openHAB Helper Libraries documentation. Other than the root directory, the directory structure is the same for everyone.

@BHall

I wish VB.NET was an option for scripting in openHAB2 but as near as I can tell from what I have read apparently it is not.

VB.NET is absolutely not currently compatible for use in OH with the new rule engine and scripted automation. Currently, only scripting languages that implement a scripting engine using the javax.script API are compatible.

@BHall

I would like to avoid spending time learning things that will be going away since I assume I would want to move to openHAB3 as soon as that is an option.

OH 3.0 will be a hot mess, particularly for the rules DSL. Starting out in OH using scripted automation, Jython, and the helper libraries has MANY benefits, and it currently looks like there will only be minor changes needed to use these scripts in OH 3.0, such as changing the directory structure.

@BHall

I would be appreciative of any thoughts or words of wisdom any of you may have on how best to proceed in a way that will make things easier down the road.

Until available in your UI, you can easily install Jython and the helper libraries using this…

[beta testers wanted!] Jython addon w/ helper libraries (requires OH 2.5.x)

I just submitted a PR that adds a core feature for a JythonScriptEngineFactory and it would be great to have some testers! Basically, this will allow for the installation of Jython including the core and community helper libraries through Paper UI, once the PR is merged. If you’d like to test it, you’ll need to… Have OH 2.5.x (S1778) or newer Shutdown OH Backup OH Download the addon and copy to $OPENHAB_HOME/addons/ (see here for more details). The jar contains the core and community helper li…

Just be aware that if using Windows, the scripts will not run after OH is started. This will be corrected in OH 3.0. I have another jar that will correct it in OH 2.5.x…

Simplified Jython rule definition (similar to Rules DSL) using a universal decorator

@niebochod, with the help of your debugging, I was able to fix the issue on Windows where scripts were not starting when OH starts. Here is the PR… https://github.com/openhab/openhab-core/pull/1367 This PR will end up in OH 3.0, but I’ve made a test jar that is built to work with OH 2.5.x. If you’d like to try it (or anyone using scripted automation with Windows!), use your console to uninstall this bundle… bundle:uninstall org.openhab.core.automation.module.script.rulesupport Then shutdown …

@BHall

Channels - Paper UI
Items - Files

Items are best in text files until the REST API is built out and then hooked up in the new UI (OH 3.0).

Let OH create your Things. You may get some misleading feedback about this regarding backups, but ignore it, since the Things are all in the jsondb (text files) and very easy to backup and even edit. With a manual installation, like is done for Windows, backing up OH is as simple as copying a directory. I still prefer a manual installation of OH over a repository installation, and I use Fedora.

I suggest not using OH on Windows and having it bogged down with all the bloat. If OH is not run on dedicated hardware, it is very easy to slow it down. When it comes to things like turning the lights on, every cycle counts in order to keep you from standing in the dark… even if it is for just a fraction of a second .

Take a look running openHABian on a Pi. This will help a bit with any Linux learning curve.

@BHall

Should I assume it is too early to try openHAB3 ?

OH 3.0 is available for testing, but it is much too early for production use, especially for a beginner.