# فصل ۱۰ — پروژهٔ نهایی، بخش سوم: رفعِ اشکال و پایداری

<div dir="rtl">

# فصل ۱۰ — پروژهٔ نهایی، بخش سوم: رفعِ اشکال و پایداری

## در این فصل چه می‌سازی

سه صحنه را تصور کن: رباتِ پیشخدمتی که بعد از ایستگاه، **گاهی** گیج به سفیدی می‌رود؛ داشبوردی که بعد از چند دقیقه دیگر جواب نمی‌دهد؛ رباتِ مسابقه‌ای که وسطِ دور بی‌دلیل خشکش می‌زند. این‌ها کابوسِ شبِ نمایش‌اند: پروژه‌ای که دیروز کار می‌کرد و امروز «گاهی» کار می‌کند.

ترسناک‌ترین کلمهٔ این جمله همان **«گاهی»** است. باگی که همیشه رخ می‌دهد دوستِ توست — جلوی چشمت می‌ایستد تا حلش کنی. باگی که گاهی رخ می‌دهد، قایم‌باشک‌باز است. خبرِ خوب: مهندس‌ها برای همین قایم‌باشک یک روشِ سیستماتیک دارند که امروز یاد می‌گیری — اسمش را می‌گذاریم **«نصفش کن!»**.

مثلِ دو فصلِ قبل، این فصل هم سه مسیرِ موازی دارد و تو فقط بخشِ مسیر خودت را دنبال می‌کنی — ولی بخشِ اولِ فصل، روشِ «نصفش کن»، برای **هر سه مسیر** واجب است. امروز اول این روش، بعد در هر مسیر یک شکارِ واقعی، بعد به پروژه‌ات failsafe اضافه می‌کنی، و آخرش چک‌لیستِ پایداری و تمرینِ کاملِ نمایش — همان قدمِ آخری که پروژه را از «کار می‌کند» به «همیشه کار می‌کند» می‌رساند.

آخر این فصل می‌توانی:

- روشِ تقسیم دودویی («نصفش کن!») را با سه ابزارش توضیح بدهی و یک باگِ واقعی را در پروژه‌ات شکار کنی.
- چک‌لیستِ پایداری را قبل از هر اجرا کامل کنی و معیارِ «سه اجرای موفقِ پشت سر هم» را پاس کنی.
- به پروژه‌ات failsafe اضافه کنی: رفتارِ امن وقتی چیزی غیرمنتظره خراب می‌شود.
- یک تمرینِ کاملِ نمایش (dress rehearsal) با زمان‌گیری اجرا کنی و milestone سه را تحویل بدهی.

## قبل از شروع: چک‌لیست پیش‌نیاز

- **از فصل ۹:** پروژه با قابلیت‌های کامل (M2) — نسخهٔ امروز روی همان فایل ساخته می‌شود.
- **از فصل ۷:** سند طراحی و معیارِ داوری — ردیفِ «پایداری» امروز تسویه می‌شود.
- **از ترم ۳، فصل ۱۱:** «چک‌لیستِ پایداری» — همان بازبینیِ قبل از هر اجرا، مثلِ خلبان‌ها قبل از پرواز — به‌علاوهٔ مفهومِ Reliability و «سه اجرای موفقِ پشت سر هم». امروز نسخهٔ پروژهٔ نهایی‌اش را می‌سازیم.
- **از ترم ۳، فصل ۱ و ۶:** ایمنیِ باتری و timeout با شمارنده؛ **از ترم ۴، فصل ۹ و ۱۰:** `gc.collect` و تمیزکاریِ پاسخِ AI (مسیر B).

لوازم این فصل:

| قطعه / ابزار | تعداد | جایگزین ارزان یا در دسترس |
|---|---|---|
| پروژهٔ کاملِ فصل ۹ مسیر خودت | ۱ | — |
| باتریِ تازه/پرشارژ + دستِ ذخیره (مسیر A و C) | ۲ دست | معیارِ پایداری با باتریِ ضعیف قابل سنجش نیست |
| گوشی با کرونومتر + دفترچهٔ مهندسی | ۱ | — |
| زمینِ بازیِ مرتب (A و C): لبهٔ نوارها چسبیده، کف تمیز | ۱ | مرورِ دستورِ ترم ۳ |
| مسیر B: اینترنتِ پایدار + مرورگرِ گوشی | — | — |
| یک تماشاچیِ تمرینی از خانواده | ۱ | دوربینِ گوشی هم تماشاچیِ خوبی است |

## ۱. نصفش کن! تقسیمِ دودویی مشکل

فرض کن پلی‌لیستی با شصت‌وچهار آهنگ داری و یکی‌شان خرابِ دانلود شده — کدام؟ راهِ اول: یکی‌یکی گوش بدهی؛ در بدترین حالت شصت‌وچهار تست. راهِ دوم، راهِ شکارچی: **نصفش کن!** سی‌ودو تای اول را رد کن، از وسط پخش کن. خراب در نیمهٔ اول بود؟ حالا فقط سی‌ودو مظنون داری. دوباره نصف: شانزده... هشت... چهار... دو... یک. شش تست به‌جای شصت‌وچهار! این جادوی **تقسیم دودویی** است: هر تست، نیمی از مظنون‌ها را یک‌جا تبرئه می‌کند.

حالا همین را روی پروژه پیاده کن. هر سیستمِ تو یک زنجیره است — مثلاً سنسور ← مغز ← موتور، یا سنسور ← سرور ← اینترنت ← AI. وقتی «گاهی» خراب می‌شود، وسطِ زنجیره را پیدا کن و یک سؤال بپرس: «تا این‌جا سالم است؟» جوابش نیمی از زنجیره را تبرئه می‌کند.

برای پرسیدنِ این سؤال سه ابزار داری:

1. **کاوشگرِ print:** وسطِ زنجیره یک چاپِ موقت بگذار — اگر عددِ چاپ‌شده سالم بود، نیمهٔ قبلی تبرئه است. همان راویِ print که از ترم ۱ می‌شناسی، این بار در نقشِ کارآگاه.
2. **قطعِ نیمه:** نیمی از سخت‌افزار را جدا کن و ببین مشکل می‌ماند یا می‌رود.
3. **کامنتِ نیمه:** نیمی از کد را موقتاً کامنت کن؛ اگر مشکل رفت، مقصر همان نیمه بود.

![کارتِ جعبه‌ابزارِ شکارچیِ باگ با سه پنل: PRINT PROBE ذره‌بین روی پنجرهٔ Serial با جریانِ عددیِ وسطِ زنجیرهٔ سنسور-مغز-موتور؛ UNPLUG HALF دستی که یک سیمِ جامپر را از نیمهٔ محوشدهٔ مدار جدا می‌کند؛ COMMENT HALF ویرایشگرِ کد با بلوکی از خط‌های کامنت‌شده؛ پایین، روبانِ طلاییِ ONE CHANGE AT A TIME کنارِ دفترچهٔ مهندسی و مداد](/lesson-assets/t5-s10-capstone-debug/prompt/02-image-debug-toolbox.png)

و دو قانونِ شکار: اول، هر بار فقط **یک** چیز را عوض کن (همان قانونِ یکی‌یکی — وگرنه نمی‌فهمی کدام تغییر اثر کرد)؛ دوم، هر تست و نتیجه‌اش را همان لحظه در دفترچه بنویس — شکارچیِ بی‌دفترچه، دورِ خودش می‌چرخد.

> 💡 **نکته:** همیارِ همیشگی‌ات را هم فراموش نکن — می‌توانی کدت را به AI بدهی و نظرش را دربارهٔ مظنون‌ها بپرسی. با همان سه قانونِ همیشگی: «اول خودت، بعد AI»، «خط‌به‌خط بخوان»، و «AI هم اشتباه می‌کند». پیشنهادهای AI مظنون‌های خوبی می‌سازند، ولی حکمِ نهایی را فقط آزمایشِ خودت صادر می‌کند.

## چالش: ۱۲۸ آهنگ چند تست می‌خواهد؟

با تقسیمِ دودویی، پیداکردنِ یک آهنگِ خراب بین ۱۲۸ آهنگ حداکثر چند تست می‌خواهد؟ و چرا «هر بار فقط یک چیز را عوض کن» برای این روش حیاتی است؟

