Skip to content

Latest commit

 

History

History
40 lines (28 loc) · 3.54 KB

README.md

File metadata and controls

40 lines (28 loc) · 3.54 KB

owapi-reborn

Gradle CodeQL SonarCloud
Quality Gate Status Bugs Code Smells Coverage Maintainability Rating Reliability Rating

Dallas Semiconductor 1-Wire API, on its own again

This code is based on the original Dallas Semiconductor owapi library version - when it was released (about 20 years ago). At that point, Java dependency management mechanism was in its infancy, and the most sensible way to retain a potentially disappearing artifact was to integrate it in its entirety.

Since then, it has been heavily reworked with stability and memory efficiency being the primary focus. Now that the project it was integrated with (Home Climate Control) is undergoing yet another transformation, it's time for this library to be separated so that it can continue life on its own - surprisingly, there's still demand for 1-Wire operations from Java.

Build

./gradlew build. Done.

About those code quality badges...

It is what it is. owapi code was never a focus for independent improvement, the quality level was "good enough" (and it is, for its primary use case). Now that the project is independent again, hopefully, that will change.

BIG FAT WARNING: This is a subset.

This library contains just a limited subset of containers, deciding factor for retaining or dropping being usefulness for the Home Climate Control project. This subset is being maintained, others were dropped long time ago.

There are other copies of the original 1-Wire library code on the Internet, the most complete at the time being the one at https://github.com/onewire/onewire/tree/master/owapi - go there if you need a full set, but there are no guarantees about authenticity or heritage of that code. Fair warning, at the moment of writing it doesn't even build - bit rot is merciless. Good luck.

Next Steps