A Python library for LIN (Local Interconnect Network) bus communication via BUSMUST hardware devices.

This package provides a programming interface similar to python-can, making it easy to control LIN buses and send/receive LIN messages using Python.

• LIN Master and Slave mode (Master Write / Master Read / Slave Write)
• Classic and Enhanced checksum support with auto-calculation
• Hardware-periodic transmit tasks (TXTASK) with precise timing
• Pull-up resistor and LIN bus 12V voltage control (output / input)

Download the latest BMAPI SDK and copy the runtime library to a system path:

Note for ARM platforms: The .arm suffix in the SO filename must be removed when copying to system paths (e.g., libbmapi64.arm.so → /usr/local/lib/libbmapi64.so).

export PYTHONPATH=/path/to/python-lin

from lin.interfaces.bmlin import BmLinBus
from lin.message import Message, LIN_MASTER_WRITE

# Create a LIN bus instance (master mode)
bus = BmLinBus(channel=0, bitrate=19200, is_master=True)

# Send a LIN message (master write)
msg = Message(lin_id=0x10, data=[0x01, 0x02, 0x03, 0x04], dlc=4, msgtype=LIN_MASTER_WRITE)
bus.send(msg)

# Receive a LIN message
msg = bus.recv(timeout=1.0)
print(f"Received: ID=0x{msg.lin_id:02X}, Data={list(msg.data)}")

bus.shutdown()

• Python 3.7+
• BUSMUST hardware device with LIN support
• BMAPI runtime library (included in BMAPI SDK)

See the examples/ directory for complete usage examples:

• bmapi_lin_txrx.py — LIN transmit and receive with master/slave mode selection

To bundle your application with PyInstaller, you need to:

1. Include the BMAPI DLL in the package
2. Declare lin.interfaces.bmlin as a hidden import

Example spec file:

from ctypes.util import find_library

# Locate BMAPI DLL from system PATH (or fallback to local file)
dll_path = find_library('bmapi64') or 'BMAPI64.dll'

a = Analysis(
    ['your_app.py'],
    pathex=['/path/to/python-lin'],
    binaries=[(dll_path, '.')],
    hiddenimports=['lin.interfaces.bmlin'],
    # ... other Analysis options
)

Build with:

pyinstaller your_app.spec

At runtime, the DLL is found via the _MEIPASS fallback path inside the bundle.

Alternative: If you don't bundle the DLL, the target machine must have BMAPI installed in the system PATH. In that case, omit the binaries line and rely on find_library() at runtime.

• BMAPI SDK — Complete SDK for BUSMUST devices
• python-can — BUSMUST interface for CAN/CAN FD

For technical support, search for "霸码科技" on WeChat, follow our official account, and click "技术支持" to chat directly with our engineers.

See LICENSE for details. This library is licensed for use exclusively with BUSMUST hardware devices.