---

**جواب:** هفت تست. هر تست تعداد را نصف می‌کند: ۱۲۸ ← ۶۴ ← ۳۲ ← ۱۶ ← ۸ ← ۴ ← ۲ ← ۱، یعنی هفت بار نصف‌کردن. و «فقط یک چیز را عوض کن» حیاتی است چون اگر همزمان دو چیز را تغییر بدهی و مشکل حل شود، هیچ‌وقت نمی‌فهمی کدام تغییر مقصر بود — و دفعهٔ بعد باز گیر می‌کنی. تقسیمِ دودویی فقط وقتی جواب می‌دهد که هر تست، جوابِ یک سؤالِ تک و روشن باشد.

حالا شکارِ واقعی. برو سراغ بخشِ مسیر خودت.

## مسیر A — پروندهٔ ایستگاهِ دوم

**پرونده:** پیشخدمتِ من ایستگاهِ اول را تمیز تحویل می‌دهد، ولی بعد از آن **گاهی** به‌جای گرفتنِ خط، همان‌جا شروع می‌کند دورِ خودش چرخیدن و دیگر هیچ‌وقت خط را پیدا نمی‌کند.

پس نصفش کن. زنجیره: دنیا/سنسور ← مغزِ PID ← موتور. مرزِ دو نیمه یعنی ورودیِ مغز. یک کاوشگرِ print موقت اولِ `pidStep` می‌گذاری که سه سنسور را خام چاپ کند (این چاپ موقتی است و در نسخهٔ نهایی نیست):

</div>

```cpp
  Serial.print(l);
  Serial.print(m);
  Serial.println(r);   // KAVOSHGAR-e movaghat - bad az shekar hazf mishavad
```

<div dir="rtl">

اجرای خراب را تکرار می‌کنی و به چاپ‌ها نگاه می‌کنی: درست بعد از عبورِ کور از نوار، پشت‌سرهم `000` — سفیدِ مطلق. پس مغز و موتور تبرئه‌اند: چرخیدنِ دورِ خود، دقیقاً همان رفتارِ درستِ «جست‌وجوی خطِ گم‌شده» فصل ۴ است؛ مغز دارد کارش را عالی انجام می‌دهد، فقط دنیا چیزی برای دیدن به او نمی‌دهد! سؤالِ واقعی این است: چرا ربات آن‌جا از خط بیرون است؟ متر می‌آوری: نوارِ ایستگاهِ دومِ من نزدیکِ قوس است و عبورِ کورِ `BLIND_MS` میلی‌ثانیه‌ای، ربات را از قوس **رد می‌کند** — مقصر پیدا شد، با سه تست به‌جای ده‌ها تستِ کورکورانه. دو درمان: نوارِ ایستگاه را جای صاف‌تری ببر (قانونِ ترم ۳: نوارِ عرضی روی قوس ممنوع!) یا `BLIND_MS` را کم کن. هر دو را در دفترچه ثبت کن.

حالا پایداری. سه ارتقای milestone سه:

1. **softStart:** راه‌افتادنِ ناگهانی لیوان را می‌پراند؛ حلقه‌ای که با `tank` سرعت را پله‌پله از ۱۵۰ تا نزدیکِ `BASE` بالا می‌برد — در استارت و بعد از هر ایستگاه.
2. **failsafe گم‌شدنِ خط:** اگر جست‌وجوی فصل ۴ حدود سه ثانیه نتیجه نداد، حالتِ SAFE — توقفِ امن با سینیِ تراز؛ همان الگوی timeout با شمارندهٔ ترم ۳، چون رباتِ گم‌شده با لیوان نباید تا ابد دورِ خودش برقصد.
3. **گزارشِ پایانِ شیفت** با کرنومترِ millis فصل ۳ — عددی نمایش‌پسند که داور دوستش دارد.

برنامهٔ کامل — همان فایلِ فصل ۹ به‌علاوهٔ پایداریِ امروز (فایل `path-a/waiter_final.ino`). کاوشگرهای print موقت، طبقِ قانونِ شکار بعد از حلِ پرونده حذف شده‌اند:

</div>

