Product page: https://www.omnect.io/home
This service is intended to run on a device that is delivered to an end-user without a preset configuration for its wifi settings. It allows a bluetooth client (like a Chrome browser running on a PC or smartphone) to make the appropriate settings to connect the device to an existing wlan access point.
The code provided is not recommended for production scenarios. It is a proof of concept in order to demonstrate the underlying workflow. Further it is based on Bluez which is also not the recommended bluetooth stack and which might not be suitable for a required bluetooth certification.
This service uses the following command line options:
- -b, --ble-secret <BLE_SECRET>
- secret shared between client and server used for BLE communication
- -i, --interface <INTERFACE>
- (wireless) network interface name [optional, default: wlan0]
The crate wifi-commissioning-gatt-service has the optional feature systemd.
If you enable systemd it notifies systemd that the startup is finished.
The systemd service file systemd/wifi-commissioning-gatt@.service is using the script omnect_get_deviceid.sh (see -b option), in order to supply the device ID.
In the case the service is not used in combination with the meta-omnect layer, it has to be adapted accordingly.
There is the web based bluetooth client client/web_ble.html, which can be used to configure the wifi of the device using bluetooth.
The web browser has to support the bluetooth API; e.g., the Chrome browser.
The BLE_SECRET variable in client/web_ble.js has to be set to the shared secret, in order to authorize the bluetooth connection.
Licensed under either of
- Apache License, Version 2.0, (./LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (./LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
copyright (c) 2021 conplement AG
Content published under the Apache License Version 2.0 or MIT license, are marked as such. They may be used in accordance with the stated license conditions.