https://github.com/flightaware/piaware-ble-connect
Bluetooth Low Energy Service for PiAware SD card images
https://github.com/flightaware/piaware-ble-connect
piaware
Last synced: about 1 month ago
JSON representation
Bluetooth Low Energy Service for PiAware SD card images
- Host: GitHub
- URL: https://github.com/flightaware/piaware-ble-connect
- Owner: flightaware
- License: bsd-2-clause
- Created: 2021-12-07T19:33:20.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-06-24T16:28:20.000Z (about 1 year ago)
- Last Synced: 2025-06-24T17:39:17.294Z (about 1 year ago)
- Topics: piaware
- Language: Python
- Homepage:
- Size: 60.5 KB
- Stars: 1
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# piaware-ble-connect
piaware-ble-connect is a Bluetooth Low Energy (BLE) service that runs on PiAware 7+ SD card images. This service allows you to connect to your receiver and configure WiFi from the [FlightAware website](https://flightaware.com/adsb/piaware/build/configure) on a supported Web browser or the FlightAware iOS app. It makes requests to [piaware-configurator](https://github.com/flightaware/piaware-configurator) to configure the WiFi settings.
## Details
- piaware-ble-connect will allow your PiAware to be discoverable over BLE if 1) your PiAware cannot connect to the Internet AND 2) your
PiAware is unclaimed. If these two conditions are met, BLE discovery is disabled. It will remain disabled on all subsequent reboots unless PiAware cannot connect to the Internet for some reason, in which case BLE pairing will be re-enabled to allow for reconfiguration.
- piaware-ble-connect will remain active for a maximum of 15 minutes before shutting down. You must reboot to re-enable the BLE services.
- To disable BLE setup completely, you can set the `allow-ble-setup` piaware-config setting to `no` and reboot.
- BLE setup is disabled automatically if PiAware is connected to Ethernet
- BLE setup is disabled automatically if you've configured WiFi manually (i.e. via piaware-config). The idea is if you configured it manually before, you should be able to configure it again. You can override this behavior by setting `allow-ble-setup` to `yes` to enable BLE setup when needed.
## allow-ble-setup
This piaware-config setting allows you to enable/disable the piaware-ble-connect service at boot up.
`auto` - Default setting on new SD cards. If set to `auto` and WiFi has not been configured, piaware-ble-connect will be enabled to allow for configuration. If set to `auto` and WiFi has been configured via other means (e.g piaware-config), BLE will be disabled. You should continue to use the method you previously used to set WiFi. If WiFi has been set up via BLE, `allow-ble-setup` will be set to yes to allow future configuration.
`yes` - BLE will always be enabled and check whether PiAware needs to be discoverable for configuration over BLE
`no` - Disables piaware-ble-connect service