Skip to content

usage.md

Latest commit

 

History

History
81 lines (56 loc) · 1.89 KB

usage.md

File metadata and controls

81 lines (56 loc) · 1.89 KB

Usage Guide

Basic Initialization

from xkc_kl200_python import XKC_KL200

sensor = XKC_KL200(port="/dev/serial0", baudrate=9600)

The default connection settings are:

  • Baud rate: 9600
  • Timeout: 1.0 second
  • Address: 0xFFFF

On Raspberry Pi, /dev/serial0 is the recommended UART device in most setups. If you use a USB serial adapter instead, the device will often be something like /dev/ttyUSB0.

Before using the library on a Pi:

  • enable the hardware UART
  • disable the Linux serial console on that UART
  • ensure the sensor is in UART communication mode
  • verify the sensor UART electrical level is compatible with the Pi 3.3V UART
  • wire TX -> RX, RX -> TX, and GND -> GND

Manual Distance Read

from xkc_kl200_python import XKC_KL200

with XKC_KL200(port="/dev/serial0", baudrate=9600) as sensor:
    print(sensor.read_distance())

Looping In Your App

import time

from xkc_kl200_python import XKC_KL200, XKC_KL200_ReadError

with XKC_KL200(port="/dev/serial0", baudrate=9600) as sensor:
    while True:
        try:
            print(sensor.read_distance())
        except XKC_KL200_ReadError:
            print("Read failed")
        time.sleep(0.1)

read_distance() always sends a measurement request and waits for the matching response frame. If that fresh read fails, it raises instead of returning cached data. If you want repeated readings, keep the loop in your own code.

This library intentionally does not expose an upload mode. The goal is to keep the UART contract predictable and easy to debug: one command, one response, one parsed measurement. Repeated reads stay in application code rather than inside the library.

Configuration Commands

The library exposes helpers for:

  • change_address
  • change_baud_rate
  • set_led_mode
  • set_relay_mode
  • set_communication_mode
  • hard_reset
  • soft_reset