pid-balancer/control_functions.py

from adafruit_hcsr04 import HCSR04 as hcsr04        # Ultrasound sensor
import board                                        # General board pin mapper
from adafruit_servokit import ServoKit              # Servo libraries for PWM driver board
import adafruit_pcf8591.pcf8591 as PCF              # AD/DA converter board for potentiometer
from adafruit_pcf8591.analog_in import AnalogIn     # Analogue in pin library
from adafruit_pcf8591.analog_out import AnalogOut   # Analogue out pin library
import statistics as st                             # Mean and median calculations
import csv                                          # CSV handling
from time import sleep                              # Sleep/pause
import pandas as pd
from datetime import datetime
import busio
import adafruit_vl6180x
import math

# laser sensor controls.
# i2c = busio.I2C(board.SCL, board.SDA)
# laser = adafruit_vl6180x.VL6180X(i2c)

# Variables to control sensor
TRIGGER_PIN = board.D4      # GPIO pin xx
ECHO_PIN = board.D17        # GPIO pin xx
PIN_TIMEOUT: float = 0.1    # Timeout for echo wait -- don't change
RUN_TIMEOUT: float = 0.0    # Sleep time in function
MIN_DISTANCE: int = 6       # Minimum sensor distance to be considered valid (1 on bar)
MAX_DISTANCE: int = 40      # Maximum sensor distance to be considered valid (35 on bar)

# Variables to control servo
KIT = ServoKit(channels=16) # Define the type of board (8, 16)
MIN_PULSE: int = 400        # Defines angle 80, for current PID setup
MAX_PULSE: int = 2500       # Defines angle 100, for current PID setup
OFFSET: int = -1
KIT.servo[0].set_pulse_width_range(MIN_PULSE, MAX_PULSE)

# Variables to control logging.
LOG: bool   = True          # Log data to files
SCREEN: bool = True         # Log data to screen
DEBUG: bool = False         # More data to display
TWIN_MODE: bool = True     # Run in live or twin mode

# Control the number of samples for single distance measurement (average from burst)
MAX_SAMPLES: int = 1

# Control the potentiometer
# Description:
# POT_MIN = min_scaled: 0.012890821698329136 (0.01V)
# POT_MAX = max_scaled: 3.28715953307393000 (3.29V)
# POT_RNG = range_scaled: 3.274268711375600864 (3.28V) -> POT_MAX - POT_MIN
# POT_ARM = usable_arm_range: 35cm
# POT_PCM = 35 / 3.274268711375600864 = 10.689409784359341315326937965383 -> POT_ARM / POT_RNG
PCF_VAL: int = 65535
POT_MIN: float = 0.012890821698329136
POT_MAX: float = 3.287159533073930000
POT_RNG: float = 3.274268711375600864
POT_ARM: int = 35
POT_PCM: float = 10.689409784359341315326937965383
POT_INT: float = 0.1

# Pin control potentiometer board
i2c = board.I2C()
pcf = PCF.PCF8591(i2c)
pcf_in_0 = AnalogIn(pcf, PCF.A0)
pcf_out = AnalogOut(pcf, PCF.OUT)
pcf_out.value = PCF_VAL

# Variables to control PID values (PID formula tweaks)
p_value: float = 0.5
i_value: float = 0.01
d_value: float = 0.0

# Initial variables, used in pid_calculations()
i_result: float = 0.0
previous_time: float = 0.0
previous_error: float = 0.0

# Error sum array
error_sum_max: int = 10
error_sum_array: list = [0]*error_sum_max
error_sum_counter: int = 0


# Digital twin
previous_speed:float = 0.0
previous_position: float = 0.0
previous_angle: int = 90

#maximum angle the servo can move away from steady position. With 10 the range is between 80 and 100, with steady at 90
max_angle = 10

# servo slower
current_angle:int = 90

watch_variable: int = 0

# base time of the system
base_time: float = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))

# Write data to any of the logfiles
def log_data(data_file: str, data_line: str, remark: str|None):
    log_stamp: str = datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f')[:-3]

    with open("pid-balancer_" + "time_file.txt", "r") as time_file:
        file_stamp: str = time_file.readline()

    with open("pid-balancer_" + data_file + "_data_" + file_stamp + ".csv", "a") as data_file:
        data_writer  = csv.writer(data_file)
        data_writer.writerow([log_stamp,data_line, remark])

def read_distance_sensor():
    start_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))

    # Init array, used in read_distance_sensor()
    sample_array: list = []

    # Do a burst (MAX_SAMPLES) of measurements, filter out the obvious wrong ones (too short or to long a distance)
    # Return the mean timestamp and median distance.
    with hcsr04(trigger_pin=TRIGGER_PIN, echo_pin=ECHO_PIN, timeout=PIN_TIMEOUT) as sonar:
        samples: int = 0
        max_samples: int = MAX_SAMPLES
        timestamp_last: float   = 0.0
        timestamp_first: float = 0.0

        while samples != max_samples:
            sleep(RUN_TIMEOUT)
            try:
                distance: float = sonar.distance # reading distance from the sonic sensor
                # distance: float = laser.range * 10 # reading distance from the laser sensor

                if MIN_DISTANCE < distance < MAX_DISTANCE:

                    log_data(data_file="sensor", data_line=str(distance), remark="") if LOG else None
                    # print("Distance_in_range: ", distance) if SCREEN else None
                    if max_samples == 1:
                        median_distance = distance
                        mean_timestamp = float(datetime.strftime(datetime.now(),'%Y%m%d%H%M%S.%f')[:-3])
                    else:
                        sample_array.append(distance)
                        if samples == 0: timestamp_first  = float(datetime.strftime(datetime.now(),
                                                                                    '%Y%m%d%H%M%S.%f')[:-3])
                        if samples == max_samples - 1:
                            timestamp_last = float(datetime.strftime(datetime.now(),
                                                                                    '%Y%m%d%H%M%S.%f')[:-3])

                            timestamp_first_float: float = float(timestamp_first)
                            timestamp_last_float: float = float(timestamp_last)
                            median_distance: float = st.median(sample_array)
                            mean_timestamp: float  = st.mean([timestamp_first_float, timestamp_last_float])
                            print("Distance_median: ", median_distance) if SCREEN else None
                            print("Timestamp_mean: ", mean_timestamp) if DEBUG else None
                            print("Distance_in_range: ", distance) if SCREEN else None

                            data_line = str(sample_array) + ',' + str(median_distance)
                            log_data(data_file="sensor_array", data_line= data_line,
                                     remark="") if LOG else None
                            print("Distance_in_range_rounded: ", round(distance, 4)) if SCREEN else None

                        samples: int = samples + 1

                else:
                    log_data(data_file="sensor", data_line=str(distance), remark="Distance_out_of_range") if LOG else None
                    print("Distance_out_of_range: ", round(distance, 4)) if SCREEN else None

            except RuntimeError:
                log_data(data_file="sensor", data_line="999.999", remark="Timeout") if LOG and DEBUG else None
                print("Distance_timed_out") if SCREEN else None

    end_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))
    data_line = str(start_time - end_time)
    log_data(data_file="function", data_line=data_line, remark="read_distance_sensor") if LOG else None

    return median_distance, mean_timestamp

def read_setpoint():
    start_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))

    while True:
        raw_value: int = pcf_in_0.value
        scaled_value: float = (raw_value / PCF_VAL) * pcf_in_0.reference_voltage

        log_line = str(scaled_value) + "," + str(raw_value) + "," + str("angle")
        log_data(data_file="potmeter", data_line=log_line, remark="") if LOG else None

        cm_rounded: int = int(round(scaled_value * POT_PCM, 0))

        if DEBUG:
            print('Scaled_rounded = ' , round(scaled_value, 4), ' CM_rounded= ', cm_rounded)
            print('Scaled_raw= ' , scaled_value, ' CM_raw= ', int(scaled_value * POT_PCM))

        print('setpoing in cm: ', cm_rounded) if SCREEN else None

        sleep(POT_INT)

        end_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))
        data_line = str(start_time - end_time)
        log_data(data_file="function", data_line=data_line, remark="read_setpoint") if LOG else None

        return cm_rounded

def digital_twin():
    # a: acceleration
    # g: gravity (9.81 m/s^2)
    # theta: angle of the inclined plane
    # u: coefficient of the friction between the cart and the inclined plane.
    acceleration: float = 0.0
    global previous_position, previous_speed, base_time, watch_variable
    gravity: float = 9.81
    friction: float = 0.1
    delta_t: float = 0.1

    angle = (previous_angle - 90)
    acceleration = gravity * math.sin(math.radians(angle))
    friction_force = friction * gravity * math.cos(math.radians(angle)) * delta_t

    friction_force = abs(friction_force)

    work_speed = previous_speed + acceleration * delta_t
    watch_variable = watch_variable + 1

    if watch_variable >= 150:
        print("breakpoint")

    print("watch_variable", watch_variable)
    if friction_force < work_speed:
        if work_speed > 0:
             work_speed = work_speed - friction_force
        elif work_speed < 0:
            work_speed = work_speed + friction_force
        else:
            work_speed = work_speed

    current_speed = work_speed

    current_position = previous_position + (current_speed * delta_t)


    print("angle", angle)
    print("friction", friction)
    print("acceleration", acceleration)
    print("current speed", current_speed)
    print("current position", current_position)
    print("")
    print("----------------")
    print("")

    base_time = base_time + delta_t


    previous_speed = current_speed
    previous_position = current_position

    return current_position, base_time

def pid_calculations():
    start_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))

    global i_result, previous_time, previous_error # Can not be annotated with :float, because variables are global.
    global error_sum_counter, error_sum_array # counter for error_sum_array and error_sum_array itself
    global previous_angle
    offset_value: int = 0
    if TWIN_MODE:
        measurement, measurement_time = digital_twin()
    else:
        measurement, measurement_time = read_distance_sensor()

    setpoint = read_setpoint()
    error = setpoint - measurement

    if previous_time is None:
        previous_error = 0.0
        previous_time = measurement_time
        i_result = 0.0

    error_sum_array[error_sum_counter] = (error * (measurement_time - previous_time))
    p_result = p_value * error
    i_result =  i_value * sum(error_sum_array)
    d_result = d_value * ((error - previous_error) / (measurement_time - previous_time))
    pid_result = offset_value + p_result + i_result + d_result
    previous_error = error
    previous_time = measurement_time


    #function to set the 2 max angles. Or set the angle to a specific number = pid_result * max movement + correction
    if pid_result >= max_angle: # if PID result is greater than 1, set to 1. 1 = max upward angle
        output_angle = (90 + max_angle)
    elif pid_result <= -max_angle:  # if PID result is greater than 1, set to 1. 1 = max downward angle
        output_angle = (90-max_angle)
    elif -max_angle < pid_result < max_angle:
        output_angle = pid_result + 90
    else:
        output_angle = 90

    log_line = str(p_result) + "," + str(i_result) + "," + str(d_result) + "," + str(pid_result)
    log_data(data_file="pid", data_line=log_line, remark="") if LOG else None

    if DEBUG:
        print("P_result: ", p_result)
        print("D_result: ", d_result)
        print("I_result: ", i_result)
        print("PID_result: ", pid_result)

    if error_sum_counter <= error_sum_max-2:
        error_sum_counter = error_sum_counter + 1
    else:
        error_sum_counter = 0

    print("error sum counter", error_sum_counter)  if DEBUG else None

    end_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))
    data_line = str(start_time - end_time)
    log_data(data_file="function", data_line=data_line, remark="pid_calculations") if LOG else None

    output_angle = round(output_angle)
    previous_angle = output_angle

    return output_angle

def control_server_angle(angle):
    start_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))

    servo_angle = angle + OFFSET

    KIT.servo[0].angle = servo_angle # Set angle
    log_line = str(angle)
    log_data(data_file="servo", data_line=log_line, remark="") if LOG else None
    print("angle: ", servo_angle) if SCREEN else None

    end_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))
    data_line = str(start_time - end_time)
    log_data(data_file="function", data_line=data_line, remark="control_server_angle") if LOG else None

def servo_slower():
    start_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))

    global current_angle
    pid_angle = pid_calculations()
    if (pid_angle - current_angle) > 5:
        servo_angle = current_angle + 5
    elif (pid_angle - current_angle) < -5:
        servo_angle = current_angle - 5
    else:
        servo_angle = pid_angle

    current_angle = servo_angle

    end_time = float(datetime.strftime(datetime.now(), '%Y%m%d%H%M%S.%f'))
    data_line = str(start_time - end_time)
    log_data(data_file="function", data_line=data_line, remark="servo_slower") if LOG else None

    return servo_angle

try:
    KIT.servo[0].angle = 90
    while True:
        # digital_twin()
        control_server_angle(pid_calculations())
except RuntimeError:
    print("bbbb")