https://github.com/bluenviron/gomavlib
Mavlink library (2.0 and 1.0) for the Go programming language
https://github.com/bluenviron/gomavlib
go golang golang-library mavlink mavlink-library mavlink-protocol mavlink-proxy quadcopter uav ugv
Last synced: 5 months ago
JSON representation
Mavlink library (2.0 and 1.0) for the Go programming language
- Host: GitHub
- URL: https://github.com/bluenviron/gomavlib
- Owner: bluenviron
- License: mit
- Created: 2019-03-12T16:05:15.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-05-15T05:09:56.000Z (5 months ago)
- Last Synced: 2025-05-15T06:23:04.397Z (5 months ago)
- Topics: go, golang, golang-library, mavlink, mavlink-library, mavlink-protocol, mavlink-proxy, quadcopter, uav, ugv
- Language: Go
- Homepage:
- Size: 8.58 MB
- Stars: 145
- Watchers: 4
- Forks: 44
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tinygo - gomavlib - Mavlink protocol (2.0 and 1.0) implementation in Go for control and instrumentation of autonomous vehicles. (Embedded Systems / Protocol implementations)
README
# gomavlib
[](https://github.com/bluenviron/gomavlib/actions/workflows/test.yml)
[](https://github.com/bluenviron/gomavlib/actions/workflows/lint.yml)
[](https://github.com/bluenviron/gomavlib/actions/workflows/dialects.yml)
[](https://goreportcard.com/report/github.com/bluenviron/gomavlib)
[](https://app.codecov.io/gh/bluenviron/gomavlib/tree/main)
[](https://pkg.go.dev/github.com/bluenviron/gomavlib/v3#pkg-index)
gomavlib is a library that implements the Mavlink protocol (2.0 and 1.0) in the Go programming language. It can interact with Mavlink-capable devices through a serial port, UDP, TCP or a custom transport, and it can be used to power UGVs, UAVs, ground stations, monitoring systems or routers.
Mavlink is a lightweight and transport-independent protocol that is mostly used to communicate with unmanned ground vehicles (UGV) and unmanned aerial vehicles (UAV, drones, quadcopters, multirotors). It is supported by the most popular open-source flight controllers (Ardupilot and PX4).
This library powers the [**mavp2p**](https://github.com/bluenviron/mavp2p) router.
Features:
* Create Mavlink nodes able to communicate with other nodes.
* Supported transports: serial, UDP (server, client or broadcast mode), TCP (server or client mode), custom reader/writer.
* Emit heartbeats automatically.
* Send automatic stream requests to Ardupilot devices (disabled by default).
* Use both domain names and IPs.
* Decode and encode Mavlink v2.0 and v1.0.
* Compute and validate checksums.
* Support all v2 features: empty-byte truncation, signatures, message extensions.
* Use dialects in multiple ways.
* Ready-to-use standard dialects are available in directory `dialects/`.
* Custom dialects can be defined. Aa dialect generator is available in order to convert XML definitions into their Go representation.
* Use no dialect at all. Messages can be routed without having their content decoded.
* Read and write telemetry logs (tlog)
## Table of contents
* [Installation](#installation)
* [Examples](#examples)
* [API Documentation](#api-documentation)
* [Dialect generation](#dialect-generation)
* [Specifications](#specifications)
* [Links](#links)
## Installation
1. Install Go ≥ 1.21.
2. Create an empty folder, open a terminal in it and initialize the Go modules system:
```
go mod init main
```
3. Download one of the [example files](#examples) and place it in the folder.
4. Compile and run:
```
go run name-of-the-go-file.go
```
## Examples
* [node-endpoint-serial](examples/node-endpoint-serial/main.go)
* [node-endpoint-udp-server](examples/node-endpoint-udp-server/main.go)
* [node-endpoint-udp-client](examples/node-endpoint-udp-client/main.go)
* [node-endpoint-udp-broadcast](examples/node-endpoint-udp-broadcast/main.go)
* [node-endpoint-tcp-server](examples/node-endpoint-tcp-server/main.go)
* [node-endpoint-tcp-client](examples/node-endpoint-tcp-client/main.go)
* [node-endpoint-custom](examples/node-endpoint-custom/main.go)
* [node-message-read](examples/node-message-read/main.go)
* [node-message-write](examples/node-message-write/main.go)
* [node-signature](examples/node-signature/main.go)
* [node-dialect-absent](examples/node-dialect-absent/main.go)
* [node-dialect-custom](examples/node-dialect-custom/main.go)
* [node-events](examples/node-events/main.go)
* [node-router](examples/node-router/main.go)
* [node-router-edit](examples/node-router-edit/main.go)
* [node-serial-to-json](examples/node-serial-to-json/main.go)
* [node-stream-requests](examples/node-stream-requests/main.go)
* [frame-read-writer](examples/frame-read-writer/main.go)
* [telemetry-log](examples/telemetry-log/main.go)
## API Documentation
[Click to open the API Documentation](https://pkg.go.dev/github.com/bluenviron/gomavlib/v3#pkg-index)
## Dialect generation
Standard dialects are provided in the `pkg/dialects/` folder, but it's also possible to use custom dialects, that can be converted into Go files by running:
```
go install github.com/bluenviron/gomavlib/v3/cmd/dialect-import@latest
dialect-import my_dialect.xml
```
## Specifications
|name|area|
|----|----|
|[main website](https://mavlink.io/en/)|protocol|
|[packet format](https://mavlink.io/en/guide/serialization.html)|protocol|
|[common dialect](https://github.com/mavlink/mavlink/blob/master/message_definitions/v1.0/common.xml)|dialects|
|[Golang project layout](https://github.com/golang-standards/project-layout)|project layout|
## Links
Related projects
* [mavp2p](https://github.com/bluenviron/mavp2p)
Other Go libraries
* [gobot](https://github.com/hybridgroup/gobot/tree/master/platforms/mavlink)
* [liamstask/go-mavlink](https://github.com/liamstask/go-mavlink)
* [ungerik/go-mavlink](https://github.com/ungerik/go-mavlink)
* [SpaceLeap/go-mavlink](https://github.com/SpaceLeap/go-mavlink)
* [MAVSDK-Go](https://github.com/mavlink/MAVSDK-Go)
Other non-Go libraries
* [official library (C)](https://github.com/mavlink/c_library_v2)
* [pymavlink (Python)](https://github.com/ArduPilot/pymavlink)
* [mavlink.net (C#)](https://github.com/asvol/mavlink.net)
* [rust-mavlink (Rust)](https://github.com/3drobotics/rust-mavlink)
* [node-mavlink (JS)](https://github.com/omcaree/node-mavlink)