```cpp
// Term 5 - Session 10 - Path A: Milestone 3 - payedari (noskheye nahayi-e nemayesh)
// jadid nesbat be jalase 9: softStart (livan ja nakhorad), failsafe-e gom shodan-e
// khat (tavaghof-e amn bad az jostojoo-ye natije-nadade), gozaresh-e payan-e shift
// adad-haye pich-haye tanzim ra ba jadval-e daftarche-ye KHODET yeki kon!

// ---------- pin-ha ----------
const int ENA = 32;       // sorat-e motor-e chap (PWM)
const int IN1 = 26;       // motor-e chap - jolo
const int IN2 = 27;       // motor-e chap - aghab
const int IN3 = 14;       // motor-e rast - jolo
const int IN4 = 25;       // motor-e rast - aghab
const int ENB = 33;       // sorat-e motor-e rast (PWM)
const int S_LEFT = 34;    // sensor-e khat - chap
const int S_MID = 35;     // sensor-e khat - vasat
const int S_RIGHT = 36;   // sensor-e khat - rast
const int SERVO_PIN = 13; // bazoo-ye servo SG90

const int BLACK = 1;      // gharardad-e term 3

// ---------- pich-haye tanzim (nahayi - az daftarche!) ----------
float KP = 120.0;             // adad-haye nahayi-e khodet!
float KD = 500.0;
float KI = 0.3;
const float MAX_I = 150.0;    // gire-ye kise-ye integral (j4)
const int BASE = 420;         // sorat-e paye ba livan
const int SEARCH_SPEED = 400; // jostojoo-ye khat-e gomshode (j4)
const int STATIONS = 2;       // tedad-e istgah-haye tahvil
const int BLIND_MS = 450;     // obur-e koor az navar bad az tahvil
const int LOOP_MS = 10;       // zarban-e sabet-e halghe (j4)
const int LOST_LIMIT = 300;   // ~3 sanie jostojoo (door-haye 10ms) -> tavaghof-e amn

int stationsDone = 0;
float integral = 0.0;
float lastError = 0.0;
int lostCount = 0;            // chand door ast hich sensori khat nemibinad?
unsigned long startMs = 0;    // shoroo-e shift (kernometr-e j3)
String state = "FOLLOW";      // FOLLOW / STATION / SAFE / DONE

// --- kalibrasion-e motor-ha (adad-haye term 3 jalase 4-e KHODET) ---
const float FACTOR_LEFT = 0.94;
const float FACTOR_RIGHT = 1.0;

// ---------- servo / bazoo ----------
void servoWrite(int angle) {
  // 0..180 daraje -> duty-e 16-bit: 1638 (0.5ms) ta 7864 (2.4ms), hamun baze-ye T2 j8
  int duty = 1638 + angle * (7864 - 1638) / 180;
  ledcWrite(SERVO_PIN, duty);
}

void armCarry() {
  servoWrite(90);   // halat-e haml: sini terazoo
}

void armServe() {
  // harekat-e NARAM: pele-pele, livan nariz!
  for (int a = 90; a >= 25; a = a - 2) {
    servoWrite(a);
    delay(25);
  }
  delay(1500);   // "befarmaid!"
  for (int a = 26; a <= 90; a = a + 2) {
    servoWrite(a);
    delay(25);
  }
}

// ---------- motor-ha (block-e jalase 4) ----------
float clampF(float value, float low, float high) {
  if (value < low) {
    return low;
  }
  if (value > high) {
    return high;
  }
  return value;
}

void tank(float left, float right) {
  digitalWrite(IN1, HIGH);
  digitalWrite(IN2, LOW);
  digitalWrite(IN3, HIGH);
  digitalWrite(IN4, LOW);
  ledcWrite(ENA, clampF(left * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(right * FACTOR_RIGHT, 0, 1023));
}

void turnLeft(int speed) {
  digitalWrite(IN1, LOW);    // chap aghab
  digitalWrite(IN2, HIGH);
  digitalWrite(IN3, HIGH);   // rast jelo
  digitalWrite(IN4, LOW);
  ledcWrite(ENA, clampF(speed * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(speed * FACTOR_RIGHT, 0, 1023));
}

void turnRight(int speed) {
  digitalWrite(IN1, HIGH);   // chap jelo
  digitalWrite(IN2, LOW);
  digitalWrite(IN3, LOW);    // rast aghab
  digitalWrite(IN4, HIGH);
  ledcWrite(ENA, clampF(speed * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(speed * FACTOR_RIGHT, 0, 1023));
}

void stopMotors() {
  ledcWrite(ENA, 0);
  ledcWrite(ENB, 0);
  digitalWrite(IN1, LOW);
  digitalWrite(IN2, LOW);
  digitalWrite(IN3, LOW);
  digitalWrite(IN4, LOW);
}

void softStart() {
  // narm rah bioft - livan ja nakhorad! (payedari-e j10)
  for (int s = 150; s <= BASE; s = s + 50) {
    tank(s, s);
    delay(40);
  }
}

// ---------- maghz-e khat (PID - block-e jalase 4) ----------
int errorFrom(bool l, bool m, bool r) {
  if (l && m) {
    return -1;
  }
  if (r && m) {
    return 1;
  }
  if (l) {
    return -2;
  }
  if (r) {
    return 2;
  }
  return 0;
}

void pidStep() {
  bool l = (digitalRead(S_LEFT) == BLACK);
  bool m = (digitalRead(S_MID) == BLACK);
  bool r = (digitalRead(S_RIGHT) == BLACK);

  if (!l && !m && !r) {
    // khat gom shod: kise khali + charkhesh be samt-e akharin khata (j4)
    integral = 0.0;
    if (lastError > 0) {
      turnRight(SEARCH_SPEED);
    } else {
      turnLeft(SEARCH_SPEED);
    }
    return;
  }

  float error = errorFrom(l, m, r);
  integral = clampF(integral + error, -MAX_I, MAX_I);
  float derivative = error - lastError;
  lastError = error;
  float diff = KP * error + KI * integral + KD * derivative;
  tank(BASE + diff, BASE - diff);
}

bool lineSeen() {
  // aya alan hade-aghal yek sensor khat ra mibinad?
  bool l = digitalRead(S_LEFT) == BLACK;
  bool m = digitalRead(S_MID) == BLACK;
  bool r = digitalRead(S_RIGHT) == BLACK;
  return l || m || r;
}

bool atStation() {
  // emzaye 1-1-1: har se sensor siah = istgah
  bool l = digitalRead(S_LEFT) == BLACK;
  bool m = digitalRead(S_MID) == BLACK;
  bool r = digitalRead(S_RIGHT) == BLACK;
  return l && m && r;
}

void setup() {
  Serial.begin(115200);

  pinMode(IN1, OUTPUT);
  pinMode(IN2, OUTPUT);
  pinMode(IN3, OUTPUT);
  pinMode(IN4, OUTPUT);
  ledcAttach(ENA, 1000, 10);
  ledcAttach(ENB, 1000, 10);
  ledcAttach(SERVO_PIN, 50, 16);

  pinMode(S_LEFT, INPUT);
  pinMode(S_MID, INPUT);
  pinMode(S_RIGHT, INPUT);

  stopMotors();
  armCarry();

  Serial.println("check-list: battery? sini terazoo? khat tamiz? livan rooye sini?");
  for (int n = 5; n >= 1; n = n - 1) {
    Serial.println(n);
    delay(1000);
  }
  Serial.println("GO! shift-e pishkhedmat shoroo shod");
  startMs = millis();
  softStart();   // narm rah bioft
}

void loop() {
  if (state == "FOLLOW") {
    if (atStation()) {
      state = "STATION";
    } else {
      if (lineSeen()) {
        lostCount = 0;
      } else {
        lostCount = lostCount + 1;   // pidStep dar in halat khodesh migardad (j4)
      }
      if (lostCount > LOST_LIMIT) {
        state = "SAFE";              // failsafe: jostojoo natije nadad
      } else {
        pidStep();
      }
    }
  }
  else if (state == "STATION") {
    stopMotors();
    stationsDone = stationsDone + 1;
    Serial.print("istgah-e ");
    Serial.print(stationsDone);
    Serial.println(" -> tahvil-e livan");
    armServe();
    if (stationsDone >= STATIONS) {
      state = "DONE";
    } else {
      softStart();             // narm rah bioft (livan!)
      tank(BASE, BASE);        // KOOR az navar rad sho
      delay(BLIND_MS);
      integral = 0.0;
      lastError = 0.0;
      lostCount = 0;
      state = "FOLLOW";
    }
  }
  else if (state == "SAFE") {
    stopMotors();
    armCarry();
    Serial.println("khat gom shod - tavaghof-e amn. zamin va adad-haye tanzim ra check kon");
    while (true) {
      delay(1000);   // montazer-e reset - livan hanuz salem ast!
    }
  }
  else if (state == "DONE") {
    stopMotors();
    Serial.println("shift tamam! hame-ye istgah-ha service shodand");
    Serial.print("zaman-e shift: ");
    Serial.print((millis() - startMs) / 1000);
    Serial.println(" sanie");
    while (true) {
      delay(1000);
    }
  }
  delay(LOOP_MS);
}
```

<div dir="rtl">

✅ **چک کن:** ربات نرم راه می‌افتد (لیوان جا نمی‌خورد)، دو ایستگاه را تمیز سرویس می‌دهد، و اگر خط را گم کرد به‌جای رقصیدنِ بی‌پایان، بعد از حدود سه ثانیه SAFE می‌شود و می‌ایستد. آخرِ شیفت، زمانِ کلِ کار در Serial چاپ می‌شود.

> 🔧 **اگر کار نکرد:** حالتِ SAFE الکی فعال می‌شود؟ `LOST_LIMIT` برای قوس‌های تندِ تو کوتاه است یا لبهٔ نوار کنده — لبه‌ها را بچسبان و `LOST_LIMIT` را کمی زیاد کن، ولی نه آن‌قدر که رباتِ گم‌شده تا تهِ اتاق برود. کاوشگرِ ما پشت‌سرهم `000` نشان داد؛ اگر به‌جایش پشت‌سرهم `111` می‌دیدی، مظنونِ اصلی این بود که ربات هنوز روی نوارِ عرضی مانده — یعنی عبورِ کور کوتاه است.

> 💡 **نکته:** برای تمرینِ «نصفش کن» یک کپی از پروژه‌ات بساز، یک باگِ عمدی در آن بکار و با کاوشگرِ print شکارش کن — چون خودت باگ را گذاشته‌ای، جوابِ درست را می‌دانی و فقط روش را تمرین می‌کنی. `failsafe` را هم تست کن: هر سه سنسورِ خط را روی سفید نگه دار و ورود به SAFE را ببین.

> 🧪 **آزمایشگاه:** [آزمایشگاه](/lab) باشگاهِ تمرینِ «نصفش کن» است، چون شرایطش صددرصد تکرارپذیر است — همان تمرینِ بالا را می‌توانی همان‌جا بکنی، بدونِ ترسِ لیوان و باتری: کد را دستکاری کن، یک باگِ عمدی بکار و با `Serial.println` شکارش کن. صفحهٔ این فصل **مسیر A** را اجرا می‌کند و ورود به حالتِ SAFE هم همان‌جا دیدنی است. **مسیر C** (ژیروسکوپ و BLE) و **مسیر B** (شبکه) اجرا نمی‌شوند و failsafeهایشان فقط روی برد واقعی آزمودنی‌اند. و چیزی که هیچ شبیه‌سازی نشان نمی‌دهد دقیقاً موضوعِ بخشِ بعد است: باتریِ خسته، سیمِ شل و لبهٔ کندهٔ نوار.

### چالش مسیر A: اگر کاوشگر `111` نشان می‌داد؟

کاوشگرِ ما `000`های پشت‌سرهم نشان داد و مقصر، جای نوارِ ایستگاه بود. اگر به‌جایش `111`های پشت‌سرهم می‌دیدی، مظنونِ اصلی چه می‌شد؟

---

**جواب:** `111` یعنی هر سه سنسور سیاه می‌بینند — ربات هنوز روی نوارِ عرضی مانده و از آن رد نشده. پس مظنون این است که عبورِ کورِ `BLIND_MS` **کوتاه** بوده و ربات کاملاً از نوار عبور نکرده؛ ماشینِ حالت مدام آن را ایستگاه می‌بیند و در STATION گیر می‌کند. درمانش زیاد کردنِ `BLIND_MS` است تا ربات مطمئناً از نوارِ عریض بگذرد — درست برعکسِ پروندهٔ `000` که مشکلش جای نوار روی قوس بود.

