# فصل ۱۱ — پروژه ترم: ارتقا و نمایش

<div dir="rtl">

# فصل ۱۱ — پروژه ترم: ارتقا و نمایش

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

بگذار این فصل آخر را با یک اعتراف شروع کنیم: یازده فصل پیش، کل هنر برنامهٔ ما این بود که یک LED با تابع چشمک بزند. امروز روی میز تو دستگاهی نشسته که حس می‌کند، فکر می‌کند، حرف می‌زند و حرکت می‌کند. این مسیر را تو آمده‌ای — با تک‌تک خطاهای قرمزی که ترجمه کردی و سیم‌هایی که خودت جابه‌جا زدی و درست کردی. در این فصل — آخرین فصل ترم ۲ — سه کار می‌کنیم: اول ایستگاهت را **شخصی** می‌کنی، با یک منوی ارتقای شش‌تایی که مثل درخت مهارتِ بازی‌هاست (دو تایش را کامل با هم می‌سازیم: صفحهٔ حافظهٔ MIN/MAX و خوش‌آمدگوی حضور با HC-SR04). بعد مثل مهندس‌های واقعی مستندش می‌کنی — دفترچهٔ مهندسی. و آخرش آمادهٔ نمایش به دنیا می‌شوی — ویدیوی «پروژهٔ من»:

![درخت مهارت ایستگاه به سبک بازی‌ها: پایینِ درخت خودِ ایستگاه به‌عنوان پایهٔ بازشده می‌درخشد و شش شاخه بالا می‌روند — ملودی و چراغ شب با یک ستاره، حافظهٔ MIN/MAX و عقربهٔ دما با دو ستاره، منوی کالیبراسیون و خوش‌آمدگو با سه ستاره — و دو شاخهٔ امروز با حلقهٔ نورانی مشخص شده‌اند](/lesson-assets/t2-s11-term-project-upgrade/prompt/01-image-upgrade-skill-tree.png)

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

- از منوی ارتقا، با توجه به درجهٔ سختی و پیش‌نیازها، ارتقای مناسب دستگاه خودت را آگاهانه انتخاب کنی.
- صفحهٔ حافظهٔ MIN/MAX را با مقداردهی اولیهٔ درست — «اولین دادهٔ واقعی، نه صفر» — به ایستگاه اضافه کنی.
- خوش‌آمدگوی حضور را با HC-SR04، گارد `t < 0` و فاصله امنیتِ دوآستانه‌ای بسازی.
- یک صفحهٔ کامل دفترچهٔ مهندسی برای پروژه‌ات بنویسی.
- ویدیوی «پروژهٔ من» را طبق الگوی پنج‌قدمی و با قوانین ایمنی اشتراک‌گذاری ضبط کنی.

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

- **از فصل ۱۰:** ایستگاه هواشناسی کامل و سالم — نقطهٔ شروع همهٔ ارتقاهای این فصل. اگر ایستگاهت هنوز لنگ می‌زند، اول فصل ۱۰ را تمام کن.
- **از فصل ۹:** HC-SR04، تابع `read_distance_cm`، گارد `t < 0` و مقسم ولتاژ ECHO.
- **از فصل ۵:** min/max دستی و قانون «شروع با عضو اول، نه با صفر» — امروز قهرمانِ داستانِ باگ می‌شود.
- **از فصل ۴:** فاصله امنیت — این بار برای فاصلهٔ آدم‌ها، نه دما!
- **از فصل ۳ و ۸:** `map_value` و `set_angle` — برای ارتقای عقربهٔ دما.
- **از ترم ۱، فصل ۱ و ۹:** چرخهٔ Sense-Think-Act — عینکِ مرور این فصل — و متغیر وضعیت.

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

| قطعه / ابزار | تعداد | جایگزین |
|---|---|---|
| ایستگاه کامل فصل ۱۰ (سالم و کارکرده) | ۱ | — |
| HC-SR04 | ۱ | HC-SR04P — با 3V3 کار می‌کند و مقسم نمی‌خواهد (انتخاب پیشنهادی کیت) |
| مقاومت 10k برای مقسم ECHO | ۳ | فقط برای HC-SR04 کلاسیک؛ از کیت ترم ۱ |
| دکمهٔ فشاری دوم | ۱ (اختیاری) | برای ایدهٔ منوی کالیبراسیون (GPIO 33) |
| دفترچهٔ مهندسی (همان دفترچهٔ ترم ۱) + خودکار و مداد | ۱ | هر دفترچه‌ای |
| گوشی برای ضبط ویدیوی «پروژهٔ من» | ۱ | دوربین هر گوشی معمولی کافی است |
| کاغذ سفت یا مقوا | ۱ (اختیاری) | برای صفحهٔ ارتقای عقربهٔ دما |

> 🧪 **آزمایشگاه:** همان ایستگاه کاملِ فصل ۱۰ در آزمایشگاه دوره آماده است و ارتقای MIN/MAX بدون تغییر آن‌جا اجرا می‌شود — و اتفاقاً بهترین جا برای دیدن باگ امروز است: دما را با اسلایدر بالا و پایین ببر و تماشا کن MIN و MAX چطور قفل می‌شوند. همان سه تفاوت فصل ۱۰ این‌جا هم برقرار است: بوق صدا ندارد، اسلایدرها خودشان جواب سنسورند، و صفحهٔ کاغذیِ درجه‌بندی‌شدهٔ ارتقای عقربه را فقط روی میز واقعی می‌بینی — در آزمایشگاه به زاویهٔ خود Servo نگاه کن. [مدار را همین‌جا امتحان کن](/lab).

## ۱. با عینک ترم ۱ نگاه کن: تو یک ربات ساخته‌ای

قبل از هر ارتقایی، یک بار با عینک ترم ۱، فصل ۱ به ایستگاهت نگاه کن: چرخهٔ Sense-Think-Act. ایستگاه تو **حس می‌کند** — DHT11 دما و رطوبت را، LDR نور را. **فکر می‌کند** — میانگین می‌گیرد، با آستانه‌ها مقایسه می‌کند، فاصله امنیت را رعایت می‌کند. و **عمل می‌کند** — OLED می‌نویسد، Servo پرچم می‌چرخاند، Buzzer هشدار می‌دهد. می‌دانی این یعنی چه؟ تو همین حالا یک ربات کامل ساخته‌ای؛ فقط هنوز پا ندارد!

## چالش: سه ستون Sense و Think و Act

