wl2k-go is a collection of Go packages implementing various parts needed to build a Winlink client.
The project's goal is to encourage and facilitate development of cross-platform Winlink clients.
This project is under heavy development and breaking API changes are to be expected.
On 6 March 2016 the cmd/wl2k application moved to it's own repository.
Check out getpat.io for the latest version of the cross platform Winlink client, Pat.
An implementation of the B2 Forwarding Protocol and Winlink 2000 Message Structure (the WL2K-protocol).
mycall := "LA5NTA"
mbox := mailbox.NewDirHandler("/tmp/mailbox", false)
session := fbb.NewSession(
mycall,
telnet.TargetCall,
"JP20qh",
mbox, // Use /tmp/mailbox as the mailbox for this session
)
// Exchange messages over any connection implementing the net.Conn interface
conn, _ := telnet.Dial(mycall)
session.Exchange(conn)
// Print subjects of messages in the inbox
msgs, _ := mbox.Inbox()
for _, msg := range msgs {
fmt.Printf("Have message: %s\n", msg.Subject())
}
For detailed package documentation, see http://godoc.org/github.com/la5nta/wl2k-go.
A big thanks to paclink-unix by Nicholas S. Castellano N2QZ (and others). Without their effort and choice to share their knowledge through open source code, this implementation would probably never exist.
Paclink-unix was used as reference implementation for the B2F protocol since the start of this project.
Gzip message compression has been added as an experimental B2F extension, as an alternative to LZHUF. The feature can be enabled by setting the environment variable GZIP_EXPERIMENT=1
at runtime.
The protocol extension is negotiated by an additional character (G) in the handshake SID as well as a new proposal code (D), thus making it backwards compatible with software not supporting gzip compression.
The G sid flag tells the other party that gzip is supported through a D-proposal. The D-proposal has the same format as C-proposals, but is used to flag the data as gzip compressed.
The gzip feature works transparently, which means that it will not break protocol if it's unsupported by the other winlink node.
Package lzhuf implements the lzhuf compression used by the binary FBB protocols B, B1 and B2.
For detailed package documentation, see http://godoc.org/github.com/la5nta/wl2k-go/lzhuf.
Package transport provides access to various connected modes commonly used for winlink.
The modes is made available through common interfaces and idioms from the net package, mainly net.Conn and net.Listener.
For detailed package documentation, see http://godoc.org/github.com/la5nta/wl2k-go/transport.
A driver for the ARDOP_WIN and ARDOPc TNCs. Provides dialing and listen capabilities over ARDOP (Amateur Radio Digital Open Protocol).
For detailed package documentation, see http://godoc.org/github.com/la5nta/wl2k-go/mailbox.
mbox := mailbox.NewDirHandler("/tmp/mailbox", false)
session := fbb.NewSession(
"N0CALL",
telnet.TargetCall,
"JP20qh",
mbox,
)
Go bindings for a subset of hamlib. It provides both native cgo bindings and a rigctld client.
Build with -tags libhamlib
to link against libhamlib (the native library).
See http://godoc.org/github.com/la5nta/wl2k-go/rigcontrol/hamlib for more details.
Copyright (c) 2014-2015 Martin Hebnes Pedersen LA5NTA
(See LICENSE)
The JNOS developers for the lzhuf implementation which got ported to Go.
The paclink-unix team (Nicholas S. Castellano N2QZ and others) - reference implementation
Amateur Radio Safety Foundation, Inc. - The Winlink 2000 project
F6FBB Jean-Paul ROUBELAT - the FBB forwarding protocol
wl2k-go is not affiliated with The Winlink Development Team nor the Winlink 2000 project [http://winlink.org].