Smart Home League

نصب و اجرا

پوشه‌ی Smart Home League که دریافت کرده‌اید دو زیرپوشه دارد: Windows و Mac.

ویندوز

1. وارد پوشه‌ی Windows شوید و روی Smart Home League.exe دوبار کلیک کنید.
2. اگر بار اول ویندوز پیام امنیتی داد: More info و سپس Run anyway را بزنید.
3. پنجره‌ی بازی خودش باز می‌شود — همین!

مک

1. وارد پوشه‌ی Mac شوید و روی Smart Home League (Mac).command دوبار کلیک کنید.
2. اگر مک اجازه نداد: روی همان فایل راست‌کلیک → Open → Open (فقط بار اول لازم است).
3. اگر مک پیشنهاد نصب ابزار خط فرمان (python3) داد، Install را بزنید و بعد از پایان، دوباره دوبار کلیک کنید.

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

📍 هلپر مسیر (U19) — نقطه بزنید، کد تحویل بگیرید

1. از صفحه‌ی اول لیگ، «هلپر مسیر» را بزنید — عکسِ واقعیِ از بالای خانه باز می‌شود.
2. اول در تنظیمات مشخص کنید ربات شما قرمز است یا آبی — نقطه‌ی شروعِ همان ربات روی عکس با برچسب START نشان داده می‌شود.
3. روی نقشه کلیک کنید تا نقطه‌های مسیر ساخته شوند (یا با حالت «کشیدن»، مسیر آزاد بکشید تا خودش به نقطه تبدیل شود).
4. هلپر خودش نقطه‌های میانیِ رد شدن از درها را حساب می‌کند — چون goto فقط خط مستقیم می‌رود.
5. کنار هر نقطه یک چیپ باتری می‌بینید: 🔋 شارژ تقریبی هنگام رسیدن، 🏠 هزینه‌ی راهِ برگشت تا شارژر — و اگر با تنظیمات فعلی به شارژر نرسد، ⚠ هشدار قرمز می‌گیرید.
6. در جعبه‌ی ⚙ تنظیمات: مسیر حلقه باشد یا یک‌بار؛ گارد باتری روشن/خاموش؛ آستانه‌ی «زیر چند ٪ برو شارژر»؛ و اینکه روی پد «تا چند ٪» یا «چند ثانیه» بماند.
7. کد ساخته‌شده دو تابع دارد: follow_route() برای مسیر و go_charge() برای سفرِ شارژ — پایینِ فایل صدا زده می‌شوند و اسمشان را هم می‌توانید عوض کنید. اگر پد اشغال باشد، ربات آرام در صف می‌ماند.
8. در پایان: «کپی پایتون»، «⬇ فایل پایتون» یا «▶» — با ▶ مسابقه خودش شروع می‌شود.

سنسورهای ربات در یک نگاه

• سه سنسور فاصله‌ی آلتراسونیک (US) — front، frontleft (جلو-چپ)، frontright (جلو-راست)، بر حسب سانتی‌متر.
• بامپر — bumperfront و bumperback (۰ یا ۱).
• سنسور رنگ — color.
• قطب‌نما — heading.
• GPS — x و y (سانتی‌متر) به‌همراه goto(x, y)، distto و angleto.
• باتری و ایستگاه شارژ — battery (٪) و مختصات پد: dockx، docky.

پیش از شروع

نکته: برنامه‌ی ربات ۱۰ بار در ثانیه از بالا تا پایین اجرا می‌شود؛ مقداری که در wheelleft و wheelright می‌گذارید تا اجرای بعدی می‌ماند. هر درس یک برنامه‌ی کامل و قابل‌اجراست — آن را در بخش «آموزش» داخل برنامه اجرا کنید یا در ادیتور مسابقه بگذارید.

wheelleft = 25
wheelright = 25

if front < 55:          # فقط دیوارها را رد کن
    wheelleft = 18
    wheelright = -18
elif frontleft < 45:
    wheelleft = 25
    wheelright = 8
elif frontright < 45:
    wheelleft = 8
    wheelright = 25

if state == 0:          # یک بار در شروع
    state = 1
    goto(dockx, docky)  # -> برو ایستگاه

if bumper == 1:         # goto مانع را دور نمی‌زند
    stopgoto()
    backward(1)
    state = 0           # دوباره تلاش کن

if atgoal == 1:         # رسیدیم: بایست و بنوش
    wheelleft = 0
    wheelright = 0

home = distto(dockx, docky)
needed = home / 25 + 22

wheelleft = 25
wheelright = 25

if state == 1:           # در راه خانه
    if atgoal == 1:
        wheelleft = 0    # روی پد بمان تا پر شوی
        wheelright = 0
        if battery > 95:
            state = 0    # پر شد -> برگرد سر کار
elif battery < needed:   # وقتِ رفتن است!
    state = 1
    goto(dockx, docky)
elif front < 55:
    wheelleft = 18
    wheelright = -18

home = distto(dockx, docky)

if state == 2:           # حالت ۲: نوشیدن
    wheelleft = 0
    wheelright = 0
    if battery > 95:
        state = 0

elif state == 1:         # حالت ۱: در راه خانه
    if bumper == 1:
        stopgoto()
        backward(1)
        goto(dockx, docky)
    elif home < 25:      # رسیدیم
        stopgoto()
        state = 2

else:                    # حالت ۰: تمیزکاری
    wheelleft = 25
    wheelright = 25
    if battery < home / 25 + 22:
        state = 1
        goto(dockx, docky)
    elif front < 55:
        wheelleft = 18
        wheelright = -18