روی کاغذ سه ستون بکش و ایستگاهت را تقسیم کن: کدام قطعه‌ها Sense هستند، کدام خط‌های کد Think و کدام قطعه‌ها Act؟ اول خودت پر کن، بعد باز کن.

---

**جواب:** Sense: سنسور DHT11 و LDR (و اگر خوش‌آمدگو بسازی، HC-SR04). Think: خط‌های میانگین‌گیری، مقایسه با آستانه‌ها، `new_flag_state` با فاصله امنیت و منطق هشدار — همهٔ if ها و تابع‌های تصمیم‌گیر. Act: نمایشگر OLED، پرچم Servo و Buzzer.

## ۲. منوی ارتقا: درخت مهارت دستگاهت

بازی‌هایی را که skill tree دارند می‌شناسی: امتیاز می‌گیری و خودت انتخاب می‌کنی کدام شاخهٔ مهارت را باز کنی. ایستگاه تو هم از امروز skill tree دارد — شش ارتقا، هر کدام با درجهٔ سختی یک تا سه ستاره، و با ذکر اینکه روی شانهٔ کدام فصل سوار است:

| # | ارتقا | سختی | سوار بر شانهٔ |
|---|---|---|---|
| ۱ | ملودی هشدار به‌جای دو بوق ساده | ★ | ترم ۱، فصل ۱۰ — جعبهٔ نت‌ها |
| ۲ | چراغ شب خودکار کنار ایستگاه | ★ | فصل ۴ — آستانه و کالیبراسیون |
| ۳ | صفحهٔ حافظهٔ MIN/MAX | ★★ | فصل ۵ — min/max دستی |
| ۴ | عقربهٔ دما روی صفحهٔ کاغذی | ★★ | فصل ۳ و ۸ — map_value و set_angle |
| ۵ | منوی کالیبراسیون با دکمهٔ دوم | ★★★ | فصل ۱ و ترم ۱، فصل ۹ — تابع و متغیر وضعیت |
| ۶ | خوش‌آمدگوی حضور با HC-SR04 | ★★★ | فصل ۹ — سنسور فاصله |

سریع مرورشان کنیم. **ملودی هشدار:** به‌جای `double_beep`، جعبهٔ نت‌های ترم ۱ را با تابع `beep` پخش کن — ایستگاهت موقع خطر آواز می‌خواند. **چراغ شب:** وقتی `read_light_avg` از آستانهٔ تاریکی پایین‌تر رفت، یک LED کنار میز روشن شود — همان چراغ خودکار فصل ۴، این بار داخل یک دستگاه واقعی. **صفحهٔ MIN/MAX** را الان با هم می‌سازیم. **عقربهٔ دما:** Servo به‌جای سه حالت، مثل ساعت روی یک صفحهٔ کاغذی درجه‌بندی‌شده دما را نشان بدهد — نقشه‌اش در بخش ۵. **منوی کالیبراسیون:** دکمهٔ دوم روی GPIO33 که `ALERT_TEMP` را روی خود دستگاه کم و زیاد کند — بدون کامپیوتر! و بالاخره **خوش‌آمدگو:** ایستگاه وقتی پشت میز می‌آیی سلامت کند — این را هم امروز کامل می‌سازیم.

قانونش هم همان قانون طلایی فصل ۱۰ است: **یکی‌یکی!** هر ارتقا را کامل کن، تست کن، بعد برو سراغ بعدی. همین حالا یک انتخاب اول و یک انتخاب ذخیره برای دستگاه خودت داشته باش — و قبل از کد، در دفترچه بنویس ارتقایت به کدام فصل‌ها تکیه دارد.

## ۳. ساخت زنده ۱ — صفحهٔ حافظهٔ MIN/MAX

اگر تمرین اجباری فصل ۱۰ را انجام داده‌ای، این ارتقا برایت آشناست؛ امروز نسخهٔ تمیز و نهایی‌اش را می‌سازیم و مشهورترین باگش را از نزدیک می‌بینیم. هدف: صفحهٔ جدیدی که از لحظهٔ روشن شدن، کمترین و بیشترین دمای دیده‌شده را به یاد داشته باشد — حافظهٔ دستگاه. سه تغییر لازم است: متغیرهای `min_t` و `max_t`؛ به‌روز کردنشان بعد از هر خواندنِ موفق؛ و یک صفحهٔ جدید در `show_screen` — که یعنی سقف صفحه‌ها هم بالا می‌رود: `if screen > 3`.

از صفحهٔ نمایش شروع کن — و بگذار اولین خرابکاری عمدی فصل را همین‌جا بکنیم. برای خط MIN دقیقاً این را تایپ کن: `oled.text("MIN T: " + min_t, 0, 20)` و Run بزن:

</div>

```text
Traceback (most recent call last):
  File "<stdin>", line 168, in <module>
  File "<stdin>", line 106, in show_screen
TypeError: can't convert 'int' object to str implicitly
```

<div dir="rtl">

از خط آخر بخوان: «نمی‌توانم عدد صحیح را بی‌سروصدا به متن تبدیل کنم.» درست می‌گوید — علامت `+` یا دو متن را به هم می‌چسباند یا دو عدد را جمع می‌زند؛ مخلوطش را قبول نمی‌کند. و راه‌حل قشنگش را از ترم ۱ داری: f-string، که خودش عدد را داخل متن جا می‌دهد. بنویس `oled.text(f"MIN T: {min_t} C", 0, 20)` و تمام.

حالا مقدار اولیه. ساده‌ترین فکر دنیا: `min_t = 0` و `max_t = 0`. بنویس و اجرا کن ببین چه می‌شود... MAX درست کار می‌کند، ولی MIN به صفر چسبیده و تکان نمی‌خورد! چرا؟ چند ثانیه خودت فکر کن... برای اینکه MIN عوض شود، باید دمایی ببینیم که از صفر **کمتر** باشد — و اتاق تو مثلاً ۲۴ درجه است! صفر از همان اول، بدون شرکت در مسابقه، «برندهٔ کمترین» شده. فصل ۵ دقیقاً همین را با لیست دیدیم و قانونش را نوشتیم: **«شروع با عضو اول، نه با صفر.»** آنجا لیست آماده داشتیم و `readings[0]` نقطهٔ شروعمان بود؛ اینجا داده‌ها قطره‌قطره می‌آیند، پس «عضو اول» یعنی اولین خواندنِ واقعی سنسور. راه‌حل: یک پرچم یک‌بارمصرف به اسم `first_reading`. اولین باری که دادهٔ واقعی رسید، هم min و هم max همان می‌شوند و پرچم برای همیشه صفر می‌شود:

