Skip to content
This repository has been archived by the owner on May 7, 2020. It is now read-only.

[bluetooth] WIP: Merging BluetoothSmart and Ble Bindings #4112

Closed
wants to merge 8 commits into from

Conversation

vkolotov
Copy link

@vkolotov vkolotov commented Aug 22, 2017

This PR is to merge vkolotov's OH BluetoothSmart binding and cdjackson's BLE binding.

Objectives and KPIs

Objectives

  1. Merge the two PRs
  2. Productionize the result

KPIs

  1. Flexibility in using different transports, e.g. serial port, DBus or any other (like tinyb).
  2. Extensibility in adding new supported devices (new OH addons), e.g. different sensors and other hardware.
  3. Robustness. Due to the nature of the Bluetooth protocol, we will have to make our bindings stable enough so that people could use it. This is the biggest challenge for this project.
  4. Comprehensive support for Bluetooth GATT specifications. This is a powerful feature which would allow users:
    • add any device which conforms GATT specification without developing any new binding
    • add custom made devices by only specifying a path to custom defined GATT specification for a device

Progress

  1. Merging BluetoothSmart binding into ESH project
  2. Splitting BluetoothSmart binding into two bundles: bluetooth and transport (tinyb) bundles
  3. Making adapter things to be bridges
  4. Extracting tinyb library into a separate bundle (this should resolve the issue "native library already loaded in another classloader")
  5. Implementing/merging BlueGiga transport/bundle - 70% DONE.
  6. Implementing a basic binding for a specific device (POC) to discover possible options for future binding implementations. GATT specification driven and custom code/logic driven
  7. Merging YeeLightBlue binding/bundle
  8. Implementing DBus transport
  9. Stabilizing

Implementation details

1. Bluetooth URL

bluetooth url

This is a useful component which allows us to identify any BT resource. It is similar to @cdjackson
BluetoothAddress, but it also supports locating BT adapters, services, characteristics and GATT fields. Even if multiple adapters are used, the URL can precisely identify resource of a BT device. That class is reasonably documented, so take a look at the comments in the file for more info.

The Bluetooth URL can help to address Flexibility and Extensibility KPIs.

2. Transport abstraction layer

transport abstraction layer

This is an API which is supposed to provide an abstraction layer between hardware and OpenHab. The API provides common interfaces for BT adapter, device, GATT service, GATT characteristic. It also supports plugging in different implementations for different transport types, such us serial port transport or BDus transport. In order to do so, a new transport layer must implement a limited number (actually only 4 interfaces, an example here) of interfaces.

This abstraction layer can help to address Flexibility and partially Robustness.

As a first step, I would leave TinyB transport as a main transport for linux based set-ups, however I agree that this should be converted to be using native DBus adapter. I can even suggest a good candidate for this work - hypfvieh. I had a chat with David a couple of months ago, he might be interested in this.

3. Bluetooth Manager

bluetooth manager

It is a set of APIs and processes which are responsible for robustness of the system. The central part of it is "Governors" (examples and more info BluetoothGovernor, AdapterGovernor, DeviceGovernor and BluetoothManager). These are components which define lifecycle of BT objects and contain logic for error recovery. They are similar to the transport APIs, but yet different because they are active components, i.e. they implement some logic for each of BT objects (adapter, device, characteristic) that make the system more robust and enable the system to recover from unexpected situations such as disconnections and power outages.

Apart from making the system more stable, the Governors are designed in a such way that they can be used externally, in other words it is another abstraction layer which hides some specifics/difficulties of the BT protocol behind user-friendly APIs.

Obviously the Bluetooth Manager is supposed to help us with Robustness and Extensibility KPIs.

4. GATT Parser

It is a component which can translate BT raw data into user-friendly format. In short, it reads GATT specifications (xml files) and converts raw data into map of: Field name -> value. Works both ways, e.g. raw data -> fields (read operation) and fields -> raw data (write operation). All complex logic related to bit operations, type conversions, validations etc are hidden in this component. More info here.

This component will allow us to create "generic" OH handlers which can work with any devices that conform GATT specifications OR users can supply their own implementations for GATT specs in XML files to add their own custom made devices.

Architecture design

openhab bluetooth

As you can see that diagram reflects the diagram you pointed out earlier. It is quite similar. There are bundles to add transport, bluetooth binding APIs and some specific binding for a particular device (YeeLightBlue).

The only significant difference is the way how transport is plugged in to OH. In contrast to @cdjackson implementation, the transport implementations are plugged in to Bluetooth Manager via well defined transport APIs.

Another difference is that all OH handlers are supposed to work with the "Governors API" which provides/separates handler specific logic from dealing with BT protocol nasties.

Please note that on the diagram green colour means that it is already implemented (well to certain extend that it can be thought that it is implemented), blue and red colours - something we need to develop/merge. In my mind, the blue components can be implemented/merged by @cdjackson and the red components by me. Of course we all need to put some effort in polishing the green components, however I promise to take the main responsibility in supporting the green stuff.

PS. I'm still transferring/merging useful information/comments from the two PRs. There will be added more info/details/design notes.

cc @kaikreuzer @cdjackson

…bluetoothsmart binding into two bundles: bluetooth and bluetooth tinyb transport

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
…in.includes property)

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
@kaikreuzer
Copy link
Contributor

Many thanks for the efforts @vkolotov!

I'm still transferring/merging useful information/comments from the two PRs.

Just to proactively mention a few that matter to me:

  • Regarding (1): Imho we must not have addresses that depend on the specific transport/adapter as commented here.
  • Regarding (3): The Bluetooth Manager looks like a very central part of the architecture and - afaics - it will also be part of the exposed API (towards adapters as well as specific device support). As such, we cannot use code from a 3rd party library within ESH, because the APIs must be under control of the project. I'd therefore very much prefer if you could consider to contribute that code under EPL as well and make the sources part of ESH. If they indeed are stable and likely not require to be changed any time soon, maintaining such a forked code base shouldn't be a big issue.
  • Regarding (4): The GATT parser seems to be rather an optional service, so we might agree that this can be included as an external library. Nonetheless, we should check whether we add an ESH API facade to it in order to not directly expose the external library as an API.

Implementing/merging BlueGiga transport/bundle

@cdjackson Is this something you could start looking into? It might be a good opportunity to see how well the architecture fits to your expectations and to provide early feedback, if you think something is not ideal.

@kaikreuzer
Copy link
Contributor

@vkolotov Another question: Where did you get the binary of tinyb from? Is there a single binary that works for x86 and arm platforms?
Note that the Eclipse Kura project is currently also trying to use tinyB for BLE support and they deal with the Eclipse IP process. From what I read there, they have to build the binary by themselves, because there is no appropriate binary available. They specifically also recently did some bug fixes that they required to make it work smoothly in OSGi. Additionally, there have been quite some memory leak fixes in the past weeks, so it might make sense to use the latest code base. I will check the approval progress on Kura side and I think it is probably the best if we then use the same binary as this will make the approval for us extremely easy (rather than extremely hard otherwise...).

…w look like: bluetooth:ble:<adapter>:<device>, e.g.: bluetooth:ble:001A7DDA7104:CFFC9EB20E63

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
@vkolotov
Copy link
Author

vkolotov commented Aug 27, 2017

Hi @kaikreuzer for your valuable feedback.

Re thing UIDs:

This is working exactly like you said. The binding does not know anything about transport type. I have managed to keep transport notion (protocol bit of URL) in the BluetoothManager so it does not leak from it to the binding. Thing UIDs looks look like that now: bluetooth:ble:'adapter':'device', e.g.: bluetooth:ble:001A7DDA7104:CFFC9EB20E63.

Re BluetoothManager dependency:

I totally understand your point of view as a product owner of ESH. You need to have control over the API. However, I'd like you to understand my point view as well so that we can find reasonable compromise.

I personally happy to contribute to ESH, I like opensource. However, that would be a dead-end for the BluetoothManager if we moved it to ESH (because Eclipse foundation simply is not flexible enough). I believe it's got future and can be used by other projects, like kura etc. It is quite unique, I could say.

