Skip to main content

Python LIN Slave Simulation Program

Building the Runtime Environment​

Ubuntu/Debian-based systems reject direct installation of packages into the Python environment.
As one way to build the sample program runtime environment, this section describes creating a virtual environment with venv and installing the package there.

Perform the following steps with the virtual environment enabled.

  1. Change the current directory to the directory that contains the source code.
  2. Run Python3 setup.py build to build the Python wrapper sample.
  3. Run Python3 -m pip install . to install the Python wrapper sample built in step 2.

After installation, run mpx_lin_slvsample.py to start the sample program.
If User Write Permission Settings have not been performed, specify the Python executable in the virtual environment.

Operation Specifications​

ItemDescription
CH1Operates in slave simulation mode.
When a header with a specified ID is received, sends the response for that ID (for the specified IDs and response contents, see Response ID List).
Also calls MPXGetLog every 10 ms to obtain logs and displays them in the console.
CH2Not used

Response ID List​

The response ID list contents are as follows.

IDDLData (Hex)
D1D2D3D4D5D6D7D8
12H234HBCH
34H880H91HA2HB3HC4HD5HE6HF7H

Log Display Details​

ItemDescription
TIMEDisplays the timestamp.
DIRDisplays the log direction.
Rx: receive log / Tx: transmit log
TYPEDisplays the log type.
IDDisplays the LIN ID (hexadecimal).
SBLDisplays the SyncBreak width.
DLDisplays the data length (0 to 64).
DATADisplays data (D1 to D64) in hexadecimal. Data bytes are separated by spaces.
CSDisplays the checksum in hexadecimal.
WPLDisplays the wakeup pulse width.

Sample Source Code​

Source: MPXCtrl_LIN_SlvSample/mpx_lin_slvsample.py

import MPX_ADL_WR

import threading
import time

stop_event = threading.Event()

#read thread
def read_exec():
while not stop_event.is_set():
ret = MPX_ADL_WR.DispMonitor(serial, 1)
if not ret is None:
for i in range(ret[0]):
if ret[1 + i][4] == 'Header':
print('TIME:' + str(ret[1 + i][0]) + '[ms] ' + str(ret[1 + i][1]) + '[us]' +
' DIR:' + ret[1 + i][3] +
' TYPE:' + ret[1 + i][4] +
' ID:' + hex(ret[1 + i][5]) +
' SBL:' + str(ret[1 + i][6]) + '[bit]')
elif ret[1 + i][4] == 'Response':
data = ret[1 + i][8]
data_text = '\\'.join(hex(b) for b in data)
print('TIME:' + str(ret[1 + i][0]) + '[ms] ' + str(ret[1 + i][1]) + '[us]' +
' DIR:' + ret[1 + i][3] +
' TYPE:' + ret[1 + i][4] +
' ID:' + hex(ret[1 + i][5]) +
' DL:' + str(ret[1 + i][7]) +
' DATA:' + data_text +
' CS:' + hex(ret[1 + i][9]))
elif ret[1 + i][4] == 'Wakeup':
print('TIME:' + str(ret[1 + i][0]) + '[ms] ' + str(ret[1 + i][1]) + '[us]' +
' DIR:' + ret[1 + i][3] +
' TYPE:' + ret[1 + i][4] +
' ID:' + hex(ret[1 + i][5]) +
' WPL:' + str(ret[1 + i][10]) + '[ms]')
elif ret[1 + i][4] == 'Sleep':
data = ret[1 + i][8]
data_text = '\\'.join(hex(b) for b in data)
print('TIME:' + str(ret[1 + i][0]) + '[ms] ' + str(ret[1 + i][1]) + '[us]' +
' DIR:' + ret[1 + i][3] +
' TYPE:' + ret[1 + i][4] +
' ID:' + hex(ret[1 + i][5]) +
' DL:' + str(ret[1 + i][7]) +
' DATA:' + data_text +
' CS:' + hex(ret[1 + i][9]))
else:
print('TIME:' + str(ret[1 + i][0]) + '[ms] ' + str(ret[1 + i][1]) + '[us]' +
' TYPE:' + ret[1 + i][4])
pass
time.sleep(0.01)

ret = MPX_ADL_WR.MPXOpen()
if ret[0] != 0:
print('MPXOpen Error:' + str(ret[0]))

print('Serial No.')
for i in range(ret[1]):
print(' ' + str(ret[2][i]))

serial = ret[2][0]

print('MPX LIN INIT.')
ret = MPX_ADL_WR.MPXSampleLINInit(serial, 3)
if ret != 0:
print('LIN INIT error:' + str(ret))

print('MPX LIN Slave Set Simulation.')
ret = MPX_ADL_WR.MPXSampleLINSetSlaveSim(serial)
if ret != 0:
print('LIN Slave Set Simulation error:' + str(ret))

print('MPX MonitorStart.')
ret = MPX_ADL_WR.MPXMonitorStart(serial)

print('Start ReadThread...')
read_thread = threading.Thread(target = read_exec)
read_thread.start()

print('Monitoring...')
time.sleep(20.0) # メインスレッドだけ20秒待つ。read_threadは動き続ける

stop_event.set()
read_thread.join(timeout = 2.0)

ret = MPX_ADL_WR.MPXMonitorStop(serial)
if ret[0] != 0:
print('MonitorStop :Error' + str(ret[0]))
else:
print('MonitorStop :Time' + str(ret[1]) + '[ms]' + str(ret[2]) + '[us]')

ret = MPX_ADL_WR.MPXClose()

This source code performs the following processing flow.

  1. Open Device
  • MPXOpen() searches for MicroPeckerX devices and obtains the serial number.
  1. Initialize Device
  • MPXSampleLINInit() initializes the MicroPeckerX device with the obtained serial number.
  1. Configure Slave Simulation
  • MPXSampleLINSetSlaveSim() configures slave simulation responses.
  1. Start Monitoring
  • MPXMonitorStart() starts monitoring. This also starts transmission of the responses configured in step 3.
  1. Start Monitor Thread
  • Starts the thread that runs read_exec(), which periodically obtains logs with DispMonintor().
  1. Stop Monitor Thread
  • Sets stop_event and terminates the thread that runs read_exec().
  1. Stop Monitoring
  • MPXMonitorStop() stops monitoring. This also stops transmission of the responses configured in step 3.
  1. Close Device
  • MPXClose() closes the MicroPeckerX device with the obtained serial number.