</div>

```python
if first_reading == 1:
    min_t = t   # avalin dade ye vaghei -> noghte ye shoroo
    max_t = t
    first_reading = 0
if t < min_t:
    min_t = t
if t > max_t:
    max_t = t
```

<div dir="rtl">

این قطعه داخل try می‌نشیند، دقیقاً بعد از خواندن موفق سنسور — چون اگر خواندن شکست بخورد، نمی‌خواهیم عددی جعلی وارد حافظه شود. برنامهٔ کامل — ایستگاه فصل ۱۰ به‌علاوهٔ همین یک ارتقا (فایل `upgrade_minmax.py`):

</div>

```python
# Term 2 - Session 11 - Upgrade 1: safhe ye hafeze MIN/MAX
# Istgah e kamel + yek safhe ye jadid: kamtarin va bishtarin dama az roshan shodan
# Deghat: meghdar e avalie ba AVALIN khandan e vaghei por mishavad, na ba 0!

from machine import Pin, ADC, I2C, PWM
import ssd1306
import dht
import time

# ---------- pich-haye tanzim (constants) ----------
COLD_LIMIT = 20     # zir e in (ba margin): parcham SARD  (hamun COMFORT_MIN e dars 6)
HOT_LIMIT = 27      # balaye in (ba margin): parcham GARM (hamun COMFORT_MAX e dars 6)
MARGIN = 1          # faseleye amniat (dars 4) ke parcham naparad
ALERT_TEMP = 32     # az in dama be bala: boogh e hoshdar + ALERT rooye safhe
DHT_EVERY = 20      # har 20 dor e halghe (~2 sanie) yek bar DHT bekhan
LIGHT_SAMPLES = 5   # tedad nemune baraye miangin e noor (dars 5)

# halat haye parcham (state)
COLD = 0
OK = 1
HOT = 2

# ---------- sakht-afzar ----------
sensor = dht.DHT11(Pin(16))
ldr = ADC(Pin(35))
ldr.atten(ADC.ATTN_11DB)
button1 = Pin(32, Pin.IN, Pin.PULL_UP)  # feshorde = 0 (term 1)
buzzer = PWM(Pin(4))
buzzer.duty(0)  # avale kar saket bash (mesl e dars 6)
servo = PWM(Pin(13), freq=50)  # servo hatman freq=50 (dars 8)
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
oled = ssd1306.SSD1306_I2C(128, 64, i2c)

# ---------- tabe-ha ----------
def map_value(x, in_min, in_max, out_min, out_max):
    # tabdil adad az yek baze be baze dige
    return (x - in_min) * (out_max - out_min) // (in_max - in_min) + out_min


def set_angle(deg):
    # 0 ta 180 daraje -> duty 26 ta 123 (0.5ms ta 2.4ms az 20ms)
    duty = int(26 + (deg / 180) * 97)
    servo.duty(duty)


def beep(freq_hz, duration_ms):
    # yek boogh e kutah ba buzzer (term 1)
    buzzer.freq(freq_hz)
    buzzer.duty(512)
    time.sleep_ms(duration_ms)
    buzzer.duty(0)


def double_beep():
    # do boogh e poshte ham baraye hoshdar (hamun 880 e dars 6)
    beep(880, 80)
    time.sleep_ms(80)
    beep(880, 80)


def read_light_avg():
    # 5 nemune az LDR + miangin (dars 5) -> adad e aroom tar
    readings = []
    for i in range(LIGHT_SAMPLES):
        readings.append(ldr.read())
        time.sleep_ms(10)
    total = 0
    for r in readings:
        total = total + r
    return total // len(readings)  # taghsim e sahih -> adad e sahih


def new_flag_state(t, state):
    # parcham ba faseleye amniat: faghat ba obur e KAMEL az marz avaz mishavad
    if t <= COLD_LIMIT - MARGIN:
        state = COLD
    if t >= COLD_LIMIT + MARGIN and t <= HOT_LIMIT - MARGIN:
        state = OK
    if t >= HOT_LIMIT + MARGIN:
        state = HOT
    return state


def move_flag(state):
    # se jaygah e parcham e kaghazi rooye servo
    if state == COLD:
        set_angle(160)
    elif state == OK:
        set_angle(90)
    elif state == HOT:
        set_angle(20)


def show_screen(screen, t, h, light, alert, min_t, max_t):
    # hala 4 safhe darim: 0 WEATHER, 1 LIGHT, 2 MIN/MAX, 3 ABOUT
    oled.fill(0)
    if screen == 0:
        oled.text("== WEATHER ==", 0, 0)
        oled.text(f"TEMP: {t} C", 0, 20)
        oled.text(f"HUM:  {h} %", 0, 32)
    elif screen == 1:
        oled.text("== LIGHT ==", 0, 0)
        oled.text(f"RAW: {light}", 0, 20)
        bar = map_value(light, 0, 4095, 0, 128)
        oled.fill_rect(0, 34, bar, 10, 1)
    elif screen == 2:
        oled.text("== MIN/MAX ==", 0, 0)
        oled.text(f"MIN T: {min_t} C", 0, 20)
        oled.text(f"MAX T: {max_t} C", 0, 32)
    else:
        oled.text("== ABOUT ==", 0, 0)
        oled.text("Weather Station", 0, 20)
        oled.text("+ MinMax Memory", 0, 32)
    if alert == 1:
        oled.text("!! ALERT !!", 20, 52)  # ghabl az show() bashad!
    oled.show()


# ---------- halghe asli ----------
screen = 0
flag_state = OK
t = 0
h = 0
light = 0
alert = 0
timer = 0  # shomarande ye makoos: 0 yani vaghte khandan e sensor
min_t = 0           # meghdar e vaghei ba avalin khandan por mishavad
max_t = 0
first_reading = 1   # parcham e yekbar-masraf (dars 5: shoru ba ozve aval!)

set_angle(90)  # shoroo az vasat: "90 daraje, bad parcham"

while True:
    if timer <= 0:
        try:
            sensor.measure()
            t = sensor.temperature()
            h = sensor.humidity()
            if first_reading == 1:
                min_t = t   # avalin dade ye vaghei -> noghte ye shoroo
                max_t = t
                first_reading = 0
            if t < min_t:
                min_t = t
            if t > max_t:
                max_t = t
        except OSError:
            print("Khata dar khandan DHT! sim-keshi ra check kon")
        light = read_light_avg()
        flag_state = new_flag_state(t, flag_state)
        move_flag(flag_state)
        if t >= ALERT_TEMP:
            alert = 1
            double_beep()
        else:
            alert = 0
        timer = DHT_EVERY
    if button1.value() == 0:
        screen = screen + 1
        if screen > 3:
            screen = 0  # hala 4 safhe darim (0 ta 3)
        time.sleep_ms(200)  # debounce (term 1)
    show_screen(screen, t, h, light, alert, min_t, max_t)
    timer = timer - 1
    time.sleep_ms(100)
```

