# آموزش آردوینو از صفر بدون خرید برد: اولین برنامه در شبیه‌ساز

**می‌توانی آردوینو را بدون برد واقعی یاد بگیری:** در شبیه‌ساز رایگان یادستان یک Arduino Uno مجازی هست که کد Arduino C++ را اجرا می‌کند. برنامه با دو تابع ساخته می‌شود، `setup()` که یک بار اجرا می‌شود و `loop()` که بی‌پایان تکرار می‌شود. در این مقاله چشمک‌زن و خواندن دکمه را می‌نویسی و در آخر می‌بینی روی برد واقعی چه چیزهایی فرق می‌کند.

آردوینو یک برد کوچک الکترونیکی است با یک تراشهٔ برنامه‌پذیر. برنامه‌ای که روی کامپیوتر می‌نویسی روی این تراشه می‌رود و از آن به بعد خود برد چراغ، دکمه، موتور یا حسگر را کنترل می‌کند. Uno رایج‌ترین مدل آن است.

> **ایمنی.** هر چه در این مقاله هست با USB یا همان شبیه‌ساز کار می‌کند. روی برد واقعی، LED را همیشه با مقاومت سری ببند و مدار را فقط وقتی USB جداست عوض کن. پایه‌های Uno ۵ ولتی‌اند؛ هر پایه بیش از حدود ۲۰ میلی‌آمپر نباید بدهد. برق شهر موضوع هیچ آزمایشی نیست.

## ساختار هر برنامهٔ آردوینو

```cpp
void setup() {
  // runs once at power-up or reset
}

void loop() {
  // runs again and again, forever
}
```

تابع یعنی یک تکه کد اسم‌دار که با هم اجرا می‌شود. `void` یعنی تابع چیزی برنمی‌گرداند. آکولادها `{ }` بدنهٔ تابع را مشخص می‌کنند و هر دستور با نقطه‌ویرگول `;` تمام می‌شود. هر چیزی که بعد از `//` بیاید توضیح (comment) است و اجرا نمی‌شود. کامپایلر برنامه‌ای است که کد تو را به زبان تراشه ترجمه می‌کند. اگر نقطه‌ویرگولی را فراموش کنی، کامپایلر خطا می‌دهد؛ رایج‌ترین خطای تازه‌کارهاست.

## چشمک‌زن: دو دستور اصلی

```cpp
void setup() {
  pinMode(13, OUTPUT);       // pin 13 is an output
}

void loop() {
  digitalWrite(13, HIGH);    // LED on
  delay(500);                // wait 500 ms
  digitalWrite(13, LOW);     // LED off
  delay(500);
}
```

پایه (pin) همان سوزن‌های فلزی کنار برد است که هر کدام شماره دارد و قطعه‌ها به آن‌ها وصل می‌شوند.

- `pinMode(13, OUTPUT)` پایهٔ ۱۳ را خروجی می‌کند، یعنی برد روی آن ولتاژ می‌گذارد.
- `digitalWrite(13, HIGH)` پایه را روی ۵ ولت می‌برد و `LOW` روی صفر.
- `delay(500)` برنامه را ۵۰۰ میلی‌ثانیه (نیم ثانیه) نگه می‌دارد.

چون `loop()` مدام تکرار می‌شود، این چهار خط پشت‌سرهم اجرا می‌شوند: نیم ثانیه روشن، نیم ثانیه خاموش، و دوباره از اول.

مدار: پایهٔ ۱۳ به یک مقاومت `220Ω`، از مقاومت به پایهٔ بلند (آند) LED، و پایهٔ کوتاه LED به `GND`. با ۵ ولت و افت حدود ۲ ولت روی LED قرمز، جریان تقریباً `(5 − 2) / 220 ≈ 14 mA` است که در حد امن پایه است. دلیل لازم‌بودن مقاومت را در [مقالهٔ LED](/blog/led) و [راهنمای مقاومت](/blog/resistor-complete-guide) بخوان.