## مسیر B — پروندهٔ داشبوردِ یخ‌زده

**پرونده:** داشبوردِ من عالی کار می‌کند... تا وقتی چند بار گزارشِ AI می‌گیرم؛ بعد از آن کلِ سایت یخ می‌زند — نه داشبورد، نه گزارش.

زنجیره: سنسور ← سرور ← اینترنت/AI. نصفش کن با ابزارِ سوم — کامنتِ نیمه: خطِ تماسِ AI را موقتاً کامنت می‌کنی و به‌جایش یک متنِ ثابت برمی‌گردانی. ده دقیقه، بیست رفرش، پنجاه رفرش... یخ نمی‌زند! پس نیمهٔ سنسور و سرورِ پایه تبرئه؛ مقصر در مسیرِ گزارشِ AI است. کامنت را برمی‌داری و این بار موقعِ خرابی به Shell نگاه می‌کنی:

</div>

```text
Traceback (most recent call last):
  File "<stdin>", line 162, in <module>
OSError: [Errno 104] ECONNRESET
```

<div dir="rtl">

`ECONNRESET` یعنی «آن‌طرف، وسطِ حرفم قطع کرد» — گوشیِ من وسطِ بارگیریِ گزارشِ کندِ AI از صفحه بیرون رفته و برنامهٔ من درست همان‌جا، وسطِ `send`، ترکیده. حلقهٔ `while True` هیچ try/except ای ندارد، پس با همین یک خطا کلِ برنامه می‌ایستد و سروری نمی‌ماند که جواب بدهد — یخ‌زدگی! و اگر خطا را فقط با try بگیری، تلهٔ بعدی منتظر است: چون بعد از خطا به `conn.close()` نمی‌رسی، آن ارتباط **باز می‌ماند** و چند بار که تکرار شود، سرور دیگر جا برای ارتباطِ تازه ندارد. این باگِ کلاسیک اسم هم دارد: نشتیِ socket.

درمانِ milestone سه:

1. کلِ رسیدگی به درخواست داخلِ try/except، و `conn.close()` **بیرونِ** آن که در هر حالتی اجرا شود — قانونِ قاب‌کردنیِ امروز: **دری را که باز کردی در هر حالتی ببند.**
2. `safe_report`: کمربندِ ایمنی دورِ تماسِ AI — اینترنت قطع؟ جوابِ عجیب؟ حافظه پر؟ کاربر همیشه یک جملهٔ محترمانه می‌بیند، نه صفحهٔ مرده؛ و تمیزکاریِ `replace` ترم ۴ هم ستاره‌های Markdown را از جواب می‌روبد.
3. **هشدارِ همیشه‌بیدار:** تا امروز قلبِ هشدار فقط با درخواستِ مرورگر می‌تپید — edge case: مرورگر بسته، اتاق داغ، هشدار خواب! درمانش `settimeout` روی سرور است: به `accept` می‌گوییم حداکثر دو ثانیه منتظر بمان — دقیقاً همان کاری که `time_pulse_us` ترم ۲ با مهلتش می‌کرد. نیامد؟ خطای مهلتش را می‌گیریم و می‌رویم سراغِ سنسورها و هشدارها، و باز برمی‌گردیم.
4. `wifi_check`: اگر WiFi افتاد، خودش برمی‌گردد — خوددرمانی.

برنامهٔ کامل — نسخهٔ نهاییِ نمایش (فایل `path-b/assistant_final.py`):

</div>

```python
# Term 5 - Session 10 - Path B: Milestone 3 - payedari (noskheye nahayi-e nemayesh)
# jadid nesbat be jalase 9: hoshdar-e HAMISHE-bidar (timeout rooye accept),
# gozaresh-e AI ba kamarband-e imeni, bastan-e zemanat-shode-ye ertebat-ha,
# va khod-darmani-e WiFi
import network
import socket
import time
import dht
import machine
import urequests
import json
import gc
from machine import Pin, ADC

from secrets import WIFI_SSID, WIFI_PASS, GEMINI_API_KEY

# ---------- pin-ha (pin-map-e sabet) ----------
sensor_dht = dht.DHT11(Pin(16))
ldr = ADC(Pin(35))
ldr.atten(ADC.ATTN_11DB)
trig = Pin(5, Pin.OUT)
echo = Pin(18, Pin.IN)
buzzer = machine.PWM(Pin(4), freq=1000, duty=0)
led_alert = Pin(25, Pin.OUT)

# ---------- pich-haye tanzim (nahayi - az daftarche!) ----------
AI_MODEL = "gemini-flash-latest"   # esm-e model dar jadval-e jozve: dar zaman-e zabt check shavad
TEMP_ON = 31
TEMP_OFF = 29
VISIT_CM = 40

alarm_on = False
visitors = 0
someone_there = False

# ---------- sensor-ha (term 2) ----------
def read_temp_hum():
    try:
        sensor_dht.measure()
        return (sensor_dht.temperature(), sensor_dht.humidity())
    except OSError:
        return (-1, -1)   # -1 yani "in bar nashod"

def read_light():
    return ldr.read()

def read_distance_cm():
    trig.value(0)
    time.sleep_us(2)
    trig.value(1)
    time.sleep_us(10)
    trig.value(0)
    t = machine.time_pulse_us(echo, 1, 30000)
    if t < 0:
        return -1
    return t // 58

def beep(times):
    for i in range(times):
        buzzer.duty(512)
        time.sleep(0.12)
        buzzer.duty(0)
        time.sleep(0.08)

def check_alerts(temp, dist):
    # hoshdar ba hysteresis (term 2 j4) + shomarande-ye raft-o-amad
    global alarm_on, visitors, someone_there
    if alarm_on == False and temp >= TEMP_ON:
        alarm_on = True
        beep(3)
        print("HOSHDAR: otagh kheyli garm ast!")
    if alarm_on == True and temp >= 0 and temp <= TEMP_OFF:
        alarm_on = False
        print("hoshdar tamam: dama bargasht be mahdude-ye khoob")
    if alarm_on:
        led_alert.value(1)
    else:
        led_alert.value(0)

    if dist > 0 and dist < VISIT_CM and someone_there == False:
        someone_there = True
        visitors = visitors + 1
    if (dist < 0 or dist >= VISIT_CM) and someone_there == True:
        someone_there = False

# ---------- AI (olgu-ye term 4 j9) ----------
def ask_ai(question):
    gc.collect()
    url = "https://generativelanguage.googleapis.com/v1beta/models/" + AI_MODEL + ":generateContent"
    body = {"contents": [{"parts": [{"text": question}]}]}
    headers = {"Content-Type": "application/json", "x-goog-api-key": GEMINI_API_KEY}
    r = urequests.post(url, headers=headers, data=json.dumps(body))
    data = r.json()
    r.close()
    answer = data["candidates"][0]["content"]["parts"][0]["text"]
    return answer

def build_report_prompt(temp, hum, light, dist):
    p = "You are a friendly room assistant for a teenager."
    p = p + " Room data: temperature=" + str(temp) + " C, humidity=" + str(hum) + " %,"
    p = p + " light=" + str(light) + " (0=dark, 4095=bright),"
    p = p + " visitors so far=" + str(visitors) + "."
    p = p + " Write a short warm report in PERSIAN (2-3 sentences) with one tip."
    return p

def safe_report(temp, hum, light, dist):
    # gozaresh-e AI ba kamarband-e imeni (payedari-e j10)
    try:
        answer = ask_ai(build_report_prompt(temp, hum, light, dist))
        answer = answer.replace("*", "")   # tamizkari-e javab (term 4 j10)
        return answer
    except OSError:
        return "gozaresh dar dastres nist - internet ya server-e AI moshkel darad"
    except:
        gc.collect()
        return "yek moshkel-e gheyre-montazere pish amad - dobare talash kon"

# ---------- safhe-ha ----------
def build_page(temp, hum, light, dist):
    html = f"""<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>AIRO</title>
<meta http-equiv="refresh" content="5"></head>
<body style="font-family:sans-serif;text-align:center;background:#111;color:#eee">
<h1>Dastyar-e otagh</h1>
<p>Dama: {temp} C | Rotubat: {hum} %</p>
<p>Noor: {light} / 4095</p>
<p>Fasele: {dist} cm | Raft-o-amad: {visitors}</p>
<p>Hoshdar-e garma: {alarm_on}</p>
<p><a href="/report">gozaresh-e AI begir</a></p>
</body></html>"""
    return html

def report_page(text):
    html = f"""<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>AIRO report</title></head>
<body style="font-family:sans-serif;text-align:center;background:#111;color:#eee">
<h1>Gozaresh-e AI</h1>
<p dir="rtl" style="font-size:1.2em;max-width:600px;margin:auto">{text}</p>
<p><a href="/">bargasht be dashboard</a></p>
</body></html>"""
    return html

# ---------- WiFi ----------
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect(WIFI_SSID, WIFI_PASS)
print("dar hal-e vasl shodan be WiFi...")
while not wlan.isconnected():
    time.sleep(0.5)
print("vasl shod! IP:", wlan.ifconfig()[0])

def wifi_check():
    # khod-darmani: agar WiFi oftad, khodemun bargardim (edge case - j10)
    if wlan.isconnected():
        return
    print("WiFi ghat shod - talash baraye ettesal-e dobare...")
    wlan.connect(WIFI_SSID, WIFI_PASS)
    count = 0
    while not wlan.isconnected() and count < 20:
        time.sleep(0.5)
        count = count + 1

# ---------- server-e paydar ----------
addr = socket.getaddrinfo("0.0.0.0", 80)[0][-1]
server = socket.socket()
server.bind(addr)
server.listen(1)
server.settimeout(2)   # hadaksar 2 sanie montazer bemani (mesl-e timeout-e time_pulse_us!)
print("dastyar-e PAYDAR amade ast - dashboard ra baz kon")

while True:
    wifi_check()
    temp, hum = read_temp_hum()
    light = read_light()
    dist = read_distance_cm()
    check_alerts(temp, dist)   # ghalb-e hoshdar HAMISHE mizanad - hata bi-morurgar!

    try:
        conn, client = server.accept()
    except OSError:
        continue   # kasi nayamad - bargard bala: sensor-ha va hoshdar-ha

    try:
        request = str(conn.recv(1024))
        if "GET /report" in request:
            page = report_page(safe_report(temp, hum, light, dist))
        else:
            page = build_page(temp, hum, light, dist)
        conn.send("HTTP/1.1 200 OK\r\nContent-Type: text/html; charset=utf-8\r\n\r\n")
        conn.send(page)
    except OSError:
        print("yek darkhast kharab shod - server zende mimanad")
    conn.close()   # HATMAN bebandim - dars-e bozorg-e emrooz! (neshti-e socket)
    gc.collect()
```