This is what I can propose. iIf you believe that the BM is not stable enough and its future unpredictable (API), then we could come up with a facade and adapters in ESH for it.

However, I personally think that there will be no risk in having it as a main API for Bluetooth binding. I will be looking after that project for quite awhile. I also believe that we can find more contributors for it if it was outside of the ESH as a separate library which can be used just by referencing it through maven (btw it is already in the central maven repo, all components including GATT parser).

I'm happy to discuss this further.

Re Gatt Parser:

I agree, it is not a central part.

Re BlueGiga:

I had a delivery of a BlueGiga dongle. I could do the initial merge of @cdjackson transport bundle into this PR to validate our architectural decisions. I will need to have a look how it goes, I may expect to see some issues (some incompatibility of APIs between dbus and serial) that I will need to be addressed in the BM first. As soon as I'm sure that everything goes fine and there is not major issue, then I would like to have some help from @cdjackson. I believe that would be more efficient for now.

Happy to discuss this approach as well.

Re TinyB:

I built that library locally with no modifications to it. This will probably require separate binaries for x86 and ARM platforms. I will need some help from you @kaikreuzer to figure out how to implement this in ESH (e.g. loading different native libs for different CPUs).

I do monitor TinyB github project and I'm aware of the issues they have fixed recently. That would be great if we could use the same (kura) approved lib by Eclipse.

Ultimately, we should create a transport bundle purely based on dbus for java implementation. I have this in my mind as I believe TinyB is just a temporary solution (which is actually not too bad).

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
@maggu2810
Copy link
Contributor

e.g. loading different native libs for different CPUs

This could be solved easily by OSGi itself -- so correct manifest headers...
You could create a bundle that contains the different native libraries of fragments per architecture.

Re BluetoothManager dependency

Personally I don't like that "move libraries code base to ESH repo" approach.
Let's keep the third party stuff in third party repo and their development independent of the ESH development cycle. They could be used by other projects, are under full control of the author, etc.
Moving an implementation to ESH only because we want to use it feels wrong to me.

Shouldn't be a "stable" API the relevant requirement?
So, that we don't need to change our API all the time an external one has been changed (but we don't need to bump the external lib if we don't want to break the API).

Why do the API need to be under full control of the ESH project?
Isn't also the OSGi framework part of our API?
I never checked which external libraries are part of our API, is there no one?

@maggu2810
Copy link
Contributor

maggu2810 commented Aug 29, 2017

[ERROR] Failed to execute goal on project bluetooth-manager: Could not resolve dependencies for project org.sputnikdev:bluetooth-manager:jar:1.1-SNAPSHOT: Could not find artifact intel-iot-devkit:tinyb:jar:0.5.0 in central (https://repo.maven.apache.org/maven2) -> [Help 1]

If I checkout https://github.com/intel-iot-devkit/tinyb and build the sources, I get the shared library.

./include
./include/tinyb.hpp
./include/tinyb
./include/tinyb/BluetoothAdapter.hpp
./include/tinyb/BluetoothDevice.hpp
./include/tinyb/BluetoothEvent.hpp
./include/tinyb/BluetoothException.hpp
./include/tinyb/BluetoothGattCharacteristic.hpp
./include/tinyb/BluetoothGattDescriptor.hpp
./include/tinyb/BluetoothGattService.hpp
./include/tinyb/BluetoothManager.hpp
./include/tinyb/BluetoothObject.hpp
./include/tinyb/BluetoothUUID.hpp
./lib
./lib/pkgconfig
./lib/pkgconfig/tinyb.pc
./lib64
./lib64/libtinyb.so.0.5.0-18-g6fb269f.0.5.0-18-g6fb269f.0.5.0-18-g6fb269f
./lib64/libtinyb.so.0.5.0-18-g6fb269f
./lib64/libtinyb.so

@vkolotov Can you point me to the jar?

-- edit --

Okay, should read the README 😉

-DBUILDJAVA=ON

@vkolotov
Copy link
Author

vkolotov commented Sep 4, 2017

Hi @kaikreuzer @cdjackson, good news. I've made some good progress implementing/merging Bluegiga transport with just some minimal changes for BluetoothManager.

@cdjackson looks like you've got some uncommitted changes in your project bluegiga. I'm trying to make an improvement for it and build a new jar. However, what's in git is not the same what you have in your ESH lib folder. For example, the source in ESH has NotificationService.java class, but there is not such in git. Would you be able to have a look?

The bluegiga project obviously has a dependency on rxtxlib. How are we going to deal with it? As far as I can see there is not any bundle in ESH which supplies that lib.

@vkolotov
Copy link
Author

vkolotov commented Sep 4, 2017

BTW, @kaikreuzer do you have any thoughts around the BM dependency issue discussed earlier?

…cteristicAccessType)

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
@kaikreuzer
Copy link
Contributor

I've made some good progress implementing/merging Bluegiga transport

Sounds wonderful!

@cdjackson looks like you've got some uncommitted changes in your project bluegiga. Would you be able to have a look?

@cdjackson Could you clarify this?

The bluegiga project obviously has a dependency on rxtxlib. How are we going to deal with it? As far as I can see there is not any bundle in ESH which supplies that lib.

This is indeed a problem and due to license issues, we won't be able to get rxtx into ESH itself. We had discussed this here already and my suggestion was to put the BlueGiga-Bridge bundle into the openhab2-addons repo as a workaround.

do you have any thoughts around the BM dependency issue discussed earlier?

Yes, an I also had quite some internal discussions meanwhile. I fully understand your argument that you do not want to tie the BM to ESH code as this would make it impossible to use it independently in other projects.
Nonetheless, as the code will become a major part of the API for BT device bindings, it really has to be under the project namespace. We can really only make exceptions for well-established and widespread libraries - and even then, it is only under pain and not the preferred option.
Yes, we could hence think about a facade, but I fear that this won't really solve the second major issue about external libraries, which is the governance. You mention: "Eclipse foundation simply is not flexible enough" - I am not sure what exactly you mean by this, but my assumption is that it is about the involved formalities like ECA, sign-offs, CQs, etc. The thing is: All of this is done (and necessary!) for a proper project governance and IP management. And these are exactly the things that are expected from ESH (and thus the BM code) and we should not give up on any of these. Note that the very same is true for e.g. Kura: The best way to make BM being used by other Eclipse projects (or by anything that seriously cares about IPRs and the minimisation of legal risks) is to host the code at Eclipse and use the proven governance mechanisms.

it if it was outside of the ESH as a separate library which can be used just by referencing it through maven

You should note that ESH is nothing else but a set of JARs. So it is on us to put the BM in a separate bundle with no dependencies on any other ESH stuff - as a result, this would be available as a jar in Maven, which can be used in any context, i.e. completely independently from ESH.

@cdjackson
Copy link
Contributor

cdjackson commented Sep 11, 2017 via email

@vkolotov
Copy link
Author

Hi @kaikreuzer thanks for you feedback.

This is indeed a problem and due to license issues, we won't be able to get rxtx into ESH itself. We had discussed this here already and my suggestion was to put the BlueGiga-Bridge bundle into the openhab2-addons repo as a workaround.

Putting it in a different project would be disappointing. Re your question what architectures rxtx lib supports: it support arm, x86. That said it is running on windows, linux and OSX. Which is great, I believe, because it spans a great number of OSs and would be a good addition to tinyb/dbus. In fact, tinyb works only in linux (arm and x86). I made a good progress porting/merging @cdjackson work with his awesome library for bluegiga adapter. Looks like everything is working, including bluetooth notifications (which is awesome!).

BTW @cdjackson, it has not been updated for 3 months, so looks like you have not pushed your changes...

How about tibyb? Is it going to be approved any time soon?

Re BluetoothManager:

It is sad to hear that the Eclipse Foundation has the such problems with external references. The way how that "foundation" behaves lays much behind opesource side of things. I completely agree with @maggu2810 that it is not right to own the code/api just because they want it. This is not right, the freedom of opensource is vastly constrained in that way. If Eclipse foundation forces the good will of contributors to do the things like "they know better", I feel really sorry for the contributors. That's why probably during my career/work experience I used only a little of Eclipse products. Honestly speaking I do not see any future of BM within Eclipse Foundation. All these politics do not do any good job neither for OH nor for end-users. I would better keep working in my branch providing the bundle (and the libraries) to people as a 3rd party plugin for OH2, rather than letting the big hippopotamus to own the code and "control" it.

