HC05 / XBee First Steps

python3 ch05.py /dev/ttyACM1

Opening port:  /dev/ttyACM1
Entering into AT mode
Sending AT... (checking if AT is enabled)
Response:  ['ERROR:(0)']
AT+VERSION? ['+VERSION:2.0-20100601', 'OK']
device MAC XX:XX:XX:XX:XX:XX
AT+NAME?: [device name] H-C-2010-06-01
AT+ROLE?: [role, 0=Slave, 1=Master] ['+ROLE:0', 'OK']
AT+ADCN?:  ['+ADCN:7', 'OK']
AT+MRAD? [connected device mac]:  XX:XX:XX:XX:XX:XX
Pair to the device: H-C-2010-06-01 with password 1234
Waiting until is paired
Sending and receiving messages, press CTRL+C to stop
Creating background receiving thread
Sending ping 0
Sending ping 1
Sending ping 2
Sending ping 3

import serial
import threading
import argparse
import time
from typing import List

keep_reading = True

def read_serial(ser: serial.Serial):
    while keep_reading:
        if ser.in_waiting > 0:
            waiting = ser.in_waiting
            line = ser.read(waiting).decode("utf-8").strip()
            print("Serial Input: ", line)

def send_at_command(ser: serial.Serial, command: str) -> List[str]:
    # send command
    ser.write(f"{command}\r\n".encode("ascii"))
    # read command back
    data = []
    while True:
        line = ser.readline().decode("ascii").strip()
        data.append(line)
        if line == "OK" or "ERROR" in line:
            break

    return data

def clean_mac_response(mac: str) -> str:
    # first part is always from response
    mac = mac.split(":")[1:]
    # make a single string
    mac = "".join(mac)

    # split into groups of 2 values
    mac = [mac[i:i+2] for i in range(0, len(mac), 2)]

    return ":".join(mac)

parser = argparse.ArgumentParser(prog="HC05 Uart Example")
parser.add_argument(
    "serial_port", 
    help="Serial port like /dev/ttyACM0",
)
args = parser.parse_args()

params = {
    "port": args.serial_port,
    "baudrate": 38400,
    "bytesize": serial.EIGHTBITS, 
    "parity": serial.PARITY_NONE, 
    "stopbits": serial.STOPBITS_ONE, 
    "timeout": 1,
}

print("Opening port: ", args.serial_port)
with serial.Serial(**params) as ser:
    print("Entering into AT mode")
    # this will set RTS=3.3v 
    ser.rts = False
    time.sleep(0.1)

    print("Sending AT... (checking if AT is enabled)")
    print("Response: ", send_at_command(ser, "AT..."))
    print("AT+VERSION?", send_at_command(ser, "AT+VERSION?"))

    mac = send_at_command(ser, "AT+ADDR?")[0]
    if "ERROR" not in mac:
        print("device MAC", clean_mac_response(mac))

    device_name = send_at_command(ser, "AT+NAME?")[0].replace("+NAME:", "")
    print("AT+NAME?: [device name]", device_name)
    print("AT+ROLE?: [role, 0=Slave, 1=Master]", send_at_command(ser, "AT+ROLE?"))
    print("AT+ADCN?: ", send_at_command(ser, "AT+ADCN?"))

    mac = send_at_command(ser, "AT+MRAD?")[0]
    if "ERROR" not in mac:
        print("AT+MRAD? [connected device mac]: ", clean_mac_response(mac))

    # wait until is paired
    print(f"Pair to the device: {device_name} with password 1234")
    print("Waiting until is paired")
    while True:
        state = send_at_command(ser, "AT+STATE?")[0]
        if state == "OK" or state == "+STATE:PAIRED" or state == "+STATE:CONNECTED":
            break
        else:
            time.sleep(1)


    # disable AT mode
    ser.rts = True

    # send and receive data
    print("Sending and receiving messages, press CTRL+C to stop")
    print("Creating background receiving thread")
    thread_read = threading.Thread(target=read_serial, args=(ser,))
    thread_read.start()

    try:
        send_idx = 0
        while True:
            print(f"Sending ping {send_idx}")
            ser.write(f"UART PING {send_idx}\n".encode("ascii"))
            send_idx += 1
            time.sleep(1)
    except KeyboardInterrupt:
        pass
    finally:
        print("Finishing reading thread")
        keep_reading = False
        thread_read.join()

pip install pyserial