<div dir="rtl">

> 🔧 **یک استثنای کوچک:** خطای نادرِ `Exception: checksum error` که در ترم ۲ دیدی از خانوادهٔ `OSError` نیست و `read_temp_hum` آن را نمی‌گیرد، پس برنامه در آن حالت هنوز می‌تواند بایستد. سیم را محکم کن و دوباره اجرا کن.

✅ **چک کن:** گوشی را وسطِ بارگیریِ گزارش ببند — سرور نمی‌میرد و داشبورد باز هم جواب می‌دهد. مرورگر را کاملاً ببند و اتاق را داغ کن — آژیر باز هم می‌تپد و پیامِ هشدار در Shell چاپ می‌شود. WiFi را قطع و وصل کن — خودش برمی‌گردد.

> 🔧 **اگر کار نکرد:** باز `ECONNRESET` در Shell می‌بینی؟ طبیعی است که مرورگر وسطِ جواب برود؛ نسخهٔ نهایی همین را با try/except و `conn.close()` تضمینی می‌بلعد و سرور زنده می‌ماند. هشدار با مرورگرِ بسته نمی‌تپد؟ نسخهٔ قدیمیِ بدونِ `settimeout` هنوز روی برد است — نسخهٔ نهایی را ذخیره کن و با Shell چک کن که پیامِ هشدار حتی بدونِ هیچ درخواستی چاپ می‌شود.

> 💡 **نکته:** پایداریِ مسیر B را فقط روی سخت‌افزارِ واقعی می‌شود کامل سنجید، چون قلبِ ماجرا اینترنت و تماسِ زندهٔ AI است. شبیه‌ساز این‌جا کمکی نمی‌کند؛ به‌جایش با گوشیِ واقعی «مرورگر را وسطِ کار ببند» را چند بار تکرار کن و ببین سرور سالم می‌ماند.

### چالش مسیر B: چرا کامنتِ نیمه بهتر بود؟

چرا کامنت‌کردنِ نیمهٔ AI، تستِ بهتری بود تا اینکه از اول Shell را تماشا کنیم؟

---

**جواب:** چون خطا «گاهی» می‌آمد. اگر فقط Shell را تماشا می‌کردیم، باید مدتِ طولانی منتظر می‌ماندیم تا شاید خطا یک بار رخ بدهد — و حتی آن‌وقت هم فقط جای ترکیدن را می‌دیدیم، نه اینکه کدام نیمه مقصر است. با کامنت‌کردنِ نیمهٔ AI و دیدنِ اینکه بدونِ آن ده دقیقه و پنجاه رفرش هیچ یخی نمی‌زند، در یک تست کلِ نیمهٔ سنسور و سرور را یک‌جا تبرئه کردیم و مطمئن شدیم مقصر در مسیرِ گزارشِ AI است.

## مسیر C — پروندهٔ ایستِ مرموز

**پرونده:** وسطِ مسابقه، رباتِ من **گاهی** بی‌هوا خشکش می‌زند؛ دو ثانیه بعد بوق می‌زند و دوباره فرمان می‌گیرد، انگار نه انگار.

زنجیرهٔ مظنون‌ها این بار دو شاخهٔ موازی است: سیستمِ رادیو (گوشی/BLE) و سیستمِ تغذیه (باتری/موتور). نصفش کن با ابزارِ دوم — قطعِ نیمه: رادیو را از معادله حذف می‌کنی؛ ربات را به حالتِ خودران می‌فرستی (که به گوشی نیاز ندارد) و روی خط می‌دوانی... و همان‌جا، وسطِ یک پیچِ تند: خشک شد! پس رادیو تبرئه است — مشکل در نیمهٔ تغذیه است. حالا کاوشگر: به Serial Monitor وصل می‌مانی و لحظهٔ خرابی این را می‌بینی:

</div>

```text
Brownout detector was triggered

ets Jun  8 2016 00:22:57
rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
```

<div dir="rtl">

آشنای قدیمیِ ترم ۳! ‏Brownout یعنی ولتاژ یک لحظه آن‌قدر افتاد که برد از ترس ریست کرد — پیچِ تند + موتوری که PID تا نزدیکِ حداکثر می‌راندش + باتری‌های خسته = افتِ ولتاژ. برد بعد از ریست از اول `setup` شروع می‌کند، پس حالت به MANUAL برمی‌گردد، گوشی باید دوباره وصل شود و خودران را باید دوباره بزنی. «گاهی» بودنش هم حل شد: فقط در پیچ‌های تندِ پرمصرف رخ می‌داد. درمان: باتریِ تازه برای اجراهای مهم (قانونِ ترم ۳) و در دفترچه: «دندهٔ ۳ فقط با باتریِ پر».

حالا پایداریِ milestone سه:

1. **کلیدِ مردِ مرده:** اسمِ واقعی‌اش در قطارها همین است — ربات در حالتِ دستی فقط تا دو ثانیه بعد از آخرین فرمان می‌تازد؛ فرمانِ تازه‌ای نیامد (چون BLE قطع شده، اپ بسته شده یا گوشی خوابیده) خودش می‌ایستد. رباتِ بی‌راننده حق تاختن ندارد. (خودران عمداً مستثناست: راننده‌اش را با خودش دارد.) برای تاختِ پیوسته، فرمانِ F را هر یکی‌دو ثانیه تازه کن.
2. **خروجِ امن از خودران:** اگر خط حدود دو ثانیه گم ماند، به‌جای رقصیدنِ بی‌پایانِ جست‌وجو، توقف و پیامِ «dasti bebar!» به گوشی.
3. **کرنومترِ دور:** نوارِ عرضی ۱-۱-۱ می‌شود خطِ شروع/پایان؛ هر عبور در خودران، زمانِ دور را با millis می‌گیرد و به گوشی می‌فرستد؛ عبورهای پشت‌سرهم تا سه ثانیه یکی حساب می‌شوند که یک نوار دو بار شمرده نشود.