<div dir="rtl">

✅ **چک کن:** بعد از اولین خواندن، MIN و MAX هر دو از دمای اتاق شروع می‌شوند. کیسهٔ یخ را نزدیک بیاور — MIN می‌رود پایین: ۲۲، ۲۱، ۲۰... و MAX سر جایش محکم ایستاده. حافظهٔ دستگاه کار می‌کند!

> 🔧 **اگر کار نکرد:** MIN همیشه صفر می‌ماند؟ هنوز با `min_t = 0` شروع کرده‌ای و پرچم `first_reading` جا افتاده — صفر بدون شرکت در مسابقه برنده شده. با دکمه به صفحهٔ MIN/MAX نمی‌رسی؟ سقف صفحه‌ها را چک کن: حالا چهار صفحه داریم و شرط باید `if screen > 3` باشد. و اگر همان TypeError چسباندن عدد به متن را می‌بینی، جایی هنوز `+` مانده — همهٔ متن‌های عدددار با f-string.

## چالش: چرا فقط MIN خراب شد و MAX درست کار می‌کرد؟

و سؤال جایزه‌دار: در چه جایی این باگ اتفاقاً هیچ‌وقت دیده نمی‌شد؟

---

**جواب:** چون شرط MAX می‌گوید «اگر دما از max_t بزرگ‌تر بود» — و دمای اتاق از صفر بزرگ‌تر است، پس MAX از همان خواندن اول درست می‌شود. ولی MIN منتظر دمایی **کمتر از صفر** است که در اتاق هیچ‌وقت نمی‌آید. و جواب جایزه: جایی که دما واقعاً به صفر برسد، مثل بالکن در زمستان. DHT11 دمای زیر صفر را نمی‌سنجد، پس آنجا MIN برابر صفر عددی درست به‌نظر می‌رسد و باگ پنهان می‌ماند؛ خطرناک‌ترین باگ‌ها همین‌هایی‌اند که گاهی درست کار می‌کنند!

## ۴. ساخت زنده ۲ — خوش‌آمدگوی حضور

و حالا ارتقای سه‌ستاره! ایده: ایستگاه بفهمد پشت میز آمده‌ای و سلامت کند. چشمِ فاصله‌سنج فصل ۹ را می‌آوریم — و یادآوری یک‌خطی ایمنی از همان فصل: ECHO این سنسور پنج‌ولتی است؛ یا ماژول HC-SR04P داری که با 3V3 مستقیم وصل می‌شود، یا برای کلاسیک همان مقسم ولتاژ سه‌مقاومتی را می‌بندی:

![اسلاید سیم‌کشی افزودنی: ایستگاه کامل، محو و جمع‌وجور در یک سمت با برچسب ADD-ON، و سنسور HC-SR04 پررنگ در سمت دیگر — VCC به VIN، TRIG مستقیم به GPIO5، و مسیر ECHO از مقاومت ۱۰k به GPIO18 با دو ۱۰k سری تا GND؛ گوشهٔ تصویر نسخهٔ HC-SR04P با تیک سبز](/lesson-assets/t2-s11-term-project-upgrade/prompt/03-image-hcsr04-addon-wiring.png)

1. کابل USB را جدا کن.
2. سنسور را لبهٔ Breadboard، رو به صندلی‌ات بنشان و طبق جدول وصل کن.
3. کابل را وصل کن.

</div>

| Part | Part pin | ESP32 pin | Note |
|---|---|---|---|
| HC-SR04 | VCC | VIN (5V) | classic module needs 5V |
| HC-SR04 | TRIG | GPIO 5 | direct wire, no divider needed |
| HC-SR04 | ECHO | 10k -> GPIO 18 | then GPIO 18 -> 10k + 10k (20k) -> GND |
| HC-SR04P | all pins | 3V3 / GPIO 5 / GPIO 18 | 3.3V version: direct, NO divider |

<div dir="rtl">

تابع `read_distance_cm` را کلمه‌به‌کلمه از فصل ۹ می‌آوریم — با همان خط طلایی `if t < 0`: یادت هست که `time_pulse_us` موقع timeout خطای قرمز نمی‌دهد؛ بی‌سروصدا عدد منفی برمی‌گرداند و گاردش وظیفهٔ ماست. حالا تابع را به فایل ایستگاه اضافه کن، برای تست فاصله را در حلقه چاپ کن و Run بزن. اگر مثل من عجله کرده باشی، این را می‌بینی:

</div>

```text
Traceback (most recent call last):
  File "<stdin>", line 131, in <module>
  File "<stdin>", line 90, in read_distance_cm
NameError: name 'machine' isn't defined
```

<div dir="rtl">

NameError یعنی «این اسم را نمی‌شناسم». ولی ما که بالای فایل کلی چیز از machine آورده‌ایم! دقت کن — نوشته‌ایم `from machine import Pin, ADC, I2C, PWM`. این جمله فقط همان چهار اسم را وارد برنامه می‌کند؛ خودِ اسم machine هیچ‌وقت وارد نشده! و تابع ما صدا می‌زند `machine.time_pulse_us`. راه‌حل: یک خط `import machine` هم کنار بقیه اضافه کن — همان تلهٔ دو import که فصل ۹ زیر کدش خط کشیدیم. اجرا — حالا عدد فاصله می‌آید: دست جلوی سنسور، ۲۰؛ برش می‌داری، منفیِ یک. و این ۱- خطا نیست؛ پیامِ «چیزی در بُردم نمی‌بینم» است.

حالا منطق سلام. اگر فاصله بین صفر و ۵۰ سانتی‌متر بود، یعنی کسی آمده. تابع `say_hello` صفحه را پاک می‌کند، WELCOME و !HELLO می‌نویسد، دو بوق شاد می‌زند و یک‌ونیم ثانیه صفحه را نگه می‌دارد. ولی یک لحظه فکر کن: اگر همین را خام وسط حلقه بگذاریم چه می‌شود؟ تو پشت میز نشسته‌ای، هر ۱۰۰ میلی‌ثانیه فاصله‌ات ۴۰ سانتی‌متر است — و ایستگاه بی‌وقفه: سلام! بوق! سلام! بوق! دیوانه‌کننده. راه‌حل، رفیق همیشگی‌مان از ترم ۱، فصل ۹: **متغیر وضعیت**. اسمش را می‌گذاریم `greeted` — یعنی «سلام کرده‌ام». بعد از سلام یک می‌شود و تا وقتی نروی و برنگردی، خبری از سلام دوباره نیست.

