Skip to content

shtirlic/go-iwd

Repository files navigation

go-iwd Go binding for iwd

go-iwd is a Go D-BUS binding for iNet Wireless Daemon iwd API.

Note

Please keep in mind that project is under active development.

Getting started

Prerequisites

go-iwd requires Go version 1.22 or above.

Getting go-iwd

With Go's module support, go [build|run|test] automatically fetches the necessary dependencies when you add the import in your code:

import "github.com/shtirlic/go-iwd"

Alternatively, use go get:

go get -u github.com/shtirlic/go-iwd

Usage

func main() {
  i, err := iwd.NewIwd()
  if err != nil {
    panic(err)
  }
  defer i.Close()

  // Get iwd Stations
  stations, err := i.Stations()
  if err != nil {
    panic(err)
  }

  // Disconnect from network
  for _, station := range stations {
    station.Disconnect()
  }

  // Connect to Known Network
  for _, station := range stations {
    if station.State == iwd.ConnectedState {
      return
    }
    nets, _ := station.GetOrderedNetworks()
    for _, net := range nets {
      net.Connect()
    }
  }

  // Output iwd Station diagnostic info
  fmt.Println(station[0].GetDiagnostics())
}

Examples

A number of ready-to-run examples demonstrating various use cases of go-iwd are available in the go-iwd examples dir.

Features

  • Minimal dependencies
  • Easy API access
  • Full API support + Experimental iwd API
  • TUI Client
  • API Tests

IWD API

  • Adapter
  • Daemon
  • Device
  • KnowNetwork
  • Network
  • Station
  • Station Diagnostic
  • WSC
  • Access Point
  • Adhoc
  • Agent
  • Device Provisioning
  • RadioManager
  • RuleManager
  • P2P (peer, service)
  • Station Debug
  • IWD specific error handling
  • D-BUS Signals

iwd Architecture

iwd Architecture

Links