برنامهٔ کامل — نسخهٔ نهاییِ مسابقه (فایل `path-c/racer_final.ino`):

</div>

```cpp
// Term 5 - Session 10 - Path C: Milestone 3 - payedari (noskheye nahayi-e nemayesh)
// jadid nesbat be jalase 9: failsafe-e "kelide marde morde" (farman naresid = ist),
// khorooj-e amn az khodran vaghti khat gom shod, va kernometr-e dor-e mosabeghe
// adad-haye pich-haye tanzim ra ba jadval-e daftarche-ye KHODET yeki kon!

#include <BLEDevice.h>
#include <BLEServer.h>
#include <BLE2902.h>
#include <Wire.h>
#include <MPU6050_light.h>

// --- UUID-haye standard-e "Nordic UART" (jalase 6) ---
#define SERVICE_UUID "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
#define RX_UUID      "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
#define TX_UUID      "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"

BLECharacteristic *rxChar;   // keshoo-ye farman-haye gooshi (jalase 6)
BLECharacteristic *txChar;   // keshoo-ye javab-haye ma

MPU6050 mpu(Wire);           // ketabkhane-ye MPU6050_light (jalase 5)

// ---------- pin-ha (pin-map-e sabet) ----------
const int ENA = 32;     // sorat-e motor-e chap (PWM)
const int IN1 = 26;     // motor-e chap - jolo
const int IN2 = 27;     // motor-e chap - aghab
const int IN3 = 14;     // motor-e rast - jolo
const int IN4 = 25;     // motor-e rast - aghab
const int ENB = 33;     // sorat-e motor-e rast (PWM)
const int S_LEFT = 34;  // sensor-e khat - chap
const int S_MID = 35;   // sensor-e khat - vasat
const int S_RIGHT = 36; // sensor-e khat - rast
const int BUZZER = 4;   // boogh-e hoshdar (tanzim-e jalase 5)

const int BLACK = 1;    // gharardad-e term 3

// ---------- pich-haye tanzim (nahayi - az daftarche!) ----------
int speeds[] = {400, 600, 850};   // dande-haye 1 / 2 / 3
int gear = 1;
float KP = 150.0;                 // adad-haye nahayi-e khodet!
float KD = 600.0;
float KI = 0.4;
const float MAX_I = 150.0;        // gire-ye kise-ye integral (j4)
const int BASE = 550;             // sorat-e paye-ye khodran (j4)
const int SEARCH_SPEED = 450;     // jostojoo-ye khat-e gomshode (j4)
const float TILT_LIMIT = 35.0;    // daraje
const int LOST_LIMIT = 200;       // ~2 sanie (door-haye 10ms): khodran khamush
const int FAILSAFE_MS = 2000;     // kelide marde morde: farman naresid -> ist

String mode = "MANUAL";           // MANUAL / AUTO / TILT
float integral = 0.0;
float lastError = 0.0;
int lostCount = 0;
bool driving = false;             // aya alan ba farman-e dasti dar harekat-im?
unsigned long lastCmdMs = 0;      // akharin farman-e reside (kernometr-e j3)
unsigned long lastTiltCheck = 0;
unsigned long lapStart = 0;       // kernometr-e dor
unsigned long lastLap = 0;        // akharin obur az khat-e payan
int laps = 0;

// --- kalibrasion-e motor-ha (adad-haye term 3 jalase 4-e KHODET) ---
const float FACTOR_LEFT = 0.94;
const float FACTOR_RIGHT = 1.0;

// ---------- block-e BLE (copy az jalase 6) ----------
void bleSetup() {
  BLEDevice::init("AIRO-RACER");
  BLEServer *server = BLEDevice::createServer();
  BLEService *service = server->createService(SERVICE_UUID);
  rxChar = service->createCharacteristic(RX_UUID, BLECharacteristic::PROPERTY_WRITE);
  txChar = service->createCharacteristic(TX_UUID, BLECharacteristic::PROPERTY_NOTIFY);
  txChar->addDescriptor(new BLE2902());
  service->start();
  server->getAdvertising()->start();
}

char bleRead() {
  String v = rxChar->getValue();
  if (v.length() > 0) {
    rxChar->setValue("");
    return v.charAt(0);
  }
  return 0;
}

void bleSend(String msg) {
  txChar->setValue(msg);
  txChar->notify();
}

// ---------- block-e MPU6050 (copy az jalase 5) ----------
void mpuSetup() {
  Wire.begin();   // SDA=21 SCL=22
  int status = mpu.begin();
  Serial.print("vaziat-e MPU (0 yani OK): ");
  Serial.println(status);
  while (status != 0) {
  }
  Serial.println("tekan nade... sefr-giri (robot SAF bashad!)");
  delay(1000);
  mpu.calcOffsets();
}

// ---------- motor-ha (block-e jalase 4 + aghab az jalase 6) ----------
float clampF(float value, float low, float high) {
  if (value < low) {
    return low;
  }
  if (value > high) {
    return high;
  }
  return value;
}

void tank(float left, float right) {
  digitalWrite(IN1, HIGH);
  digitalWrite(IN2, LOW);
  digitalWrite(IN3, HIGH);
  digitalWrite(IN4, LOW);
  ledcWrite(ENA, clampF(left * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(right * FACTOR_RIGHT, 0, 1023));
}

void back(int speed) {
  digitalWrite(IN1, LOW);
  digitalWrite(IN2, HIGH);
  digitalWrite(IN3, LOW);
  digitalWrite(IN4, HIGH);
  ledcWrite(ENA, clampF(speed * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(speed * FACTOR_RIGHT, 0, 1023));
}

void turnLeft(int speed) {
  digitalWrite(IN1, LOW);    // chap aghab
  digitalWrite(IN2, HIGH);
  digitalWrite(IN3, HIGH);   // rast jelo
  digitalWrite(IN4, LOW);
  ledcWrite(ENA, clampF(speed * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(speed * FACTOR_RIGHT, 0, 1023));
}

void turnRight(int speed) {
  digitalWrite(IN1, HIGH);   // chap jelo
  digitalWrite(IN2, LOW);
  digitalWrite(IN3, LOW);    // rast aghab
  digitalWrite(IN4, HIGH);
  ledcWrite(ENA, clampF(speed * FACTOR_LEFT, 0, 1023));
  ledcWrite(ENB, clampF(speed * FACTOR_RIGHT, 0, 1023));
}

void stopMotors() {
  ledcWrite(ENA, 0);
  ledcWrite(ENB, 0);
  digitalWrite(IN1, LOW);
  digitalWrite(IN2, LOW);
  digitalWrite(IN3, LOW);
  digitalWrite(IN4, LOW);
}

// ---------- maghz-e khat (PID - block-e jalase 4) ----------
int errorFrom(bool l, bool m, bool r) {
  if (l && m) {
    return -1;
  }
  if (r && m) {
    return 1;
  }
  if (l) {
    return -2;
  }
  if (r) {
    return 2;
  }
  return 0;
}

void pidStep() {
  bool l = (digitalRead(S_LEFT) == BLACK);
  bool m = (digitalRead(S_MID) == BLACK);
  bool r = (digitalRead(S_RIGHT) == BLACK);

  if (!l && !m && !r) {
    integral = 0.0;
    if (lastError > 0) {
      turnRight(SEARCH_SPEED);
    } else {
      turnLeft(SEARCH_SPEED);
    }
    return;
  }

  float error = errorFrom(l, m, r);
  integral = clampF(integral + error, -MAX_I, MAX_I);
  float derivative = error - lastError;
  lastError = error;
  float diff = KP * error + KI * integral + KD * derivative;
  tank(BASE + diff, BASE - diff);
}

bool lineSeen() {
  bool l = digitalRead(S_LEFT) == BLACK;
  bool m = digitalRead(S_MID) == BLACK;
  bool r = digitalRead(S_RIGHT) == BLACK;
  return l || m || r;
}

bool atFinishLine() {
  // emzaye 1-1-1: navar-e arzi = khat-e shoroo/payan-e dor
  bool l = digitalRead(S_LEFT) == BLACK;
  bool m = digitalRead(S_MID) == BLACK;
  bool r = digitalRead(S_RIGHT) == BLACK;
  return l && m && r;
}

// ---------- boogh (tanzim-e jalase 5) ----------
void beep(int times) {
  for (int i = 0; i < times; i = i + 1) {
    ledcWriteTone(BUZZER, 988);
    delay(120);
    ledcWriteTone(BUZZER, 0);
    delay(80);
  }
}

// ---------- protocol-e farman (jalase 6) ----------
void handleCommand(char c) {
  lastCmdMs = millis();   // kelide marde morde: neshane-ye "ranande zende ast"
  if (mode == "TILT" && c != 'S' && c != 's') {
    bleSend("aval robot ra saf kon, bad S bezan!\n");
    return;
  }
  int spd = speeds[gear];
  if (c == 'F' || c == 'f') { mode = "MANUAL"; driving = true; tank(spd, spd); }
  else if (c == 'B' || c == 'b') { mode = "MANUAL"; driving = true; back(spd); }
  else if (c == 'L' || c == 'l') { mode = "MANUAL"; driving = true; turnLeft(spd); }
  else if (c == 'R' || c == 'r') { mode = "MANUAL"; driving = true; turnRight(spd); }
  else if (c == 'S' || c == 's') {
    stopMotors();
    mode = "MANUAL";
    driving = false;
    bleSend("stop\n");
  }
  else if (c == '1') { gear = 0; bleSend("dande 1\n"); }
  else if (c == '2') { gear = 1; bleSend("dande 2\n"); }
  else if (c == '3') { gear = 2; bleSend("dande 3\n"); }
  else if (c == 'A' || c == 'a') {
    integral = 0.0;
    lastError = 0.0;
    lostCount = 0;
    laps = 0;   // kernometr-e dor az no
    driving = false;
    mode = "AUTO";
    bleSend("khodran ON - PID donbal-e khat\n");
  }
  else if (c == 'M' || c == 'm') {
    stopMotors();
    mode = "MANUAL";
    driving = false;
    bleSend("dasti ON\n");
  }
}

// ---------- alarm-e taadol (block-e jalase 5) ----------
void checkTilt() {
  float ax = mpu.getAngleX();
  float ay = mpu.getAngleY();
  if (abs(ax) > TILT_LIMIT || abs(ay) > TILT_LIMIT) {
    stopMotors();
    mode = "TILT";
    driving = false;
    Serial.println("KHATAR! kaj shodam");
    bleSend("KHATAR: kaj shodam! saf kon va S bezan\n");
    beep(3);
  }
}

// ---------- kernometr-e dor (jadid dar j10) ----------
void checkLapTimer() {
  // faghat dar khodran; obur-haye poshte-sar-ham ta 3 sanie yeki hesab mishavand
  if (atFinishLine() && millis() - lastLap > 3000) {
    lastLap = millis();
    if (laps == 0) {
      lapStart = millis();
      laps = 1;
      beep(1);
      bleSend("start-e dor!\n");
    } else {
      unsigned long t = millis() - lapStart;
      lapStart = millis();
      laps = laps + 1;
      beep(1);
      bleSend(String("dor tamam! zaman(ms): ") + String(t) + "\n");
    }
  }
}

void setup() {
  Serial.begin(115200);

  pinMode(IN1, OUTPUT);
  pinMode(IN2, OUTPUT);
  pinMode(IN3, OUTPUT);
  pinMode(IN4, OUTPUT);
  ledcAttach(ENA, 1000, 10);
  ledcAttach(ENB, 1000, 10);
  ledcAttach(BUZZER, 880, 10);
  ledcWriteTone(BUZZER, 0);

  pinMode(S_LEFT, INPUT);
  pinMode(S_MID, INPUT);
  pinMode(S_RIGHT, INPUT);

  stopMotors();
  mpuSetup();
  bleSetup();
  beep(2);
  Serial.println("Path C final: paydar va amade-ye mosabeghe!");
}

void loop() {
  mpu.update();   // ghalb-e ketabkhane-ye MPU: har door (jalase 5)

  if (Serial.available() > 0) {
    handleCommand(Serial.read());
  }
  char c = bleRead();
  if (c != 0) {
    handleCommand(c);
  }

  // failsafe-e j10 - kelide marde morde: agar ranande sokut kard, gaz nade!
  if (mode == "MANUAL" && driving && millis() - lastCmdMs > FAILSAFE_MS) {
    stopMotors();
    driving = false;
    bleSend("failsafe: farman naresid - istadam\n");
  }

  if (mode == "AUTO") {
    if (lineSeen()) {
      lostCount = 0;
    } else {
      lostCount = lostCount + 1;
    }
    if (lostCount > LOST_LIMIT) {
      stopMotors();
      mode = "MANUAL";
      lostCount = 0;
      bleSend("khat gom shod - khodran khamush, dasti bebar!\n");
    } else {
      pidStep();
      checkLapTimer();
    }
  }

  if (millis() - lastTiltCheck > 100) {
    lastTiltCheck = millis();
    checkTilt();
  }

  delay(10);
}
```

