diff --git a/README.md b/README.md index f1af90fc..6741d49d 100644 --- a/README.md +++ b/README.md @@ -4,13 +4,12 @@ ![Build](https://github.com/1technophile/OpenMQTTGateway/workflows/Build/badge.svg?branch=development) ![Check Code Format](https://github.com/1technophile/OpenMQTTGateway/workflows/Check%20Code%20Format/badge.svg?branch=development) -[![Codacy Badge](https://api.codacy.com/project/badge/Grade/943c9b639b68441dae8e29ee39977ab2)](https://www.codacy.com/app/1technophile/OpenMQTTGateway?utm_source=github.com&utm_medium=referral&utm_content=1technophile/OpenMQTTGateway&utm_campaign=badger) [![Percentage of issues still open](http://isitmaintained.com/badge/open/1technophile/openmqttgateway.svg)](http://isitmaintained.com/project/1technophile/openmqttgateway "Percentage of issues still open") -** For Questions or Support please don't open an issue, first go to the [docs](https://docs.openmqttgateway.com) and if you don't find your answer there you could ask someone in [the community forum](https://community.openmqttgateway.com)** - [![](https://github.com/1technophile/OpenMQTTGateway/blob/development/docs/img/OpenMQTTGateway.png)](https://community.openmqttgateway.com) +OpenMQTTGateway project goal is to concentrate in one firmware different technologies and protocols, decreasing by the way the number of physical bridges needed, and hiding the different technologies singularity behind a simple & wide spread communication protocol; MQTT. + ## Documentation The documentation is [here](https://docs.openmqttgateway.com) @@ -22,6 +21,7 @@ The reference sheet, with the list of all functions, pinouts is [here](https://d Download OpenMQTTGateway from the [releases page](https://github.com/1technophile/OpenMQTTGateway/releases) ## Compatible items + * [List of supported devices](https://compatible.openmqttgateway.com/index.php/devices/), door/window sensors, PIR sensors, smoke detectors, weather stations... * [List of compatible boards (Off the shelf or DIY) is available](https://compatible.openmqttgateway.com/index.php/boards/), RF Bridge, IR, BLE gateways... @@ -32,7 +32,11 @@ Download OpenMQTTGateway from the [releases page](https://github.com/1technophil Thanks goes to these wonderful [people](https://github.com/1technophile/OpenMQTTGateway/graphs/contributors) who helped OpenMQTTGateway on Github and to the users contributions into the [community](https://community.openmqttgateway.com/). -## Support/help +## Support + +For Questions or Support please don't open an issue, first go to the [docs](https://docs.openmqttgateway.com) and if you don't find your answer there, you can post your question in [the community forum](https://community.openmqttgateway.com) + +## Help If you like the project and/or used it please consider supporting it! It can be done in different ways: * Helping other users in the [community](https://community.openmqttgateway.com) diff --git a/docs/README.md b/docs/README.md index 54bfc63f..b706b33b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,4 +1,4 @@ -OpenMQTTGateway project goal is to concentrate in one gateway different technologies, decreasing by the way the number of proprietary gateways needed, and hiding the different technologies singularity behind a simple & wide spread communication protocol; [MQTT](http://mqtt.org/). +OpenMQTTGateway project goal is to concentrate in one firmware different technologies and protocols, decreasing by the way the number of physical bridges needed, and hiding the different technologies singularity behind a simple & wide spread communication protocol; [MQTT](http://mqtt.org/). ![Overview](./img/OpenMQTTGateway.png) diff --git a/docs/use/ble.md b/docs/use/ble.md index 0f7154aa..60ee8da4 100644 --- a/docs/use/ble.md +++ b/docs/use/ble.md @@ -1,4 +1,10 @@ # BLE gateway + +::: warning +We strongly encourage the use of a white-list (see below) so as to collect data from your devices only and not from other MAC addresses. +By default the gateway scans the advertizing BLE devices nearby with their MAC addresses. Depending on your country, it may be illegal to monitor networks for MAC addresses, especially on networks that you do not own. Please check your country's laws (for US Section 18 U.S. Code ยง 2511) - [discussion here](https://github.com/schollz/howmanypeoplearearound/issues/4). +::: + ## Receiving signals from BLE beacon devices for Presence detection Subscribe to all the messages with mosquitto or open your MQTT client software: