Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

vscpl1drv-logger - VSCP Level I CAN4VSCP Logger Driver

vscpl1drv-logger is a VSCP level I driver for diagnostic logging. It makes it possible to log (VSCP Level I events to a text file. Several drivers can be loaded logging data to different output files and using different filter/masks.


  • Linux
  • Windows

Driver for Linux**

Driver for Windows


Install location


From version 14.0.0 the driver is installed in /var/lib/vscp/drivers/level1


From version 14.0.0 the driver is installed in /program files/vscpd/drivers/level1

Configuration string






The absolute or relative path including the file name to the file that log data should be written to. The filename is followed by the optional 32-bit filter and mask. The default is all events logged.

Note that the filter/mask looks at the CAN ID. If you work with VSCP look at format of the 29 bit CAN identifier in VSCP Bit 32 is set to one for an extended frame (all VSCP frames) and bit 30 is set to one for RTR frames (never for VSCP).


  • 0 - Append data to an existing file (create it if it's not available).
  • 1 - Create a new file or rewrite an old file with new data.

Status return

The CanalGetStatus call returns the status structure with the channel_status member having the following meaning:

  • 0 is always returned.

Log file format

The log file have the following format and consist of the following parts

  • Time when frame was received
  • Timestamp
  • Flags
  • ID
  • Number of databytes
  • Databytes

Install the driver on Linux

Install Debian package

> sudo apt install ./vscpl2drv-logger_1.1.0-1_amd64.deb

using the latest version from the repositories release section.


sudo make install

use the switch --enable-debug if you want a debug build.

Install the driver on Linux using vscp private repository

Warning !!! Currently this is very much experimental

wget -O - | sudo apt-key add -

then add

deb buster main
deb eoan main

to the file


replace eoan with the os-release you have installed and debian to debian, ubuntu or raspian

Install the driver on Windows

Install using the binary install file in the release section.

How to build the driver on Linux

git clone
cd vscpl1drv-logger
git submodule update --init
make install

Default install folder is /var/lib/vscp/drivers/level1

You need build-essentials and git installed on your system.

sudo apt update && sudo apt -y upgrade
sudo apt install build-essential git

How to build the driver on Windows

The source contains a Visual Studio project. Use this project to build the driver.

There are many Level I drivers (CANAL drivers) available in VSCP & Friends framework that can be used with both VSCP Works and the VSCP Daemon (vscpd) and other tools that interface the drivers using the CANAL standard interface. Added to that many Level II and Level III drivers are available that can be used with the VSCP Daemon.

Level I drivers is documented here.

Level II drivers is documented here

The VSCP project homepage is here

The manual for vscpd contains full documentation. Other documentation can be found on the documentaion portal.

The vscpd source code may be downloaded from Source code for other system components of VSCP & Friends are here

Copyright (C) 2000-2020 Ake Hedman, Grodans Paradis AB - MIT license.