README.md

go-multicam

Go language wrapper for the Euresys MultiCam SDK.

https://documentation.euresys.com/Products/MULTICAM/MULTICAM/Content/00_Home/home.htm

This package currently only works on Linux platforms.

How To Use

package main

import (
	"fmt"

	mc "github.com/northvolt/go-multicam"
)

func main() {
	if err := mc.OpenDriver(); err != nil {
		fmt.Println(err)
		return
	}
	defer mc.CloseDriver()

	fmt.Println("Driver was opened...")

	bc, err := mc.GetParamInt(mc.ConfigurationHandle, mc.BoardCountParam)
	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println("Number of boards detected:", bc)

	for i := 0; i < bc; i++ {
		brd := mc.BoardForIndex(i)
		bn, err := brd.GetParamStr(mc.BoardNameParam)
		if err != nil {
			fmt.Println(err)
			return
		}

		fmt.Println("Board", i, "name:", bn)
	}

	fmt.Println("Done.")
}

Installing

To use it you must obtain a copy of the Euresys MultiCam SDK for Linux from Euresys directly. See:

https://euresys.com/en/Support/Download-area

The Euresys drivers for the board that you want to use must be installed on the Linux host operating system.

Using with Docker

Download the latest Euresys SDK file, e.g. multicam-linux-x86_64-6.18.3.4935.tar.gz and put it into a directory named multicam-linux in this project. Note that this file will not be saved into the Github repo, you must download it yourself.

Once you have obtained the file, you can build the Docker image by running:

docker build -t multicam:latest .

If you are using a different version of the Multicam SDK, you can use the MULTICAM_RELEASE build argument like this::

docker build --build-arg MULTICAM_RELEASE=6.18.2.4781 -t multicam:latest .

Once you have built it, you can run it like this:

docker run --privileged multicam:latest

You should see output like this:

Driver was opened...
Boards detected: 2
FULL_XR_3489
FULL_XR_929
Done.

You can copy the compiled binary executables out of the container, and run them directly on host computers that are running Linux and have the correct Euresys drivers installed.

mkdir -p ./build
docker run -it -v $(pwd)/build:/hostbuild -t multicam:latest /bin/bash -c "cp /build/* /hostbuild/"

Updating generated files

You can update the files out of the container so that you can update based on changes to params or status codes.

docker run -it -v $(pwd):/hostsrc -t multicam:latest /bin/bash -c "cp /src/github.com/northvolt/go-multicam/*_string.go /hostsrc/"

Why it exists

Computer vision applications written in Go can easily take advantage of multi-core concurrency while also having access to packages such as GoCV (https://gocv.io). The go-multicam package now makes is possible for Go programs to connect to Euresys cameras and line scanners that are commonly used for industrial applications.