https://github.com/mark2b/wpa-connect
wpa-connect
https://github.com/mark2b/wpa-connect
go golang raspberry-pi wpa-supplicant
Last synced: 9 months ago
JSON representation
wpa-connect
- Host: GitHub
- URL: https://github.com/mark2b/wpa-connect
- Owner: mark2b
- License: mit
- Created: 2016-12-09T20:13:03.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-04-03T21:03:14.000Z (over 4 years ago)
- Last Synced: 2025-02-01T12:45:29.346Z (over 1 year ago)
- Topics: go, golang, raspberry-pi, wpa-supplicant
- Language: Go
- Homepage:
- Size: 43.9 KB
- Stars: 61
- Watchers: 6
- Forks: 20
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# wpa-connect
## Package provides API for connection Linux device to Wi-Fi Network.
**wpa-connect** communicates with WPA supplicant over D-Bus (linux message bus system).
This package was developed as part of IoT project in order to add Wi-Fi connectivity to headless Raspberry Pi like devices. No need for **connman** or **Network Manager** be installed.
## Setup
**On Linux:**
**wpa_supplicant** service should run with **-u** flag in order to enable DBus interface. Run it as Linux service before first call to **wpa_supplicant**. Otherwise system will start it automatically without **-u** flag.
Systemd service configuration file - **/etc/systemd/system/wpa_supplicant@wlan0.service**
```
[Unit]
Description=WPA supplicant for %i
[Service]
ExecStart=/usr/sbin/wpa_supplicant -u -i%i -c/etc/wpa_supplicant.conf -Dwext
[Install]
WantedBy=multi-user.target
```
**On Raspberry PI OS (Debian Buster):**
**Raspbery PI OS** (formerely known as Raspbian) uses [dhcpd-run-hooks](https://manpages.debian.org/stretch/dhcpcd5/dhcpcd-run-hooks.8.en.html) to setup and invoke the wpa_supplicant daemon.
1. Disable the systemd managed wpa_supplicant located under `/etc/systemd/dbus-fi.w1.wpa_supplicant1.service` by running `sudo systemctl disable wpa_supplicant`
1. Modify the existing wpa_supplicant dhcpd-run-hook available under `/lib/dhcpcd/dhcpcd-hooks/10-wpa_supplicant` by adding the `-u` flag to the invocation of the wpa_supplicant daemon in the `wpa_supplicant_start()` function.
1. Alternatively run `sudo sed -i 's/wpa_supplicant -B/wpa_supplicant -u -B/g' /lib/dhcpcd/dhcpcd-hooks/10-wpa_supplicant` to modify the hook in place.
**On Project:**
```
go get github.com/mark2b/wpa-connect
```
## Usage
Please see [godoc.org](http://godoc.org/wpa-connect) for documentation. (Not ready yet)
## Examples
### Connect to Wi-Fi network
```golang
import wifi "wpa-connect"
if conn, err := wifi.ConnectManager.Connect(ssid, password, time.Second * 60); err == nil {
fmt.Println("Connected", conn.NetInterface, conn.SSID, conn.IP4.String(), conn.IP6.String())
} else {
fmt.Println(err)
}
```
### Scan for Wi-Fi networks
```golang
import wifi "wpa-connect"
if bssList, err := wifi.ScanManager.Scan(); err == nil {
for _, bss := range bssList {
print(bss.SSID, bss.Signal, bss.KeyMgmt)
}
}
```
Package release under a [MIT license](./LICENSE.md).