shtirlic / go-iwd

go-iwd Go binding for iwd

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

Links

• iwd Project page
• iwd Git repo
• iwd ArchWiki