و «رفتن» را کِی قبول کنیم؟ اینجا هم فاصله امنیت فصل ۴ برمی‌گردد، این بار برای آدم‌ها: نزدیک‌تر از ۵۰ سلام می‌کنیم، ولی فقط وقتی دورتر از ۷۰ شدی (یا سنسور گفت ۱-)، `greeted` دوباره صفر می‌شود. بین ۵۰ و ۷۰ منطقهٔ خنثی است — اگر درست لبِ مرز بایستی، ایستگاه نه سلام‌باران می‌شود نه قهر می‌کند:

</div>

```python
d = read_distance_cm()
if d > 0 and d < PRESENCE_CM:
    if greeted == 0:
        say_hello()
        greeted = 1
if d > PRESENCE_FAR or d == -1:
    greeted = 0  # raft; dobare amade ye salam bash
```

<div dir="rtl">

برنامهٔ کامل — ایستگاه فصل ۱۰ به‌علاوهٔ خوش‌آمدگو (فایل `upgrade_presence.py`):

</div>

```python
# Term 2 - Session 11 - Upgrade 2: khosh-amad-goo ba HC-SR04
# Istgah e kamel + salam rooye safhe vaghti kasi be miz nazdik mishavad
# ECHO hatman ba maghsame voltage (dars 9) ya module HC-SR04P!

from machine import Pin, ADC, I2C, PWM
import machine
import ssd1306
import dht
import time

# ---------- pich-haye tanzim (constants) ----------
COLD_LIMIT = 20     # zir e in (ba margin): parcham SARD  (hamun COMFORT_MIN e dars 6)
HOT_LIMIT = 27      # balaye in (ba margin): parcham GARM (hamun COMFORT_MAX e dars 6)
MARGIN = 1          # faseleye amniat (dars 4) ke parcham naparad
ALERT_TEMP = 32     # az in dama be bala: boogh e hoshdar + ALERT rooye safhe
DHT_EVERY = 20      # har 20 dor e halghe (~2 sanie) yek bar DHT bekhan
LIGHT_SAMPLES = 5   # tedad nemune baraye miangin e noor (dars 5)
PRESENCE_CM = 50    # nazdik tar az in: salam kon
PRESENCE_FAR = 70   # door tar az in: dobare amade ye salam sho (faseleye amniat!)

# halat haye parcham (state)
COLD = 0
OK = 1
HOT = 2

# ---------- sakht-afzar ----------
sensor = dht.DHT11(Pin(16))
ldr = ADC(Pin(35))
ldr.atten(ADC.ATTN_11DB)
button1 = Pin(32, Pin.IN, Pin.PULL_UP)  # feshorde = 0 (term 1)
buzzer = PWM(Pin(4))
buzzer.duty(0)  # avale kar saket bash (mesl e dars 6)
servo = PWM(Pin(13), freq=50)  # servo hatman freq=50 (dars 8)
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
oled = ssd1306.SSD1306_I2C(128, 64, i2c)
trig = Pin(5, Pin.OUT)
echo = Pin(18, Pin.IN)  # az tarigh e maghsame voltage (dars 9)

# ---------- tabe-ha ----------
def map_value(x, in_min, in_max, out_min, out_max):
    # tabdil adad az yek baze be baze dige
    return (x - in_min) * (out_max - out_min) // (in_max - in_min) + out_min


def set_angle(deg):
    # 0 ta 180 daraje -> duty 26 ta 123 (0.5ms ta 2.4ms az 20ms)
    duty = int(26 + (deg / 180) * 97)
    servo.duty(duty)


def beep(freq_hz, duration_ms):
    # yek boogh e kutah ba buzzer (term 1)
    buzzer.freq(freq_hz)
    buzzer.duty(512)
    time.sleep_ms(duration_ms)
    buzzer.duty(0)


def double_beep():
    # do boogh e poshte ham baraye hoshdar (hamun 880 e dars 6)
    beep(880, 80)
    time.sleep_ms(80)
    beep(880, 80)


def read_light_avg():
    # 5 nemune az LDR + miangin (dars 5) -> adad e aroom tar
    readings = []
    for i in range(LIGHT_SAMPLES):
        readings.append(ldr.read())
        time.sleep_ms(10)
    total = 0
    for r in readings:
        total = total + r
    return total // len(readings)  # taghsim e sahih -> adad e sahih


def read_distance_cm():
    # tabe ye rasmi e dars 9 - kalame be kalame haman ast
    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  # timeout: chizi dar borde nist ya sim-keshi eshkal darad
    return t // 58


def new_flag_state(t, state):
    # parcham ba faseleye amniat: faghat ba obur e KAMEL az marz avaz mishavad
    if t <= COLD_LIMIT - MARGIN:
        state = COLD
    if t >= COLD_LIMIT + MARGIN and t <= HOT_LIMIT - MARGIN:
        state = OK
    if t >= HOT_LIMIT + MARGIN:
        state = HOT
    return state


def move_flag(state):
    # se jaygah e parcham e kaghazi rooye servo
    if state == COLD:
        set_angle(160)
    elif state == OK:
        set_angle(90)
    elif state == HOT:
        set_angle(20)


def say_hello():
    # safhe ye khosh-amad + do boogh e shad, bad 1.5 sanie mikas
    oled.fill(0)
    oled.text("*  WELCOME  *", 12, 8)
    oled.text("HELLO!", 40, 28)
    oled.text("*************", 8, 48)
    oled.show()
    beep(1200, 100)
    time.sleep_ms(100)
    beep(1800, 150)
    time.sleep_ms(1500)  # bezar salam dide shavad


def show_screen(screen, t, h, light, alert):
    # hame ye naghashi e safhe yek ja: aval fill(0), akharesh show()
    oled.fill(0)
    if screen == 0:
        oled.text("== WEATHER ==", 0, 0)
        oled.text(f"TEMP: {t} C", 0, 20)
        oled.text(f"HUM:  {h} %", 0, 32)
    elif screen == 1:
        oled.text("== LIGHT ==", 0, 0)
        oled.text(f"RAW: {light}", 0, 20)
        bar = map_value(light, 0, 4095, 0, 128)
        oled.fill_rect(0, 34, bar, 10, 1)
    else:
        oled.text("== ABOUT ==", 0, 0)
        oled.text("Weather Station", 0, 20)
        oled.text("+ Hello Greeter", 0, 32)
    if alert == 1:
        oled.text("!! ALERT !!", 20, 52)  # ghabl az show() bashad!
    oled.show()


# ---------- halghe asli ----------
screen = 0
flag_state = OK
t = 0
h = 0
light = 0
alert = 0
timer = 0  # shomarande ye makoos: 0 yani vaghte khandan e sensor
greeted = 0  # motaghayer e vaziat: 1 yani salam karde-am, dige tekrar nakon

set_angle(90)  # shoroo az vasat: "90 daraje, bad parcham"

while True:
    if timer <= 0:
        try:
            sensor.measure()
            t = sensor.temperature()
            h = sensor.humidity()
        except OSError:
            print("Khata dar khandan DHT! sim-keshi ra check kon")
        light = read_light_avg()
        flag_state = new_flag_state(t, flag_state)
        move_flag(flag_state)
        if t >= ALERT_TEMP:
            alert = 1
            double_beep()
        else:
            alert = 0
        timer = DHT_EVERY
    if button1.value() == 0:
        screen = screen + 1
        if screen > 2:
            screen = 0  # bargasht be safhe ye aval
        time.sleep_ms(200)  # debounce (term 1)
    show_screen(screen, t, h, light, alert)
    # fasele ra dar ghesmat e tond e halghe mikhanim,
    # servo faghat har 2 sanie dar block e sensor ha harekat mikonad
    d = read_distance_cm()
    if d > 0 and d < PRESENCE_CM:
        if greeted == 0:
            say_hello()
            greeted = 1
    if d > PRESENCE_FAR or d == -1:
        greeted = 0  # raft; dobare amade ye salam bash
    timer = timer - 1
    time.sleep_ms(100)
```

