如何使用Python将数字倾角计的串口数据转换为可读格式？

Hey there! Let's fix up your script to turn that raw serial data from your inclinometer into actual, usable angle values. First, let's break down what your current code does and where we need to extend it.

What Your Current Script Does Right Now #

Your existing code reads a single byte from the serial port, converts it to a hex string, and prints it. That's a great start—but inclinometers almost always send multi-byte data (e.g., 2 bytes for X-axis tilt, 2 bytes for Y-axis) instead of single bytes, so we need to adjust how we read and parse the data.

Step-by-Step Solution #

First, you’ll need to reference your inclinometer’s manual to confirm two critical details:

1. The data frame structure (how many bytes per reading, if there’s a frame header/footer for syncing, endianness: little vs. big endian)
2. The raw value to angle conversion ratio (e.g., raw values from -32768 to 32767 might map to ±90° or ±180°)

Below is a practical, adaptable script based on common inclinometer protocols:

import serial
import struct

# Configure serial port (adjust COM port, baud rate, timeout to match your device)
ser = serial.Serial('COM1', 9600, timeout=1)

try:
    print("Reading inclinometer data... Press Ctrl+C to stop")
    while True:
        # --- Optional: Sync to frame header (if your device uses one) ---
        # Many inclinometers send a frame start byte (e.g., 0xAA) to mark valid data
        # Uncomment this block if your device uses a header:
        # while True:
        #     header_byte = ser.read(1)
        #     if header_byte == b'\xAA':  # Replace with your device's header byte
        #         break

        # Read the actual data payload (example: 4 bytes for X + Y axis, 2 bytes each)
        data_payload = ser.read(4)
        
        # Only process if we got a full payload
        if len(data_payload) == 4:
            # Parse raw bytes into signed integers
            # Use '<hh' for little-endian, two 16-bit signed integers
            # Use '>hh' for big-endian if your device specifies that
            x_raw, y_raw = struct.unpack('<hh', data_payload)
            
            # Convert raw values to actual angles (adjust ratio based on your device's specs)
            # Example: If raw range (-32768 to 32767) maps to ±90°
            angle_scale = 90.0 / 32767
            x_angle = round(x_raw * angle_scale, 2)
            y_angle = round(y_raw * angle_scale, 2)
            
            # Print readable output (ready to copy/paste into your post!)
            print(f"X-axis Tilt: {x_angle}° | Y-axis Tilt: {y_angle}°")
        else:
            print("Waiting for full data frame...")

except KeyboardInterrupt:
    print("\nStopping data read.")
finally:
    ser.close()  # Always close the serial port when done

Key Explanations #

• Serial Reading: ser.read(4) grabs 4 bytes at once (adjust this number to match your device’s payload size). If your device uses a frame header, use the commented sync block to avoid parsing partial/invalid frames.
• Struct Parsing: The struct module is far more reliable than manual hex conversion for multi-byte data. The format string (<hh) tells Python how to interpret the bytes—swap < with > if your device uses big-endian encoding.
• Angle Conversion: The angle_scale variable maps raw integer values to actual degrees. Update this ratio to match your inclinometer’s specified range (e.g., use 180.0 / 32767 if your device measures ±180°).

If You Have Sample Data #

If you can share the exact hex string your inclinometer sends (e.g., 00 1F FF E1), I can tweak this script to match your device’s exact protocol perfectly.

内容的提问来源于stack exchange，提问作者Donn