<div dir="rtl">

✅ **چک کن:** وسطِ راندنِ دستی، گوشی را قطع کن — ربات بعد از دو ثانیه خودش می‌ایستد. در خودران، ربات را از روی خط بردار — به‌جای رقصِ بی‌پایان می‌ایستد و «dasti bebar!» می‌فرستد. و در خودران، هر عبور از نوارِ عرضی زمانِ دور را به گوشی می‌فرستد.

> 🔧 **اگر کار نکرد:** باز `Brownout detector was triggered` و ریست؟ باتریِ ضعیف + دندهٔ بالا + پیچِ تند مقصرند: باتریِ تازه برای اجرای مهم، و اگر ادامه داشت دندهٔ ۳ را فقط برای مسابقه‌های کوتاه نگه دار. کرنومترِ دور دو بار پشت‌سرهم می‌زند؟ نوارِ عرضی پهن است — فاصلهٔ سه‌ثانیه‌ایِ `lastLap` در کد هست؛ اگر باز تکرار شد، نوار را باریک‌تر یا سرعت را بیشتر کن.

> 💡 **نکته:** خروجِ امن از خودران را روی میز تست کن: رباتت را روی سطحِ سفید بگذار تا هر سه سنسورِ خط سفید ببینند و بشمار (در هوا بلندش نکن: بیشتر ماژول‌ها بازتابی نمی‌گیرند و مثلِ مشکی ۱ می‌دهند) — بعد از `LOST_LIMIT` دور باید خودران خاموش شود. صادقانه: باتریِ خسته و افتِ ولتاژِ Brownout را هیچ شبیه‌سازی نشان نمی‌دهد؛ این‌ها فقط با سخت‌افزارِ واقعی و باتریِ واقعی دیده می‌شوند.

### چالش مسیر C: چرا خودران بهترین آزمایش بود؟

چرا برای تبرئهٔ رادیو، حالتِ خودران بهترین آزمایش بود؟ و اگر ربات در تستِ خودران خشک **نمی‌شد**، قدمِ بعدیِ شکار چه بود؟

---

**جواب:** چون حالتِ خودران کلاً به گوشی و BLE نیازی ندارد؛ با فرستادنِ ربات به خودران، شاخهٔ رادیو را کامل از معادله بیرون کشیدیم. وقتی ربات باز هم خشک شد، معلوم شد رادیو بی‌گناه است و مقصر در نیمهٔ تغذیه است. و اگر در خودران خشک نمی‌شد، یعنی مشکل واقعاً در شاخهٔ رادیو بود — قدمِ بعدی این می‌شد که نیمهٔ رادیو را نصف کنیم: مثلاً چک کنیم BLE پایدار وصل می‌ماند یا اپِ گوشی وسطِ کار فرمان را قطع می‌کند.

## چک‌لیست پایداری: از «کار می‌کند» تا «همیشه کار می‌کند»

