https://github.com/maltegrosse/go-modemmanager

A Go wrapper around ModemManager's D-Bus API
https://github.com/maltegrosse/go-modemmanager

dbus golang gsm modem-manager modemmanager

Last synced: 6 months ago
JSON representation

A Go wrapper around ModemManager's D-Bus API

• Host: GitHub
• URL: https://github.com/maltegrosse/go-modemmanager
• Owner: maltegrosse
• License: other
• Created: 2020-04-01T19:37:43.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2025-03-29T02:36:32.000Z (7 months ago)
• Last Synced: 2025-04-14T14:15:50.265Z (6 months ago)
• Topics: dbus, golang, gsm, modem-manager, modemmanager
• Language: Go
• Size: 219 KB
• Stars: 40
• Watchers: 1
• Forks: 22
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Alt Go-ModemManager](./go-modemmanager.png)

[![GoDoc](https://godoc.org/github.com/maltegrosse/go-modemmanager?status.svg)](https://pkg.go.dev/github.com/maltegrosse/go-modemmanager)

[![License](http://img.shields.io/:license-mit-blue.svg?style=flat-square)](http://badges.mit-license.org)

![Go](https://github.com/maltegrosse/go-modemmanager/workflows/Go/badge.svg) 

[![Go Report Card](https://goreportcard.com/badge/github.com/maltegrosse/go-modemmanager)](https://goreportcard.com/report/github.com/maltegrosse/go-modemmanager)

Go D-Bus bindings for ModemManager

Additional information: [ModemManager D-Bus Specs](https://www.freedesktop.org/software/ModemManager/api/1.12.0/ref-dbus.html)

Tested with [ModemManager - Version 1.12.8](https://gitlab.freedesktop.org/mobile-broadband/ModemManager), Go 1.13, on `Debian Buster (armv7)` with `Kernel 5.4.x` and `libqmi 1.24.6`.

Test hardware: [SolidRun Hummingboard Edge](https://www.solid-run.com/nxp-family/hummingboard/)   and a `Quectel EC25 - EC25EFA` mini pcie modem.

## Notes

 ModemManager works great together with GeoClue. A dbus wrapper can be found [here](https://github.com/maltegrosse/go-geoclue2).

A NetworkManager dbus wrapper in golang can be found [here](https://github.com/Wifx/gonetworkmanager).

## Status

Some methods/properties are untested as they are not supported by my modem/lack of how to use them. See `todo` tags in the code.

## Installation

This packages requires Go 1.13 (for the dbus lib). If you installed it and set up your GOPATH, just run:

`go get -u github.com/maltegrosse/go-modemmanager`

## Usage

You can find some examples in the [examples](examples) directory.

## Limitations

Not all interfaces, methods and properties are supported in QMI or AT mode. In addition, not all methods and properties are supported by every modem.

A brief overview of the availability of each interface by using Quectel EC-25:

| Interface     | QMI   | AT    |

|---------------|-------|-------|

| ModemManager1 | true  | true  |

| Modem         | true  | true  |

| Simple        | true  | true  |

| Modem3gpp     | true  | true  |

| Ussd          | false | true  |

| ModemCdma     | false | false |

| Messaging     | true  | false |

| Location      | true  | true  |

| Time          | true  | true  |

| Firmware      | true  | true  |

| Signal        | true  | false |

| Oma           | false | false |

| Bearer        | true  | true  |

| Sim           | true  | true  |

| SMS           | true  | true  |

| Call          | true  | true  |

## License

**[MIT license](http://opensource.org/licenses/mit-license.php)**

Copyright 2020 © Malte Grosse.

Other:

- [ModemManager Logo under GPLv2+](https://gitlab.freedesktop.org/mobile-broadband/ModemManager/-/tree/master/data)

- [GoLang Logo under Creative Commons Attribution 3.0](https://blog.golang.org/go-brand)