What you propose is neither a trade-off nor a compromise. It is just an ultimatum. Definitely not an opensource approach.

I don't think that the such governance plays a good role in the Eclipse products, for example, I have never seen Eclipse IDE working great. In my humble opinion, It feels sad that Eclipse actually was selected as a main platform for OH.
There are lots of free flowing projects out there in the opesource world without any politics involved.

Anyway, I will continue to work on the Bluetooth plugin, it is up to you to merge my stuff or not.

@cdjackson
Copy link
Contributor

BTW @cdjackson, it has not been updated for 3 months, so looks like you have not pushed your changes...

I will double check, but I think everything is pushed and from a quick check of the latest source, it looks like the changes I made last are in the master. The last changes are indeed a few months ago, but that doesn't mean that everything is not pushed as the date in the repository is not the push date....

@vkolotov
Copy link
Author

vkolotov commented Sep 12, 2017

but I think everything is pushed and from a quick check of the latest source

@cdjackson Well... At least the NotificationService.java is missing from your repo.

Please ignore that, it is there now. Thank you.

@cdjackson
Copy link
Contributor

What do you mean by missing?

@vkolotov
Copy link
Author

What do you mean by missing?

It was missing, but now it is there. Cheers. I'll create some PRs soon for some minor improvements. Would you be able to release the lib @cdjackson ?

@cdjackson
Copy link
Contributor

cdjackson commented Sep 12, 2017

Ok - thanks. I've not pushed anything since last week or so, and I was a bit confused as your link above links directly to the file that is in my repo.... ;)

@kaikreuzer
Copy link
Contributor

kaikreuzer commented Sep 12, 2017

Re your question what architectures rxtx lib supports

I didn't ask that question, I am well aware as we are using it in openHAB through nrjavaserial, which nicely supports all the different platforms.

"just because they want it", "they know better", "All these politics"

I am sorry if I didn't express myself properly. I really tried to explain the arguments in detail and they are not because anyone wants to put arbitrary constraints on anyone to make life more difficult. Please also note that I am not speaking on behalf of the Eclipse Foundation, so please do not generalise any complaints on them.

it is up to you to merge my stuff or not.

No, it is not. It is up to the committers to decide on the evolution of the project.

@sjsf
Copy link
Contributor

sjsf commented Sep 13, 2017

I personally think that there will be no risk in having it as a main API for Bluetooth binding. I will be looking after that project for quite awhile.

Here I fully disagree. I can only look at the Gihub project, but from what I can see there are 0 contributors, 0 stars, 0 issues, 0 pull requests and 0 contributors. With this track record, I see rather a big risk in making this library an integral part of the Eclipse SmartHome APIs.

I fully trust that you are planning to take care of further evolving and maintaining your library and I deeply respect the fact that you do not want to contribute it to Eclipse SmartHome. That indeed is up to you to decide. And I really hope that it's going to be successful!

However, at the same time I kindly ask you to respect a project's decision whether or not to add a dependency to another project at this point in time.

The way how that "foundation" behaves lays much behind opesource side of things.

You are mixing things up - there are two completely different aspects that you have to distinguish clearly: The Eclipse Foundation and the Eclipse SmartHome project.

The major benefit of the Eclipse Foundation in our case is (in my personal, non-lawyer words) to make sure that this project adheres to the Open Source license (EPL in our case) and guarantee that the intellectual property within the project's deliverables is free of any legal risks to potential commercial adopters. This put some minor burden on projects like e.g. maintaining a clean track record of every contribution and also for bigger contributions and dependencies to undergo an in-depth review process. It's only goal is to check if the contributed code really is under the license it claims and the author has the permissions to contribute it under this license, i.e. make sure it is not copy'n'pasted from somewhere else. So in contrast to your belief, the Eclipse Foundation is not about owning any code, it is only about reducing the potential legal risk of using open source software which might not be what it claims to be. Unless you are working in an environment where you are commercially working with software, this might sound like a useless burden to you.