برای امتحان، [ویرایشگر پروژهٔ آزمایشگاه](/lab/editor) را باز کن و برد را Arduino Uno انتخاب کن؛ یک LED از قبل روی پایهٔ ۱۳ وصل است. کد را بچسبان و اجرا کن. اگر LED چشمک بزند، اولین برنامه‌ات کار می‌کند.

## خواندن یک دکمه

```cpp
void setup() {
  pinMode(13, OUTPUT);
  pinMode(2, INPUT_PULLUP);   // internal pull-up on pin 2
}

void loop() {
  if (digitalRead(2) == LOW) {   // pressed reads LOW
    digitalWrite(13, HIGH);
  } else {
    digitalWrite(13, LOW);
  }
}
```

یک پایهٔ دکمه را به پایهٔ ۲ و پایهٔ آن‌طرف را به `GND` وصل کن. `digitalRead(2)` وضعیت پایهٔ ۲ را می‌خواند و `HIGH` یا `LOW` برمی‌گرداند. `if` یعنی «اگر شرط درست بود این را اجرا کن» و `else` یعنی «وگرنه آن را». `INPUT_PULLUP` مقاومتی داخل تراشه را فعال می‌کند که پایه را وقتی دکمه رها است روی `HIGH` نگه می‌دارد. پس منطق **وارونه** است: دکمهٔ فشرده `LOW` می‌دهد. به یاد داشته باش که شرط با `==` (مقایسه) نوشته می‌شود، نه `=` (انتساب)؛ اشتباهش برنامه را بی‌صدا خراب می‌کند. دلیل pull-up را در [مقالهٔ دکمهٔ فشاری](/blog/pushbutton) توضیح داده‌ایم.

## روی برد واقعی چه فرق می‌کند

| موضوع | شبیه‌ساز | برد واقعی |
|---|---|---|
| ارسال کد | کد را می‌چسبانی و اجرا می‌کنی | Arduino IDE را نصب می‌کنی، برد و درگاه را انتخاب می‌کنی و Upload می‌زنی |
| زمان‌بندی | رفتاری (behavioral)، نه چرخه‌به‌چرخه | کلاک ۱۶ مگاهرتز واقعی |
| سیم‌کشی | یک اشتباه فقط پیام خطا می‌دهد | یک سیم غلط می‌تواند به قطعه آسیب بزند |
| نویز و لقی سیم | ندارد | دکمه ممکن است چند بار پشت‌سرهم بپرد |
| کابل | لازم نیست | کابل USB نوع B برای Uno، از نوع دیتا |

نکتهٔ آخر مهم است: روی دکمهٔ واقعی ممکن است در لحظهٔ فشار چند بار تماس برقرار و قطع شود (`bounce`). برای روشن و خاموش ساده مهم نیست؛ وقتی می‌خواهی شمارش بگیری، مهم می‌شود.

شبیه‌ساز مدار را با حل‌کنندهٔ آنالوگ واقعی حل می‌کند و ولتاژ و جریان را با مولتی‌متر و اسیلوسکوپ نشان می‌دهد. ولی زمان‌بندی دقیق چرخه‌ها را نمی‌سنجد و PWM (روشن و خاموش کردن خیلی سریع یک پایه، مثلاً برای کم‌نور کردن LED) را به‌صورت میانگین نشان می‌دهد. برای یادگرفتن منطق و سیم‌کشی کافی است، نه برای اندازه‌گیری دقیق زمان.

اگر می‌خواهی الکترونیک را از پایه، با مدار و بعد کد، پیش بروی، [خودآموز جریان](/courses/jaryan) از مدار بسته شروع می‌کند و همین شبیه‌ساز را به کار می‌برد. برای آشنایی با خود شبیه‌ساز [شبیه‌ساز آنلاین مدار](/blog/online-circuit-simulator) را هم ببین.

---
Source: https://yaadestan.com/blog/arduino-without-a-board (یادستان, Yaadestan)