<div dir="rtl">

یک نکتهٔ ظریف برای حرفه‌ای‌ها: خواندنِ فاصله در قسمتِ تندِ حلقه است، ولی Servo فقط هر ۲ ثانیه در بلوک سنسورها حرکت می‌کند — این‌طوری اندازه‌گیری صوتی و لرزشِ تغذیهٔ Servo کمتر با هم تداخل می‌کنند.

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

> 🔧 **اگر کار نکرد:** HELLO پشت‌سرهم تکرار می‌شود وقتی لبِ مرز نشسته‌ای؟ فقط یک آستانه گذاشته‌ای — دو آستانه لازم است: سلام زیر `PRESENCE_CM` و آزاد شدن بالای `PRESENCE_FAR`. صفحهٔ HELLO اصلاً دیده نمی‌شود یا فوری پاک می‌شود؟ مکث `time.sleep_ms(1500)` آخرِ `say_hello` را نگه دار — بدون آن، `show_screen` بلافاصله صفحه را بازنویسی می‌کند. فاصله همیشه ۱- است و هیچ عددی نمی‌آید؟ TRIG و ECHO جابه‌جاست (فصل ۹: TRIG=5، ECHO=18). و اگر اعداد فاصله موقع چرخش Servo پرت‌وپلا می‌شوند، Servo حتماً از VIN تغذیه شود و فاصله را مثل همین کد بین حرکت‌های Servo بخوان.

## چالش: اگر greeted را حذف کنیم چه می‌بینیم؟

و سؤال دوم: منطقهٔ بین ۵۰ تا ۷۰ سانتی‌متر دقیقاً چه مشکلی را حل می‌کند؟

---

**جواب:** بدون `greeted`، تا وقتی پشت میز نشسته‌ای، هر دور حلقه شرطِ «نزدیک‌تر از ۵۰» درست است و ایستگاه بی‌وقفه سلام و بوق می‌کند. و منطقهٔ خنثی همان فاصله امنیت است: اگر درست لبِ مرز ۵۰ بایستی و عدد سنسور کمی بلرزد، بدون آن، `greeted` مدام صفر و یک می‌شود و سلام‌باران برمی‌گردد؛ با دو آستانه، فقط رفتنِ واقعی (دورتر از ۷۰) سلامِ بعدی را آزاد می‌کند.

## ۵. نقشهٔ ارتقای عقربهٔ دما

این یکی را با هم نمی‌سازیم، ولی نقشه‌اش را ببین چون ترکیب قشنگی از فصل ۳ و ۸ است: یک نیم‌دایرهٔ کاغذی با درجه‌بندی صفر تا چهل درست می‌کنی، پشت هورن Servo می‌چسبانی — و Servo می‌شود عقربهٔ یک گیج واقعی. مغز ماجرا فقط `map_value` است، این بار برعکس: دمای صفر می‌شود زاویهٔ ۱۷۰ و دمای چهل می‌شود زاویهٔ ۱۰ — چون درجه‌بندی کاغذ از چپ به راست زیاد می‌شود ولی زاویهٔ Servo برعکس می‌چرخد. دو خط `if` هم قبل از map، دما را در بازهٔ صفحه قیچی می‌کنند که عقربه هیچ‌وقت از صفحه بیرون نزند. کد کامل و آماده (فایل `upgrade_pointer_gauge.py`) — تک‌تک خط‌هایش را قبلاً یاد گرفته‌ای:

</div>

