تقنيات تتبع الأخطاء وتصحيحها في الأنظمة الصناعية

عندما لا يعمل الكود: فن اصطياد الأخطاء

في عالم البرمجة الصناعية، الخطأ البرمجي ليس مجرد إزعاج — قد يعني توقف خط إنتاج كامل، أو تلف منتجات، أو حتى خطر على سلامة العمال. لذلك فإن مهارات تتبع الأخطاء وإصلاحها (Debugging) هي من أهم المهارات التي يحتاجها مهندس الأتمتة.

الخطأ البرمجي يسمى Bug (حشرة!) — والقصة الشهيرة تقول أن حشرة حقيقية علقت في أحد الحواسيب القديمة عام 1947 وسببت عطلاً. منذ ذلك الحين، أصبح "اصطياد الحشرات" (Debugging) مصطلحاً رسمياً.

أنواع الأخطاء في كود التحكم الصناعي

أخطاء بناء الجملة (Syntax Errors)

أسهل الأخطاء — المترجم يكتشفها فوراً:

# خطأ: نسيان النقطتين
if temperature > 100
    activate_cooling()

# الصواب:
if temperature > 100:
    activate_cooling()

أخطاء وقت التشغيل (Runtime Errors)

تظهر أثناء عمل البرنامج:

def calculate_flow_rate(volume, time_seconds):
    return volume / time_seconds  # ماذا لو كان time_seconds = 0؟

# الحل الآمن:
def calculate_flow_rate(volume, time_seconds):
    if time_seconds <= 0:
        logging.warning("زمن غير صالح: %s", time_seconds)
        return 0.0
    return volume / time_seconds

أخطاء منطقية (Logic Errors)

الأخطر والأصعب — الكود يعمل دون رسائل خطأ، لكن النتيجة خاطئة:

# خطأ منطقي: استخدام OR بدل AND
if pressure > 5 or temperature > 80:
    emergency_shutdown()  # سيتوقف حتى لو شرط واحد فقط تحقق!

# المقصود: التوقف فقط عندما يتحقق الشرطان معاً
if pressure > 5 and temperature > 80:
    emergency_shutdown()

أخطاء التوقيت (Timing Errors)

خاصة بالأنظمة الصناعية — كل شيء يعتمد على التوقيت:

# خطأ: قراءة المستشعر قبل أن يستقر
def read_pressure():
    sensor.power_on()
    value = sensor.read()  # القراءة فورية — المستشعر لم يستقر بعد!
    return value

# الصواب: انتظار زمن الاستقرار
def read_pressure():
    sensor.power_on()
    time.sleep(0.5)  # انتظار 500ms لاستقرار المستشعر
    value = sensor.read()
    return value

استراتيجيات التسجيل (Logging)

التسجيل هو عيونك داخل البرنامج أثناء تشغيله. في البيئة الصناعية، لا يمكنك الوقوف بجانب الآلة وإضافة print — تحتاج نظام تسجيل منظم.

مستويات التسجيل

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s [%(levelname)s] %(name)s: %(message)s',
    handlers=[
        logging.FileHandler('/var/log/plc_control.log'),
        logging.StreamHandler()  # الطباعة أيضاً على الشاشة
    ]
)

logger = logging.getLogger("MotorControl")

def start_motor(motor_id):
    logger.info("بدء تشغيل المحرك %s", motor_id)

    current = read_motor_current(motor_id)
    logger.debug("التيار الابتدائي: %.2f A", current)

    if current > 15.0:
        logger.warning("تيار بدء مرتفع: %.2f A للمحرك %s", current, motor_id)

    if current > 25.0:
        logger.error("تيار خطير! إيقاف المحرك %s", motor_id)
        stop_motor(motor_id)
        return False

    logger.info("المحرك %s يعمل بنجاح", motor_id)
    return True

قواعد التسجيل الذهبية

تسجيل بنيوي (Structured Logging)

للأنظمة المعقدة، السجلات النصية لا تكفي — استخدم التسجيل البنيوي:

import json
from datetime import datetime

def structured_log(level, event, **data):
    entry = {
        "timestamp": datetime.utcnow().isoformat(),
        "level": level,
        "event": event,
        **data
    }
    print(json.dumps(entry))

# الاستخدام:
structured_log("INFO", "motor_started",
    motor_id="M-101",
    current_amps=8.5,
    voltage=380,
    line="filling_line_1"
)

الخرج:

{"timestamp": "2026-04-05T10:30:00", "level": "INFO", "event": "motor_started", "motor_id": "M-101", "current_amps": 8.5, "voltage": 380, "line": "filling_line_1"}

هذا الشكل سهل التحليل آلياً باستخدام أدوات مثل Elasticsearch أو Grafana.

نقاط التوقف والتتبع خطوة بخطوة

استخدام نقاط التوقف (Breakpoints)

نقطة التوقف تجمّد البرنامج عند سطر محدد وتتيح لك فحص كل المتغيرات:

# في VS Code أو PyCharm: ضع نقطة توقف عند السطر المشبوه

def control_loop(setpoint, sensor_value):
    error = setpoint - sensor_value
    # <-- ضع نقطة توقف هنا
    kp = 2.5
    ki = 0.1
    integral = 0

    integral += error * dt
    output = kp * error + ki * integral

    if output > 100:
        output = 100  # تشبع الخرج
    return output

نقاط التوقف الشرطية

بدل التوقف في كل دورة، توقف فقط عندما يتحقق شرط:

# في المنقّح (Debugger):
# Condition: error > 10 and cycle_count > 1000
# هذا يتوقف فقط عندما يكون الخطأ كبيراً بعد فترة من التشغيل

التتبع بدون توقف (Tracing)

عندما لا تستطيع إيقاف البرنامج (لأن الآلة تعمل!)، استخدم التتبع:

import functools

def trace_call(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        logger.debug("استدعاء %s(%s, %s)", func.__name__, args, kwargs)
        result = func(*args, **kwargs)
        logger.debug("نتيجة %s = %s", func.__name__, result)
        return result
    return wrapper

@trace_call
def calculate_pid(setpoint, current, kp, ki, kd):
    error = setpoint - current
    return kp * error  # مبسّط للتوضيح

المحاكاة: اختبار بدون آلة حقيقية

في الأتمتة الصناعية، لا يمكنك دائماً الاختبار على الآلة الحقيقية. المحاكاة تنقذك:

class SimulatedSensor:
    """محاكاة مستشعر حرارة لأغراض الاختبار"""
    def __init__(self, initial_temp=25.0):
        self._temp = initial_temp
        self._noise_level = 0.5

    def read(self):
        import random
        noise = random.uniform(-self._noise_level, self._noise_level)
        return self._temp + noise

    def simulate_heating(self, rate_per_second, duration):
        self._temp += rate_per_second * duration

class SimulatedMotor:
    """محاكاة محرك مع تأخير واقعي"""
    def __init__(self, rated_rpm=1450):
        self.target_rpm = 0
        self.actual_rpm = 0
        self._rated_rpm = rated_rpm
        self._ramp_rate = 200  # RPM/ثانية

    def set_speed(self, rpm):
        self.target_rpm = min(rpm, self._rated_rpm)

    def update(self, dt):
        """استدعِ هذه الدالة كل دورة محاكاة"""
        if self.actual_rpm < self.target_rpm:
            self.actual_rpm = min(
                self.target_rpm,
                self.actual_rpm + self._ramp_rate * dt
            )
        elif self.actual_rpm > self.target_rpm:
            self.actual_rpm = max(
                self.target_rpm,
                self.actual_rpm - self._ramp_rate * dt
            )

# اختبار خوارزمية التحكم بدون آلة حقيقية
sensor = SimulatedSensor(initial_temp=20.0)
for cycle in range(100):
    temp = sensor.read()
    if temp < 50:
        sensor.simulate_heating(0.5, 0.1)
    print(f"الدورة {cycle}: الحرارة = {temp:.1f}")

التنقيح عن بُعد (Remote Debugging)

الأنظمة الصناعية غالباً تعمل على أجهزة بعيدة. إليك كيفية التنقيح عن بُعد:

باستخدام SSH وdebugpy (Python)

# على الجهاز المستهدف (PLC/الحاسب الصناعي):
pip install debugpy
python -m debugpy --listen 0.0.0.0:5678 --wait-for-client control_main.py

# على حاسبك (VS Code):
# أضف في launch.json:

{
    "name": "Remote Debug",
    "type": "python",
    "request": "attach",
    "connect": {
        "host": "192.168.1.100",
        "port": 5678
    },
    "pathMappings": [
        {
            "localRoot": "${workspaceFolder}/src",
            "remoteRoot": "/opt/control/src"
        }
    ]
}

سجلات مركزية عبر الشبكة

import logging
from logging.handlers import SocketHandler

# إرسال السجلات إلى خادم مركزي
handler = SocketHandler('192.168.1.50', 9020)
logger.addHandler(handler)

# الآن كل السجلات من جميع الأجهزة تصل إلى مكان واحد
logger.info("محرك خط التعبئة 3 — تيار مرتفع")

الأخطاء الشائعة في برمجة التحكم

1. سباق البيانات (Race Condition)

# خطأ: خيطان يقرآن ويكتبان نفس المتغير
shared_counter = 0

def sensor_thread():
    global shared_counter
    shared_counter += 1  # ليست عملية ذرية!

# الحل: استخدام قفل
import threading
lock = threading.Lock()

def sensor_thread_safe():
    global shared_counter
    with lock:
        shared_counter += 1

2. تسريب الذاكرة (Memory Leak)

# خطأ: تخزين القراءات إلى الأبد
readings = []
while True:
    readings.append(sensor.read())  # الذاكرة تمتلئ!

# الحل: استخدام مخزن دوّار
from collections import deque
readings = deque(maxlen=1000)  # الاحتفاظ بآخر 1000 قراءة فقط
while True:
    readings.append(sensor.read())

3. عدم معالجة فقدان الاتصال

# خطأ: افتراض أن الاتصال دائماً متاح
value = plc.read_register(100)

# الحل: معالجة الأخطاء مع إعادة المحاولة
import time

def safe_read(plc, register, retries=3):
    for attempt in range(retries):
        try:
            return plc.read_register(register)
        except ConnectionError:
            logger.warning("فشل الاتصال (محاولة %d/%d)", attempt+1, retries)
            time.sleep(1)
            plc.reconnect()
    logger.error("فشل نهائي في قراءة السجل %d", register)
    return None

4. أرقام الفاصلة العائمة

# خطأ: المقارنة المباشرة للأعداد العشرية
if temperature == 37.5:  # قد لا يتحقق أبداً!
    activate_alarm()

# الحل: استخدام هامش تسامح
EPSILON = 0.01
if abs(temperature - 37.5) < EPSILON:
    activate_alarm()

منهجية منظمة لاصطياد الأخطاء

1. أعد إنتاج الخطأ — إذا لم تستطع تكراره، لن تستطيع إصلاحه
2. اعزل المشكلة — عطّل المكونات واحداً تلو الآخر حتى تحدد المسبب
3. اقرأ السجلات — غالباً الجواب موجود في ملفات السجل
4. تحقق من الافتراضات — هل المستشعر يعمل فعلاً؟ هل الاتصال موجود؟
5. غيّر شيئاً واحداً فقط — لا تغيّر عدة أشياء معاً ثم تختبر
6. وثّق الحل — اكتب ما كان الخطأ وكيف أصلحته، لتجنب تكراره

الخلاصة

تتبع الأخطاء في البرمجة الصناعية يتطلب:

• نظام تسجيل منظم بمستويات واضحة
• نقاط توقف ذكية (خاصة الشرطية)
• محاكاة للاختبار الآمن بدون المخاطرة بالآلة
• تنقيح عن بُعد للأجهزة في الميدان
• وعي بالأخطاء الشائعة مثل سباق البيانات وتسريب الذاكرة

تذكّر: المبرمج الجيد لا يكتب كوداً بلا أخطاء — بل يكتب كوداً يسهل فيه اكتشاف الأخطاء وإصلاحها.