tscan.lib 1.5.2

Python bindings for the TOSUN TSCAN API

tscan.lib

tscan.lib provides Python bindings for the TOSUN TSCAN API. The Python import package remains libTSCANAPI for compatibility with existing applications.

Requirements

• Python 3.6 or newer.
• Windows x86, Windows x64, or Linux x64.
• A supported TOSUN TSCAN device.

Installation

Install the package with pip:

python -m pip install tscan.lib

For offline environments, install the package file provided by TOSUN:

python -m pip install <package-file>

Basic Usage

from ctypes import c_int32

from libTSCANAPI import finalize_lib_tscan, initialize_lib_tscan, tscan_scan_devices

initialize_lib_tscan(True, True, False)

device_count = c_int32(0)
result = tscan_scan_devices(device_count)
print("scan result:", result)
print("device count:", device_count.value)

finalize_lib_tscan()

Platform Notes

• Windows supports the core TSCAN APIs and BLF APIs.
• Linux supports the core TSCAN APIs. BLF APIs are disabled on Linux and return a controlled unavailable result.
• If Linux device connection returns a permission error, install the udev rule from libTSCANAPI/rules/99-tosun.rules.

Optional Integrations

To use the libtosun interface through python-can, set IS_ADD_PYTHON_CAN in libTSCANAPI/config.py to True, then import libTSCANAPI once.

To enable TOSUN-specific DBC parsing for automatic CAN and CAN FD message creation, set IS_ADD_CANTOOLS in libTSCANAPI/config.py to True, then import libTSCANAPI once.

Keep both options disabled unless the integration is required by your application.