```python
# Term 2 - Session 11 - Upgrade 3: aghrabe ye dama rooye safhe ye kaghazi
# Servo be jaye parcham e 3 halate, mesl e yek gauge kar mikonad (dars 3 + dars 8)
# Safhe ye kaghazi nim-dayere: 0 daraje C dar chap (zavie 170), 40 dar rast (zavie 10)

from machine import Pin, ADC, I2C, PWM
import ssd1306
import dht
import time

# ---------- pich-haye tanzim (constants) ----------
ALERT_TEMP = 32     # az in dama be bala: boogh e hoshdar + ALERT rooye safhe
DHT_EVERY = 20      # har 20 dor e halghe (~2 sanie) yek bar DHT bekhan
LIGHT_SAMPLES = 5   # tedad nemune baraye miangin e noor (dars 5)
GAUGE_MIN_T = 0     # avale safhe ye kaghazi (daraje C)
GAUGE_MAX_T = 40    # akhare safhe ye kaghazi (daraje C)
ANGLE_LEFT = 170    # zavie ye servo baraye GAUGE_MIN_T
ANGLE_RIGHT = 10    # zavie ye servo baraye GAUGE_MAX_T

# ---------- sakht-afzar ----------
sensor = dht.DHT11(Pin(16))
ldr = ADC(Pin(35))
ldr.atten(ADC.ATTN_11DB)
button1 = Pin(32, Pin.IN, Pin.PULL_UP)  # feshorde = 0 (term 1)
buzzer = PWM(Pin(4))
buzzer.duty(0)  # avale kar saket bash (mesl e dars 6)
servo = PWM(Pin(13), freq=50)  # servo hatman freq=50 (dars 8)
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
oled = ssd1306.SSD1306_I2C(128, 64, i2c)

# ---------- tabe-ha ----------
def map_value(x, in_min, in_max, out_min, out_max):
    # tabdil adad az yek baze be baze dige
    return (x - in_min) * (out_max - out_min) // (in_max - in_min) + out_min


def set_angle(deg):
    # 0 ta 180 daraje -> duty 26 ta 123 (0.5ms ta 2.4ms az 20ms)
    duty = int(26 + (deg / 180) * 97)
    servo.duty(duty)


def beep(freq_hz, duration_ms):
    # yek boogh e kutah ba buzzer (term 1)
    buzzer.freq(freq_hz)
    buzzer.duty(512)
    time.sleep_ms(duration_ms)
    buzzer.duty(0)


def double_beep():
    # do boogh e poshte ham baraye hoshdar (hamun 880 e dars 6)
    beep(880, 80)
    time.sleep_ms(80)
    beep(880, 80)


def read_light_avg():
    # 5 nemune az LDR + miangin (dars 5) -> adad e aroom tar
    readings = []
    for i in range(LIGHT_SAMPLES):
        readings.append(ldr.read())
        time.sleep_ms(10)
    total = 0
    for r in readings:
        total = total + r
    return total // len(readings)  # taghsim e sahih -> adad e sahih


def temp_to_angle(temp):
    # dama -> zavie ye aghrabe. map e barax: dama bala miravad, zavie kam mishavad
    # aval dama ra dar baze ye safhe ghichi kon ke aghrabe az safhe birun nazanad
    if temp < GAUGE_MIN_T:
        temp = GAUGE_MIN_T
    if temp > GAUGE_MAX_T:
        temp = GAUGE_MAX_T
    return map_value(temp, GAUGE_MIN_T, GAUGE_MAX_T, ANGLE_LEFT, ANGLE_RIGHT)


def show_screen(screen, t, h, light, alert):
    # hame ye naghashi e safhe yek ja: aval fill(0), akharesh show()
    oled.fill(0)
    if screen == 0:
        oled.text("== WEATHER ==", 0, 0)
        oled.text(f"TEMP: {t} C", 0, 20)
        oled.text(f"HUM:  {h} %", 0, 32)
    elif screen == 1:
        oled.text("== LIGHT ==", 0, 0)
        oled.text(f"RAW: {light}", 0, 20)
        bar = map_value(light, 0, 4095, 0, 128)
        oled.fill_rect(0, 34, bar, 10, 1)
    else:
        oled.text("== ABOUT ==", 0, 0)
        oled.text("Weather Station", 0, 20)
        oled.text("+ Temp Gauge", 0, 32)
    if alert == 1:
        oled.text("!! ALERT !!", 20, 52)  # ghabl az show() bashad!
    oled.show()


# ---------- halghe asli ----------
screen = 0
t = 0
h = 0
light = 0
alert = 0
timer = 0  # shomarande ye makoos: 0 yani vaghte khandan e sensor

set_angle(90)  # aghrabe vasat e safhe (hodud e 20 daraje C rooye kaghaz)

while True:
    if timer <= 0:
        try:
            sensor.measure()
            t = sensor.temperature()
            h = sensor.humidity()
        except OSError:
            print("Khata dar khandan DHT! sim-keshi ra check kon")
        light = read_light_avg()
        set_angle(temp_to_angle(t))  # aghrabe be jaye parcham
        if t >= ALERT_TEMP:
            alert = 1
            double_beep()
        else:
            alert = 0
        timer = DHT_EVERY
    if button1.value() == 0:
        screen = screen + 1
        if screen > 2:
            screen = 0  # bargasht be safhe ye aval
        time.sleep_ms(200)  # debounce (term 1)
    show_screen(screen, t, h, light, alert)
    timer = timer - 1
    time.sleep_ms(100)
```

<div dir="rtl">

✅ **چک کن:** اگر این ارتقا را ساختی: عقربه آرام روی عددِ دمای اتاق می‌ایستد و با گرم و سرد کردن سنسور، روی صفحهٔ کاغذی جابه‌جا می‌شود.

> 🔧 **اگر کار نکرد:** عقربه برعکس حرکت می‌کند — دما بالا می‌رود و عقربه به سمت صفر؟ جای `ANGLE_LEFT` و `ANGLE_RIGHT` با جهتِ چسباندن صفحهٔ کاغذی‌ات نمی‌خواند: یا دو ثابت را جابه‌جا کن یا صفحهٔ کاغذی را برگردان — و بعد از هر تغییر دوباره تست کن.

## ۶. دفترچهٔ مهندسی: پروژه را ماندگار کن

دستگاهت شخصی شد؛ حالا وقت مستندسازی است. چرا؟ دو دلیل کاملاً واقعی. اول: شش ماه دیگر که بخواهی ارتقای جدید بزنی، بدون نقشه و یادداشت باید همه‌چیز را از نو کشف کنی — مهندسِ بدون مستند، همان باگ‌ها را دو بار می‌خورَد. دوم: دفترچه، مدرک رسمی مسیر توست؛ در مسابقات رباتیک واقعی مثل WRO داورها دفترچهٔ مهندسی را جدی داوری می‌کنند — گاهی جدی‌تر از خود ربات!

یک صفحهٔ دفترچه باز کن و این پنج بخش را پر کن:

1. **هدف** — یک جمله: این دستگاه چه می‌کند و برای کی؟
2. **نقشهٔ سیم‌کشی دستی** — با دست بکش؛ لازم نیست قشنگ باشد، لازم است **درست** باشد.
3. **مشکلاتی که خوردم و چطور حل شد** — ارزشمندترین بخش! همین امروز دو نمونهٔ درجه‌یک دیدی: MIN چسبیده به صفر، و NameError ماژول machine.
4. **عکس دستگاه** — چاپ کن و بچسبان، یا جایش را خالی بگذار و شمارهٔ عکس گوشی را بنویس.
5. **ایدهٔ بعدی** — همین حالا که ذهنت داغ است بنویسش.

