1. Package installation

$ pip install xcom485i

2. Hardware installation

• Connect your Xcom-485i (Studer side) to your installation using the cable provided with the device

• Connect your Xcom-485i (External side) to your controller (personal computer, Raspberry Pi, etc.) using a USB to RS-485 adapter

• Please refer to the Xcom-485i manual for more information about commissioning the device

3. Serial configuration

This package rely on pyserial standard package, in order to use the xcom485i package make sure to instantiate it like :

import serial

serial_port = serial.Serial(SERIAL_PORT_NAME, SERIAL_PORT_BAUDRATE, parity=serial.PARITY_EVEN, timeout=1)

• where SERIAL_PORT_NAME is your serial port interface, for example set it to ‘COM4’ (string argument) when using Windows otherwise you may set it to ‘/dev/ttyUSB0/’ on Linux

• where SERIAL_PORT_BAUDRATE is the baudrate used by your serial port interface (must be set to 9600, 19200, 38400 or 115200 according to Xcom-485i dip-switches)

Xcom-485i Dip switches baud rate selection

4. Address offset

Set the modbus offset corresponding to the internal dip-switches of your Xcom-485i device, it must be set to 0, 32, 64 or 128.

It is done when instantiate the Xcom485i class like :

xcom485i = Xcom485i(serial_port, OFFSET, debug=True)

• where serial_port is the previously created object with Serial

• where OFFSET is your actual modbus address offset set by the dip-switches inside your Xcom-485i

• where debug enables you to get some useful console information for debugging purpose

Xcom-485i Dip switches address offset selection

5. Run an example from /examples folder

Go to /examples folder with a terminal and execute this script

$ python ex_read_info.py

Check client file to understand it.

6. Open documentation

Open documentation from Read The Docs