ipbus

IPbus2.0 client library implemented in go.

The IPbus protocol allows communication with an FPGA via TCP or UDP. The IPbus protocol was originally designed for data acquisition systems for the LHC experiments at CERN. Documentation on the IPbus library can be found at https://svnweb.cern.ch/trac/cactus/wiki/uhalQuickTutorial. The client library allows software to read and write values to IPbus registers in the FPGA target.

The Go implementation was first developed as part of the read-out system of the 288 kg prototype SoLid anti-neutrino detector (http://arxiv.org/abs/1510.07835). The code was then split into a package for use in the full scale SoLid detector.

Installation and usage

Once you have set up your Go work area you can instal the ipbus package with the following command:

go get github.com/go-daq/ipbus

and then use it in your code, such as:

package main

import (
    "github.com/go-daq/ipbus"
    "net"
)

func main()
    conn, err := net.Dial("udp4", "localhost:50001")
    // Handle error...
    fn := "hardwaredescription.xml"
    target := ipbus.New("DAQ", fn, conn)
    fifo := target.Regs["FIFO"]
    repchan := target.Read(fifo, 1024)
    // target.Dispatch() // This would block until all packets are received
    go target.Dispatch() // This lets you handle each packet as it arrives
    for rep := range repchan {
        if rep.Err != nil {
            //handle error
        }
        process(rep.Data)
    }
}

Dependencies

The ipbus package does not depend on any packages outside the go standard library. The package was developed and tested using go version go1.8.1 linux/amd64. It is expected to work with any go1.x.

Fully testing the package requires the C++ IPbus implementation to be installed (see https://svnweb.cern.ch/trac/cactus/wiki/uhalQuickTutorial#HowtoInstalltheIPbusSuite) because tests are run which communicate with the dummy hardware included in that package. Package users do not need to install the C++ library. You can skip all tests that require the dummy hardware with the command:

go test -nodummyhardware

Documentation

The documentation for the ipbus package can be found at:

https://godoc.org/github.com/go-daq/ipbus

License

This software is released under a 3-clause BSD license, see go-daq/license or call ipbus.License(). ipbus was originally released under LICENSE.goipbus.md.

Versions

The current version of the ipbus package is 1.0.0. The version can be accessed as ipbus.PackageVersion.

Logo

The ipbus logo uses the gophercolor image (see https://golang.org/doc/gopher/) designed by Renee French.