![صفحهٔ پرشدهٔ دفترچهٔ مهندسی روی میز چوبی: پنج بخش با تیترهای دست‌نویس — هدف، نقشهٔ سیم‌کشی با طرح مدادرنگی برد و سنسورها، جدول دوستونی باگ‌ها و راه‌حل‌ها با باگ‌های خط‌خورده و تیک سبز، عکس چسبانده‌شدهٔ دستگاه، و ایدهٔ بعدی با لامپ روشن](/lesson-assets/t2-s11-term-project-upgrade/prompt/05-image-notebook-page.png)

✅ **چک کن:** هر پنج بخش پر شده و بخش «مشکلات و راه‌حل‌ها» دست‌کم دو موردِ واقعی از تجربهٔ خودت دارد.

## چالش: چرا بخش «مشکلات و راه‌حل‌ها» از بخش «هدف» هم مهم‌تر است؟

برای شش‌ماه‌بعدِ خودت جواب بده.

---

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

## ۷. ویدیوی «پروژهٔ من» — نسخهٔ پنج‌قدمی

و حالا نمایش! همان الگوی «پروژهٔ من» ترم ۱ که قول داده بودیم هر ترم کمی بزرگ‌تر شود: این بار دو تا سه دقیقه با دوربین گوشی، در پنج قدم:

![استوری‌برد پنج‌قابی ویدیوی «پروژهٔ من» به شکل قاب‌های ویدیوی گوشی: سلام کنار ایستگاه، هدف با آیکون دماسنج و خورشید، دموی نزدیک از صفحه و پرچم و دکمه، داستان باگ با دفترچه و تیک سبز، و قدم بعدی با لامپ و موشک — و زیرشان نوار زمان دو تا سه دقیقه](/lesson-assets/t2-s11-term-project-upgrade/prompt/06-image-my-project-storyboard.png)

1. **سلام و اسم پروژه:** «سلام! من …م و این ایستگاه هواشناسی من است.»
2. **مشکل یا هدف:** این دستگاه چه دردی را دوا می‌کند؟
3. **دموی زنده:** صفحه‌ها را عوض کن، پرچم را نشان بده، هشدار را فعال کن؛ اگر خوش‌آمدگو ساخته‌ای، سلامش حتماً در ویدیو باشد!
4. **سخت‌ترین باگ و راه‌حلش:** باور کن جذاب‌ترین قسمت ویدیو همین است؛ آدم‌ها عاشق داستانِ گره و گره‌گشایی‌اند.
5. **قدم بعدی:** چه ارتقایی در راه است؟

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

> ⚠️ **مواظب باش:** سه قانون ایمنی اشتراک‌گذاری، بدون استثنا: اسم کامل نه؛ آدرس و اسم مدرسه نه؛ و هیچ‌چیزی در قاب که محل زندگی‌ات را لو بدهد. ویدیو را اول به خانواده نشان بده و با اجازهٔ آن‌ها با گروه کلاس به اشتراک بگذار.

✅ **چک کن:** یک ویدیوی دو تا سه دقیقه‌ای داری با هر پنج قدم — و صدای بوق و سلامِ دستگاه در آن شنیده می‌شود.

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

| کلمه | تلفظ به حروف فارسی | یعنی چه |
|---|---|---|
| Upgrade | آپْگرِید | ارتقا — اضافه‌کردن یک قابلیت جدید به دستگاهی که کار می‌کند |
| Showcase | شوکِیس | نمایش پروژه به دیگران — با دمو و داستان، نه فقط ادعا |
| Documentation | داکیومِنتِیشِن | مستندسازی — ثبت هدف، نقشه، مشکلات و راه‌حل‌ها روی کاغذ |
| Engineering notebook | اینجینیرینگ نوتْ‌بوک | دفترچهٔ مهندسی — دفتر رسمی مسیر پروژه؛ در مسابقات داوری می‌شود |
| Rubric | روبْریک | جدول معیارهای داوری — از قبل معلوم می‌کند «خوب» یعنی چه |
| Demo | دِمو | نمایش زندهٔ کارکرد دستگاه — قلب ویدیوی «پروژهٔ من» |

## تمرین‌ها

اول چک‌لیست پایان ترم — چهار نشانِ فارغ‌التحصیلی ترم ۲: ایستگاه پایهٔ فصل ۱۰ کامل کار می‌کند (سه صفحه، پرچم، هشدار، standalone)؛ دست‌کم یک ارتقای شخصیِ تست‌شده رویش سوار است و می‌توانی توضیح بدهی چطور کار می‌کند؛ صفحهٔ دفترچهٔ مهندسی با هر پنج بخش پر شده؛ و ویدیوی «پروژهٔ من» با پنج قدم ضبط شده. هر چهار تا بله؟ ترم ۲ رسماً مال توست — حالا تمرین‌ها:

- **تمرین اجباری:** یک ارتقای دیگر از منو را خودت انتخاب کن و کامل بساز (پیشنهاد برای شروع: ملودی هشدار یا چراغ شب — یک‌ستاره‌ها). بعد صفحهٔ دفترچهٔ مهندسی را کامل کن: هدف، نقشهٔ دستی، حداقل دو مشکل و راه‌حل، عکس، ایدهٔ بعدی.
- **تمرین ستاره‌دار ⭐:** یک ارتقای کاملاً جدید طراحی کن که در منو نیست — و در ویدیوی «پروژهٔ من» از انتخابت دفاع کن: چه مشکلی را حل می‌کند؟ به کدام فصل‌ها تکیه دارد؟ چرا ارزش ساختن داشت؟ (ایده برای جرقه: هشدار رطوبت برای گلدان کنار پنجره؟ شمارندهٔ رفت‌وآمد اتاق با HC-SR04؟)

## در فصل بعد

ایستگاه تو همه‌چیز دارد جز یک چیز: **حرکت**. ترم ۳ به رباتمان چرخ می‌دهیم — موتور واقعی، درایور موتور، شاسی و باتری؛ رباتی که راه می‌رود، با همین HC-SR04 جلویش را نگاه می‌کند، مانع را دور می‌زند و خط را دنبال می‌کند. همهٔ چیزهایی که این ترم ساختی، سوار آن ربات می‌شوند — ایستگاهت را روشن نگه دار و دفترچه‌ات را ببند به دستگاه.

</div>

---
Source: https://yaadestan.com/courses/airo/lessons/t2/s11-term-project-upgrade (یادستان, Yaadestan)
