while

مقدمه

این راهنما نحوه استفاده از حلقه‌های `while` را با توابع مختلف تعریف شده در کتابخانه ESP توضیح می‌دهد

۱. حلقه‌های while با ورودی‌های دیجیتال

۱.۱ انتظار برای فعال شدن ورودی

//    فعال شود I0.0 انتظار تا زمانی که ورودی
while (!I0[0].Value) {
espRun(); // PLC اجرای اصلی 
HAL_Delay(10); // تاخیر ۱۰ میلی‌ثانیه
}

۱.۲ انتظار برای غیرفعال شدن ورودی

//  غیرفعال شود I0.1  انتظار تا زمانی که ورودی
while (I0[1].Value) {
    espRun();
    HAL_Delay(10);
}

۱.۳ انتظار برای تغییر وضعیت ورودی

// I0.2 انتظار برای تغییر وضعیت ورودی
uint8_t previousState = I0[2].Value;
while (I0[2].Value == previousState) {
    espRun();
    HAL_Delay(10);
}

۱.۴ انتظار برای لبه صعودی (Rising Edge)

// I0.3 انتظار برای لبه صعودی ورودی 
while (!I0[3].Rising) {
    espRun();
    HAL_Delay(10);
}

۱.۵ انتظار برای لبه نزولی (Falling Edge)

//I0.4 انتظار برای لبه نزولی ورودی 
while (!I0[4].Falling) {
    espRun();
    HAL_Delay(10);
}

۲. حلقه‌های while با خروجی‌های دیجیتال

۲.۱ انتظار برای فعال شدن خروجی

//فعال شود Q0.0 انتظار تا زمانی که خروجی 
while (!Q0[0].Value) {
    espRun();
    HAL_Delay(10);
}

۲.۲ انتظار برای غیرفعال شدن خروجی

// غیرفعال شود Q0.1 انتظار تا زمانی که خروجی
while (Q0[1].Value) {
    espRun();
    HAL_Delay(10);
}

۲.۳ انتظار برای تغییر وضعیت خروجی

//Q0.2 انتظار برای تغییر وضعیت خروجی 
uint8_t prevOutput = Q0[2].Value;
while (Q0[2].Value == prevOutput) {
    espRun();
    HAL_Delay(10);
}

۳. حلقه‌های while با رله‌های داخلی (M)

۳.۱ انتظار برای فعال شدن رله داخلی

//  فعال شود M100 انتظار تا زمانی که رله
while (!M[100].Value) {
    espRun();
    HAL_Delay(10);
}

۳.۲ انتظار برای غیرفعال شدن رله داخلی

//  غیرفعال شود M101 انتظار تا زمانی که رله
while (M[101].Value) {
    espRun();
    HAL_Delay(10);
}

۳.۳ انتظار برای لبه صعودی رله

//M102 انتظار برای لبه صعودی رله 
while (!M[102].Rising) {
    espRun();
    HAL_Delay(10);
}

۴. حلقه‌های while با تایمرها

۴.۱ انتظار برای اتمام تایمر

// تمام شود T[0] انتظار تا زمانی که تایمر
while (!T[0].Q) {
    espRun();
    HAL_Delay(10);
}

۴.۲ انتظار برای شروع تایمر

// شروع شود T[1] انتظار تا زمانی که تایمر
while (T[1].Q) {
    espRun();
    HAL_Delay(10);
}

۴.۳ انتظار برای زمان مشخص

// انتظار برای ۵ ثانیه
uint32_t startTime = espGetTimerTicks();
while ((espGetTimerTicks() - startTime) < 500) {  // 500 * 10ms = 5s
    espRun();
    HAL_Delay(10);
}

۵. حلقه‌های while با پالس‌های ساعت

۵.۱ انتظار برای پالس ۰.۱ ثانیه

// انتظار برای پالس ۰.۱ ثانیه
while (!P0_1s) {
    espRun();
    HAL_Delay(10);
}

۵.۲ انتظار برای پالس ۱ ثانیه

// انتظار برای پالس ۱ ثانیه
while (!P_1s) {
    espRun();
    HAL_Delay(10);
}

۵.۳ انتظار برای پالس ۱ دقیقه

// انتظار برای پالس ۱ دقیقه
while (!P_1min) {
    espRun();
    HAL_Delay(10);
}

۶. حلقه‌های while با ارتباطات سریال

۶.۱ انتظار برای دریافت داده از COM1

//COM1 انتظار برای دریافت داده از 
while (!COM1_Request_In) {
    espRun();
    HAL_Delay(10);
}

۶.۲ انتظار برای اتمام ارسال به COM2

//COM2 انتظار برای اتمام ارسال به 
while (COM2_RequestOut) {
    espRun();
    HAL_Delay(10);
}

۶.۳ انتظار برای اتمام کار ارتباطی

