Device driver for EDGEPLANT USB Peripherals

About

EDGEPLANT USB peripheral device driver under Linux allows you to receive and send data with the following products.

• EDGEPLANT CAN-USB Interface
• EDGEPLANT CAN FD USB Interface
• EDGEPLANT ANALOG-USB Interface

For more information about EDGEPLANT Peripherals, please visit https://www.aptpod.co.jp/products/edgeplant/edgeplant-peripherals .

Getting started

Prerequisites

To build this device driver, the following packages are required.

• GNU C
• GNU make
• Linux headers (kernel v4.4 and above)

To use this device driver, the following kernel configurations are required.

• SocketCAN
  • CONFIG_NET
  • CONFIG_CAN
  • CONFIG_CAN_DEV
• IIO
  • CONFIG_IIO
  • CONFIG_IIO_BUFFER
  • CONFIG_IIO_KFIFO_BUF

Installation

Installing from a deb package using DKMS

1. Configure aptpod's public repository.
   In the ${DISTRIBUTION} part of the command, specify either ubuntu or debian, depending on your environment.

   sudo apt-get update
   sudo apt-get install -y \
      apt-transport-https \
      ca-certificates \
      curl \
      gnupg-agent \
      lsb-release
   sudo mkdir -p /etc/apt/keyrings
   curl -fsSL https://repository.aptpod.jp/intdash-edge/linux/${DISTRIBUTION}/gpg | \
      sudo gpg --dearmor -o /etc/apt/keyrings/intdash-edge.gpg
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/intdash-edge.gpg] \
      https://repository.aptpod.jp/intdash-edge/linux/${DISTRIBUTION} $(lsb_release -cs) \
      stable" \
      | sudo tee /etc/apt/sources.list.d/intdash-edge.list
   sudo apt-get update

2. Install apt-usbtrx-dkms package.

   sudo apt-get install apt-usbtrx-dkms

3. Load the module.

   sudo modprobe apt_usbtrx

With DKMS, the driver will be automatically rebuilt when the kernel is updated.

Installing by building from source

1. Clone this repository.

   git clone https://github.com/aptpod/apt-peripheral-linux-driver

2. Build the device driver and tools.

   make all

3. Install the device driver and tools.

   sudo make install
   sudo modprobe apt_usbtrx

   By default, the tools will be installed in /usr/local/bin. You can set the installation directory by using the DESTDIR variable.

   mkdir -p /path/to/dir/bin
   make DESTDIR=/path/to/dir install

Running the unit tests

This project uses KUnit for unit testing. If you want to run the unit tests, execute the following script.

cd kunit && ./run_test.sh

Usage

For information on how to use the peripheral devices, see docs.

License

Distributed under the GPL v2.0 License. See LICENSE for more information.

Contact

https://www.aptpod.co.jp/contact/