it is up to you to merge my stuff or not.

No, it is not. It is up to the committers to decide on the evolution of the project.

My vote goes to reviving #3633 then.

@vkolotov
Copy link
Author

vkolotov commented Sep 14, 2017

Hi @SJKA thanks for your comments.

Here I fully disagree. I can only look at the Gihub project, but from what I can see there are 0 contributors, 0 stars, 0 issues, 0 pull requests and 0 contributors. With this track record, I see rather a big risk in making this library an integral part of the Eclipse SmartHome APIs.

I must agree. Thank you for pointing this out. It looks indeed a bit dodgy. However, does it mean that it is in bad condition (or will it be in not decent condition)? The reason of this PR is to bring contributors attention and decide if it is ready to merge or not. Will they be looking at "stars" and the number of contributors? If so, that process will look not less dodgy comparing to the repo statistics.

However, at the same time I kindly ask you to respect a project's decision whether or not to add a dependency to another project at this point in time.

I do respect this. Furthermore, I admire OH project, it is a good piece of software art. Well done guys. However, I do not like/follow the fact that contributors are forced to move their code to ESH codebase. This vastly limits soul and freedom of opensource. You may say that all ESH sources are open, but let's be honest, who would use some internal ESH pom references from their projects? Definitely - nobody.

It is simple as this. I would define the problem we discuss here as the following:
Eclipse SmartHome project forces their contributors to move their code on its premise. By doing this, their code become more "closed" (as opposite to opensource) and make them almost not usable outside of ESH. This (imho) vastly limits soul and freedom of the opensource approach.

I personally understand the significance of being legally clean and protected. However, how that can be a problem of using external libraries if they are compatible with Eclipse Foundation license? As you said, one of the reason of PRs is to check if the code conforms with EPL. So what's wrong with the BluetoothManager code? Are there any copy-pastes? Or, does it not conform EPL?

Anyway, if you think that the community should decide between the two PRs, then would you mind if I create a poll for this? I'm thinking to make two options like that:

  • Bluetooth bundle. Give your vote to support opensource community/projects. The core of the bundle is opensource and shared amongst the opensource community. All aspects of opensource are respected.
  • BLE bundle. Give your vote to support Eclipse SmartHome only. Everything is hosted in ESH. Opensource freedom is violated.

Would this be ok for you? Just want to make this fair for both sides.

@htreu
Copy link
Contributor

htreu commented Sep 14, 2017

I personally understand the significance of being legally clean and protected. However, how that can be a problem of using external libraries if they are compatible with Eclipse Foundation license?

It is not a problem at all. From a legal point of view your code might be very well suited for a dependency in ESH.

So what's wrong with the BluetoothManager code?

It is maintained only by you, no one else is using it, nobody except you is able to maintain it. And in case you are not willing to keep it online the ESH project would loose a core dependency for the foundation of all bluetooth bindings.

So in case we dont agree in this case its a high risk for the ESH project to depend on your code.
There are exceptions to this in the codebase already but not in these crucial positions.

@vkolotov
Copy link
Author

vkolotov commented Sep 14, 2017

Hi @htreu thank you for your input.

It is maintained only by you, no one else is using it, nobody except you is able to maintain it. And in case you are not willing to keep it online the ESH project would loose a code dependency for the foundation of all bluetooth bindings.

Can't see any problem here. Let's imagine I have finished the bundle, the community approves it and merges to ESH. Everyone is happy and the bundle brings the whole world of bluetooth to the ESH. Users are happy. I continue to contribute and fix bugs. Then... from all of a sudden I disappear (which is nonsense)... What prevents you from forking the project and continue contribution (giving that prior the approval the code is fully documented)? It is opensource world.

Update: you don't event need to create a fork. Just continue to work in the same repo. The release instructions (central maven) will be provided.

@openhab-bot
Copy link
Contributor

This pull request has been mentioned on openHAB Community. There might be relevant details there:

https://community.openhab.org/t/xiaomi-smart-scale-binding/34196/2

@bademux
Copy link

bademux commented Oct 5, 2017

@kaikreuzer @vkolotov
Is there a chance that compromise will be found?
It's a pity that great stuff isn't merged yet.

@vkolotov
Copy link
Author

vkolotov commented Oct 5, 2017

@kaikreuzer @bademux I can see here several options:

  • Release the binding within ESH where the BM is a separate 3rd party dependency
  • Release the binding in the Eclipse marketplace (if it is possible at all)
  • Release the binding within OpenHab (if it is possible at all)
  • OR make it available as a downloadable bundle

There are lots of options here. Anyway it will be available to people.

PS. The development of this binding is still full speed ahead, e.g. it is not available to merge to the upstream at the moment, but will be available soon.

…ies)

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
…ies) - adding some missing jars

Signed-off-by: Vlad Kolotov <vkolotov@gmail.com>
@kaikreuzer
Copy link
Contributor

From the discussion above, I think it became clear that the Eclipse Foundation is not the right place for continuing this as its professional open source project management frame is rather regarded as a hindrance and not as a plus.

This means that the code is primarily meant for hobbyists, i.e. specifically for openHAB users.
As major parts of it are going to be maintained outside of the openHAB repo anyhow, I think from the options above, the Marketplace would be clearly the best solution for everyone.
@vkolotov is free to decide on how to split the binding into parts, to freely decide on the licenses and to follow its own release cycle. Nonetheless, the marketplace makes it very easy for users to find and install the binding.
I believe that this solution is in everybody's best interest.
For following-up on a commercial-ready Bluetooth support in ESH, I will re-open #3633.

@kaikreuzer
Copy link
Contributor

https://marketplace.eclipse.org/content/bluetooth-binding
https://marketplace.eclipse.org/content/bluetooth-binding-tinyb-transport
https://marketplace.eclipse.org/content/bluetooth-binding-bluegiga-transport

@vkolotov Please note that no transport bundles must be added to the marketplace as only binding entries are supported there for installation through the marketplace extension.
For publishing in the marketplace, you should thus merge the content of those three bundles into a single one, which can then be installed by a single click.

@vkolotov
Copy link
Author

Hi @kaikreuzer sorry for taking over your #4535. I just wanted to let you guys know that it is in progress and soonish will be released.

Please note that no transport bundles must be added to the marketplace as only binding entries are supported there for installation through the marketplace extension.

That's strange but I have tested this and the transport marketplace extensions work fine. Is this yet another regulatory rules? I thought this would be better to split transport into two "extensions" just because not all people are going to use them together.

@maggu2810
Copy link
Contributor

If I create a transport bundle "transport_a" that is used by a few of my bindings e.g. "binding_b", "binding_c" and "binding_d" it wouldn't make any sense to add the transport bundle content into every binding. Would it?

If my reading has been correct, the bundle org.eclipse.smarthome.extensionservice.marketplace currently supports binding and rule templates only.

Shouldn't we enhance that bundle to support a transport type, too?

@kaikreuzer
Copy link
Contributor

Shouldn't we enhance that bundle to support a transport type, too?

There isn't such a thing as a "transport add-on/extension". Transport bundles are internal bundles that are technical dependencies, which get automatically installed (e.g. through Karaf if they are declared in a Karaf feature). For the marketplace, we do not have a dependency mechanism in place. What is prepared is to have other packaging formats than "bundle" in future, thus as "kar" - this would allow packaging multiple bundles that are required for a single add-on. But this is yet something to implement for the marketplace support.

Until then, we only have "binding" and "rule templates" as valid categories.

@vkolotov
Copy link
Author

vkolotov commented Jan 9, 2018

hi all, the binding is available for betta testing. Please see instructions here: https://github.com/sputnikdev/eclipse-smarthome-bluetooth-binding

@openhab-bot
Copy link
Contributor

This pull request has been mentioned on openHAB Community. There might be relevant details there:

https://community.openhab.org/t/bluetooth-binding-beta-testers-needed/38492/152

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

8 participants