شکارها تمام؛ حالا ضدگلوله‌کردن. چک‌لیستِ پایداریِ پروژهٔ نهایی سه ستون دارد و قبل از هر اجرای مهم، کامل تیک می‌خورد.

- **ستونِ تغذیه:** باتریِ تازه (A و C: تستِ چرخشِ ۹۰ درجهٔ ترم ۳)، کلید خاموش هنگام حمل و سیم‌کشی، و USB فقط برای برنامه‌ریزی؛ مسیر B: تغذیهٔ USBِ مطمئن و WiFiِ پایدار.
- **ستونِ اتصالات:** هر سیم را یک بار با انگشت نرم بکش — سیمِ نیمه‌شل، دشمنِ «گاهی» است؛ پیچِ هورنِ سروو، چسبِ MPU، لبهٔ نوارهای زمین.
- **ستونِ edge caseها** (موقعیت‌های لبِ مرز که هیچ‌کس تمرینشان نمی‌کند): A: لیوانِ خالی و لیوانِ پر، استارت از دو نقطهٔ مختلف؛ B: مرورگرِ بسته (هشدار باید بتپد!)، اینترنتِ قطع وسطِ گزارش، سنسورِ قهر؛ C: قطعِ عمدیِ BLE وسطِ راندن، برداشتنِ ربات از روی خط وسطِ خودران، شیبِ واقعی برای آلارم.

![تختهٔ چک‌لیستِ پایداری با سه ستون: POWER (باتریِ تازه با تیک، کلیدِ خاموش هنگامِ سیم‌کشی، USB خط‌خورده برای راندن)؛ CONNECTIONS (انگشتی که سیم را نرم می‌کشد، پیچِ هورنِ سروو، لبهٔ چسبیدهٔ نوار)؛ EDGE CASES (لیوانِ پر و خالی، گوشی با بلوتوثِ خط‌خورده، مرورگرِ بسته با زنگِ هشدارِ همچنان روشن، و یک سطحِ شیب‌دار)؛ پایین، بنرِ طلایی با سه جام «3 IN A ROW»](/lesson-assets/t5-s10-capstone-debug/prompt/03-image-stability-checklist.png)

و بعد از چک‌لیست، معیارِ طلایی که از ترم ۳ می‌شناسی: **سه اجرای کاملِ موفقِ پشت سر هم، بدونِ دست‌زدن.** دو تا از سه؟ هنوز پایدار نیست — چیزی برای تنظیم پیدا کرده‌ای؛ برگرد به دفترچه و پیچ‌ها.

✅ **چک کن:** سه ستونِ چک‌لیست کامل تیک خورده و سه اجرای موفقِ پشت سر هم را در دفترچه (شماره اجرا، زمان، موفق/ناموفق، یادداشت) ثبت کرده‌ای.

## تمرینِ کاملِ نمایش

آخرین آیینِ امروز: **تمرینِ کاملِ نمایش.** فصلِ بعد، نمایشِ نهایی جلوی داور است — و هیچ اجرایی نباید اولین اجرا باشد! پس امروز یک بار کاملش را تمرین کن، با کرونومتر و تماشاچی:

1. معرفیِ یک‌جمله‌ایِ پروژه.
2. دموی کاملِ قابلیت‌ها — همان‌هایی که در جدولِ داوریِ فصل ۷ امتیاز دارند.
3. جوابِ تمرینیِ سؤالِ سختِ داور: «اگر فلان قطعه خراب شود چه می‌شود؟» — که حالا با failsafeهای امروز، جوابِ درخشانی برایش داری.

زمان بگیر: کلِ دمو باید زیر پنج دقیقه بماند.

![پوستر تمرینِ کاملِ نمایش به سبک تئاتر: صحنهٔ کوچکِ خانگی با نورافکن، یکی از خانواده به‌عنوان تماشاچی با کرونومترِ گوشی، و نوجوانی که کنارِ میزی با سه سایهٔ محوِ پروژه (سبز، فیروزه‌ای، بنفش) ارائه می‌دهد؛ چک‌لیستِ شناور با سه بلیتِ INTRO، DEMO، HARD QUESTION و نشانِ زمانِ UNDER 5 MIN و بنرِ REHEARSAL](/lesson-assets/t5-s10-capstone-debug/prompt/04-image-dress-rehearsal.png)

بعد دفترچه: صفحهٔ **M3** — شکارِ امروز (پرونده، تست‌های نصف‌کردن، مقصر، درمان)، چک‌لیستِ تیک‌خورده، و زمانِ سه اجرای موفق.

> 💡 **نکته:** پروژهٔ تو الان **تمام** است، مهندس. چیزی که مانده، جشن گرفتنش است: مستندسازیِ نهایی، ویدیوی «پروژهٔ من»، نمایش به دنیا، و نقشهٔ راهِ بعد از فارغ‌التحصیلی.

## واژه‌های تازهٔ این فصل

| کلمه | تلفظ به حروف فارسی | یعنی چه |
|---|---|---|
| Bisection | بای‌سِکشِن | تقسیمِ دودویی؛ نصف‌کردنِ فضای مظنون‌ها در هر تست |
| Probe | پروب | کاوشگر؛ چاپ/سنجشِ موقتِ وسطِ زنجیره برای دیدنِ حالِ سیستم |
| Edge case | اِج کِیس | حالتِ لبِ مرزی که به‌ندرت رخ می‌دهد ولی خراب می‌کند |
| Failsafe | فِیل‌سِیف | رفتارِ امنِ از-پیش-طراحی‌شده برای وقتی چیزی خراب شد |
| Reproduce | ری‌پروديوس | بازتولید؛ خراب‌کردنِ عمدی و تکرارپذیر برای شکارِ باگ |
| Rehearsal | ری‌هِرسِل | تمرینِ کاملِ نمایش، دقیقاً مثلِ اجرای اصلی |

## تمرین‌ها

اول چک‌لیستِ پایانِ فصل: روشِ تقسیمِ دودویی را با مثالِ خودت می‌توانی توضیح بدهی؛ دست‌کم یک باگِ واقعی را با «نصفش کن» شکار کرده‌ای و پرونده‌اش در دفترچه است؛ نسخهٔ نهایی با failsafeها روی برد است و رفتارِ امنش در یک edge case دیده می‌شود؛ چک‌لیستِ پایداری و «سه اجرای موفقِ پشت سر هم» ثبت شده؛ و یک تمرینِ کاملِ نمایش زیر پنج دقیقه انجام شده. حالا تمرین‌ها:

- **تمرین اجباری:** milestone سه را کامل تحویل بده — چک‌لیستِ پایداری را قبل از هر اجرا کامل کن و **سه اجرای کاملِ موفقِ پشت سر هم** ثبت کن (جدول: شماره اجرا، زمان، موفق/ناموفق، یادداشت). بعد یک تمرینِ کاملِ نمایش با تماشاچی و کرونومتر اجرا کن و صفحهٔ M3 دفترچه را بنویس: پروندهٔ باگِ امروزت با همهٔ تست‌های نصف‌کردن، مقصر و درمان.
- **تمرین ستاره‌دار ⭐:** برای یکی از edge caseهای مسیرت که هنوز failsafe ندارد (خودت پیدایش کن!) یک محافظ طراحی کن و بساز — یا اگر پیاده‌سازی سنگین بود، فقط طرحش را با جزئیات در دفترچه بنویس: چه چیزی خراب می‌شود، سیستم چطور می‌فهمد، و رفتارِ امنش چیست. در نمایشِ نهایی، همین را به‌عنوانِ جوابِ «سؤالِ سختِ داور» رو کن.

## در فصل بعد

پروژه‌ات دیگر «همیشه کار می‌کند» — و این یعنی کارِ ساختن تمام شد. فصلِ بعد، آخرین فصلِ دوره است: فارغ‌التحصیلی! نه کدِ تازه‌ای، نه باگِ تازه‌ای — فقط بستنِ رسمیِ پروندهٔ پروژه، نمایشش به دنیا، گرفتنِ گواهیِ پایانِ دوره، و باز کردنِ نقشهٔ راهِ بعد از AIRO. دستمالِ کاغذی یادت نرود — می‌بینمت!

</div>

---
Source: https://yaadestan.com/courses/airo/lessons/t5/s10-capstone-debug (یادستان, Yaadestan)
