https://github.com/muka/pi-wifi
Simple WIFI setup over network manager
https://github.com/muka/pi-wifi
first-boot network-manager raspberry-pi wifi-setup
Last synced: 16 days ago
JSON representation
Simple WIFI setup over network manager
- Host: GitHub
- URL: https://github.com/muka/pi-wifi
- Owner: muka
- License: apache-2.0
- Created: 2020-08-15T19:44:24.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-11-05T06:20:02.000Z (over 4 years ago)
- Last Synced: 2025-02-25T13:56:14.999Z (3 months ago)
- Topics: first-boot, network-manager, raspberry-pi, wifi-setup
- Language: Go
- Homepage:
- Size: 88.9 KB
- Stars: 18
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pi-wifi
Simple WIFI setup over bluetooth
This servie uses network manager API to connect to a WIFI network.
The implementation offers two interfaces
- a bluetooth service
- a rest API for local(host) usage by other services
## Example
You can use `go run main.go` on a linux machine to start the software.
Then point your browser to http://localhost:9099/ to see an example usage.
## Implementation
### Bluetooth
The BLE server exposes one service `12342233-0000-1000-8000-00805f9b34fb` with two characteristics
1. `0x3344` that supports
- read - return the connectivity status as enum with values connected, limited, unknown, disconnected
- write - accept a UTF8 string in the format WIFI:T:WPA;S:;P:;H:false; (if ssid or password contains : or ; they must be backslashed eg \;
2. `0x4455` that support read and list the available APs the wifi device found. The response is in the format `SSID;strength\n` a double \n indicates the end of the list
### HTTP API
The service exposes also an HTTP API to intereact with WIFI connections
- `/connect` connect to a WIFI connection. Expects a body in the format `{ "payload": "WIFI:T:WPA;S:your ssid;P:your password;H:false;;" }`
- `/status` return the connection status with format `{"status": "connected"}`
- `/listap` list the reachable APs in format `{"accessPoints": [ { "ssid": "example", "strength": 54 } ]}`
The connection string format is based on https://github.com/zxing/zxing/wiki/Barcode-Contents#wi-fi-network-config-android-ios-11