//COM1 انتظار برای اتمام کار 
while (!COM1_JobFinished) {
    espRun();
    HAL_Delay(10);
}

۷. حلقه‌های while با Modbus

۷.۱ انتظار برای اتمام خواندن Modbus

// Modbus انتظار برای اتمام خواندن داده
while (!modbusData.coils[0]) {  // انتظار برای تغییر coil 0
    espRun();
    HAL_Delay(10);
}

۷.۲ انتظار برای مقدار مشخص در رجیستر

// holding 0 انتظار برای مقدار ۱۰۰ در رجیستر 
while (modbusData.holding_registers[0] != 100) {
    espRun();
    HAL_Delay(10);
}

۸. حلقه‌های while با نمایشگر

۸.۱ انتظار برای اتمام به‌روزرسانی نمایشگر

// انتظار برای اتمام به‌روزرسانی نمایشگر
uint32_t displayStart = HAL_GetTick();
while ((HAL_GetTick() - displayStart) < 100) {
    espRun();
    HAL_Delay(10);
}
Display_UpdateScreen();

۹. حلقه‌های while ترکیبی

۹.۱ انتظار برای چندین شرط همزمان

//I0.0 و غیرفعال شدن I0.1 انتظار برای فعال شدن  
while (!I0[0].Value || I0[1].Value) {
    espRun();
    HAL_Delay(10);
}

۹.۲ انتظار برای فعال شدن خروجی و تایمر

//T[0] اتمام تایمر  
//Q0.0 یا انتظار برای فعال شدن 
while (!Q0[0].Value || !T[0].Q) {
    espRun();
    HAL_Delay(10);
}

۱۰. نکات مهم و بهترین شیوه‌ها

۱۰.۱ جلوگیری از حلقه بی‌نهایت

//timeout  استفاده از 
uint32_t timeout = HAL_GetTick() + 5000;  // timeout 5 seconds
while (!I0[0].Value) {
    if (HAL_GetTick() > timeout) {
        // timeout occurred
        break;
    }
    espRun();
    HAL_Delay(10);
}

۱۰.۲ استفاده از تاخیر مناسب

// همیشه از تاخیر مناسب استفاده کنید تا سی پی یو بیش از حد بار نشود
while (condition) {
    espRun();
    HAL_Delay(10);  // تاخیر ۱۰ میلی‌ثانیه
}

۱۰.۳ بررسی وضعیت سیستم

// بررسی وضعیت سیستم در حلقه
while (condition) {
    espRun();
    
    // بررسی خطاهای ارتباطی
    if (COM1_Error || COM2_Error) {
        // مدیریت خطا
        break;
    }
    
    HAL_Delay(10);
}

۱۱. مثال‌های کاربردی

۱۱.۱ کنترل ساده موتور

// شروع موتور و انتظار برای رسیدن به سرعت
SetQ(0, 0);  // فعال کردن موتور
while (!I0[0].Value) {  // انتظار برای سنسور سرعت
    espRun();
    HAL_Delay(10);
}

۱۱.۲ کنترل توالی عملیات

// توالی عملیات: فعال کردن، انتظار، غیرفعال کردن
SetQ(0, 1);  // مرحله ۱: فعال کردن
while (!I0[1].Value) {  // انتظار برای سنسور
    espRun();
    HAL_Delay(10);
}

ResetQ(0, 1);  // مرحله ۲: غیرفعال کردن
while (I0[1].Value) {  // انتظار برای غیرفعال شدن سنسور
    espRun();
    HAL_Delay(10);
}

۱۱.۳ کنترل با تایمر

// فعال کردن خروجی برای مدت زمان مشخص
SetQ(0, 2);
T[0].SetValue = 50;  // ۵ ثانیه
T[0].TimeUnit = TIME_01S;
T[0].IN = 1;
EnableTimer(&T[0]);

while (!T[0].Q) {  // انتظار برای اتمام تایمر
    espRun();
    HAL_Delay(10);
}

ResetQ(0, 2);
T[0].IN = 0;

۱۲. خلاصه

 `while` در ESP-0806-DL برای:
- انتظار برای تغییر وضعیت ورودی‌ها
- انتظار برای تغییر وضعیت خروجی‌ها
- انتظار برای اتمام تایمرها
- انتظار برای پالس‌های ساعت
- انتظار برای اتمام عملیات ارتباطی
- کنترل توالی عملیات

نکات کلیدی

1. همیشه از `espRun()` در حلقه استفاده کنید
2. از تاخیر مناسب (`HAL_Delay(10)`) استفاده کنید
3. از timeout برای جلوگیری از حلقه بی‌نهایت استفاده کنید
4. وضعیت سیستم را بررسی کنید
5. از توابع مناسب برای هر نوع انتظار استفاده کنید