خانه هوشمند فقط خرید چند لامپ یا پریز هوشمند آماده نیست. اگر بخواهید خانهای بسازید که واقعاً قابل توسعه، قابل شخصیسازی و مستقل از سرویسهای ابری باشد، باید با ابزارهایی مثل Home Assistant و ESPHome آشنا شوید.

ESPHome یکی از مهمترین ابزارهای دنیای خانه هوشمند متنباز است. این ابزار به شما کمک میکند بردهایی مثل ESP32، ESP8266 و چند مدل میکروکنترلر دیگر را به دستگاههای هوشمند تبدیل کنید؛ بدون اینکه لازم باشد از صفر برنامهنویسی پیچیده انجام دهید. سایت رسمی ESPHome هم این ابزار را راهی برای تبدیل بردهایی مثل ESP32، ESP8266، BK72xx و RP2040 به دستگاههای هوشمند با تنظیمات ساده YAML معرفی میکند.
به زبان ساده، ESPHome یعنی شما میتوانید با یک برد کوچک و ارزان، سنسور دما، رله هوشمند، کلید لمسی، کنترلر نور، سنسور در و پنجره، کنترلر کولر، نمایشگر وضعیت خانه یا حتی Bluetooth Proxy برای Home Assistant بسازید.
ESPHome دقیقاً چه کاری انجام میدهد؟
برای درک بهتر ESPHome، فرض کنید یک برد ESP32 دارید. این برد بهتنهایی فقط یک قطعه الکترونیکی خام است. اما وقتی روی آن firmware مناسب نصب شود، میتواند به یک دستگاه هوشمند تبدیل شود.
ESPHome این فرایند را ساده میکند. شما در یک فایل تنظیمات، معمولاً با فرمت YAML، مشخص میکنید که چه قطعاتی به برد وصل هستند؛ مثلاً یک سنسور دما، یک رله، یک LED، یک کلید یا یک نمایشگر کوچک. بعد ESPHome بر اساس همان تنظیمات، firmware مخصوص همان دستگاه را میسازد و روی برد نصب میکند. در راهنمای رسمی ESPHome هم توضیح داده شده که تنظیمات ESPHome شامل یک یا چند فایل YAML است و ESPHome بر اساس آنها firmware اختصاصی تولید میکند؛ سپس سختافزارهایی مثل سنسورها، سوئیچها و چراغها میتوانند در رابط Home Assistant ظاهر شوند.
پس ESPHome یک ابزار واسطه است؛ بین قطعات الکترونیکی ساده و یک سیستم خانه هوشمند واقعی.
ارتباط ESPHome با Home Assistant چیست؟
ESPHome بهتنهایی مفید است، اما قدرت اصلی آن زمانی مشخص میشود که با Home Assistant استفاده شود. Home Assistant مرکز کنترل خانه هوشمند است و ESPHome به شما اجازه میدهد دستگاههای سفارشی خودتان را به این مرکز کنترل متصل کنید.
بعد از اینکه یک دستگاه ESPHome را راهاندازی و فلش کردید، Home Assistant معمولاً میتواند آن را شناسایی کند. سپس دستگاه به بخش Devices & Services اضافه میشود و سنسورها، رلهها یا کلیدهای ساختهشده با ESPHome در داشبورد Home Assistant قابل کنترل میشوند.
طبق مستندات Home Assistant، دستگاههای ESPHome بعد از فلش شدن میتوانند از طریق ESPHome Native API با Home Assistant یکپارچه شوند. این ارتباط مستقیم برای اتوماسیون و مانیتورینگ لحظهای استفاده میشود.
این موضوع برای خانه هوشمند اهمیت زیادی دارد، چون باعث میشود ارتباط دستگاهها سریعتر، پایدارتر و محلیتر باشد. یعنی برای بسیاری از کارها لازم نیست فرمان شما از خانه خارج شود، به سرور ابری برود و دوباره برگردد. دستگاه ESPHome میتواند در شبکه داخلی خانه با Home Assistant ارتباط بگیرد.
Native API در ESPHome یعنی چه؟
یکی از دلایل محبوبیت ESPHome، ارتباط سریع آن با Home Assistant از طریق Native API است. Native API یک روش ارتباطی اختصاصی و بهینهشده برای ارتباط بین دستگاه ESPHome و Home Assistant است.
مستندات رسمی ESPHome توضیح میدهد که Native API برای ارتباط مستقیم با کلاینتها استفاده میشود و یک پروتکل شبکهای بهینهشده است. همچنین در حال حاضر ابزار ESPHome، Home Assistant و ioBroker از این API استفاده میکنند.
مزیت این روش این است که Home Assistant لازم نیست مدام از دستگاه بپرسد «وضعیتت چیست؟». در عوض، وقتی وضعیت دستگاه تغییر میکند، اطلاعات سریعتر ارسال میشود. مثلاً اگر دمای اتاق تغییر کند، یک کلید فشرده شود یا سنسور در و پنجره فعال شود، Home Assistant میتواند سریعتر واکنش نشان دهد. مستندات Home Assistant هم توضیح میدهد که در این ارتباط، Home Assistant اتصال پایداری با دستگاه ESPHome حفظ میکند و تغییرات وضعیت میتوانند تقریباً بلافاصله ارسال شوند.
با ESPHome چه چیزهایی میتوان ساخت؟

یکی از جذابترین ویژگیهای ESPHome این است که محدود به یک نوع دستگاه نیست. شما میتوانید با آن دستگاههای مختلفی بسازید و دقیقاً مطابق نیاز خانه خودتان تنظیمشان کنید.
چند نمونه کاربردی ESPHome در خانه هوشمند:
۱. سنسور دما و رطوبت
میتوانید با یک برد ESP32 یا ESP8266 و یک سنسور دما و رطوبت، وضعیت اتاقها را در Home Assistant ببینید. این اطلاعات بعداً میتواند برای کنترل کولر، فن، گرمایش یا هشدارهای دمایی استفاده شود.
۲. رله هوشمند
با ESPHome میتوانید یک رله را کنترل کنید و از آن برای روشن و خاموش کردن چراغ، پمپ، فن یا سایر تجهیزات استفاده کنید. البته اگر با برق شهری ۲۲۰ ولت کار میکنید، حتماً باید نکات ایمنی را رعایت کنید و در پروژههای واقعی از برقکار متخصص کمک بگیرید.
۳. کلید دیواری هوشمند
میتوانید کلیدهای فیزیکی خانه را به Home Assistant متصل کنید؛ بهطوری که هم از روی دیوار قابل استفاده باشند و هم از طریق موبایل، داشبورد یا اتوماسیون کنترل شوند.
۴. سنسور نشتی آب
یکی از پروژههای مفید ESPHome ساخت سنسور نشتی آب برای زیر سینک، کنار ماشین لباسشویی، موتورخانه یا محل عبور لولههاست. این سنسور میتواند هنگام نشتی، به Home Assistant هشدار بدهد.
۵. کنترلر مادون قرمز
با یک فرستنده IR میتوانید وسایلی مثل کولر گازی، تلویزیون یا دستگاههای قدیمیتر را به خانه هوشمند متصل کنید.
۶. Bluetooth Proxy
ESPHome میتواند برای گسترش پوشش بلوتوث در خانه هم استفاده شود. صفحه پروژههای آماده ESPHome نمونههایی مثل Bluetooth proxy، voice assistant، media player و infrared/radio frequency proxy را معرفی میکند.
ESPHome برای چه کسانی مناسب است؟
ESPHome برای چند گروه بسیار مناسب است.
اول، کسانی که از Home Assistant استفاده میکنند و میخواهند خانه هوشمندشان فقط به محصولات آماده محدود نباشد. این افراد میتوانند با ESPHome دستگاههایی بسازند که دقیقاً با نیازشان هماهنگ است.
دوم، کسانی که به پروژههای DIY علاقه دارند. اگر دوست دارید خودتان سنسور، رله، کنترلر یا ابزارهای هوشمند بسازید، ESPHome یکی از بهترین گزینههاست.
سوم، افرادی که به کنترل محلی اهمیت میدهند. بسیاری از تجهیزات آماده خانه هوشمند به اپلیکیشن، اینترنت یا سرور شرکت سازنده وابسته هستند. اما ESPHome میتواند در بسیاری از سناریوها بهصورت محلی و داخل شبکه خانه کار کند.
چهارم، کسانی که میخواهند هزینه ساخت تجهیزات خانه هوشمند را کاهش دهند. با یک برد ESP32، چند قطعه ساده و کمی زمان، میتوانید دستگاهی بسازید که نمونه آماده آن گرانتر است یا دقیقاً مطابق نیاز شما نیست.
ESP32 بهتر است یا ESP8266؟

در بیشتر پروژههای جدید ESPHome، استفاده از ESP32 پیشنهاد میشود. ESP32 معمولاً قدرت پردازشی بهتر، حافظه بیشتر و امکانات بیشتری مثل Bluetooth دارد. برای پروژههایی مثل Bluetooth Proxy، پردازشهای سنگینتر، نمایشگرها یا چند سنسور همزمان، ESP32 انتخاب مناسبتری است.
ESP8266 هنوز هم برای پروژههای ساده کاربرد دارد. مثلاً اگر فقط میخواهید یک رله، یک سنسور ساده یا یک کلید بسازید، ESP8266 میتواند کافی باشد. اما اگر قرار است پروژه قابل توسعهتر باشد، بهتر است از ابتدا سراغ ESP32 بروید.
مستندات Home Assistant هم اشاره میکند که ESPHome فقط محدود به ESP32 و ESP8266 نیست و از خانوادههای دیگری مثل BK72xx، RP2040 و RTL87xx هم پشتیبانی میکند.
ESPHome Device Builder چیست؟
برای شروع کار با ESPHome، یکی از سادهترین راهها استفاده از ESPHome Device Builder است. این ابزار یک رابط کاربری تحت وب در اختیار شما میگذارد تا بتوانید دستگاهها را بسازید، تنظیمات آنها را ویرایش کنید و firmware را روی برد نصب کنید.
راهنمای رسمی ESPHome میگوید سادهترین روش شروع، نصب ESPHome روی دستگاه یا میکروکنترلر از طریق ESPHome Device Builder در Home Assistant است.
در نسخههای جدید ESPHome، Device Builder اهمیت بیشتری پیدا کرده است. در changelog نسخه 2026.6.0 آمده که ESPHome داشبورد قدیمی را بازنشسته کرده و ESPHome Device Builder را جایگزین آن کرده است. این نسخه همچنین امکاناتی مثل ویرایش بصری، کاتالوگ قطعات، نمایش اطلاعات پینها و صف پردازش firmware را معرفی کرده است.
این تغییر برای کاربران تازهکار مهم است؛ چون شروع کار با ESPHome را سادهتر میکند. البته کاربران حرفهای همچنان میتوانند فایل YAML را مستقیماً ویرایش کنند.
نمونه ساده تنظیمات ESPHome
برای اینکه بهتر متوجه شوید ESPHome چگونه کار میکند، به این نمونه ساده نگاه کنید. فرض کنید میخواهیم یک رله را روی یکی از پایههای برد کنترل کنیم:
switch:
- platform: gpio
name: "Living Room Light"
pin: GPIO5
در این مثال، یک خروجی از نوع GPIO تعریف شده و نام آن در Home Assistant بهصورت Living Room Light نمایش داده میشود. البته این فقط یک نمونه ساده است و در پروژه واقعی باید نوع برد، پین مناسب، تغذیه، ایمنی و نحوه اتصال قطعات با دقت بررسی شود.
مزایای ESPHome در خانه هوشمند
ESPHome چند مزیت مهم دارد که آن را به یکی از ابزارهای محبوب در دنیای خانه هوشمند تبدیل کرده است.
۱. نیاز کمتر به برنامهنویسی پیچیده
برای شروع با ESPHome لازم نیست از ابتدا کدنویسی C++ انجام دهید. بسیاری از کارها با فایل YAML قابل انجام است. سایت رسمی ESPHome هم روی همین نکته تأکید دارد و استفاده از فایلهای YAML ساده را بهجای کدنویسی پیچیده C++ معرفی میکند.
۲. مناسب برای پروژههای سفارشی
گاهی محصول آمادهای که دقیقاً نیاز شما را برطرف کند وجود ندارد. مثلاً شاید بخواهید یک سنسور چندکاره بسازید که هم دما را اندازه بگیرد، هم وضعیت در را تشخیص دهد، هم یک LED هشدار داشته باشد. ESPHome برای چنین پروژههایی بسیار مناسب است.
۳. هماهنگی عالی با Home Assistant
دستگاههای ESPHome بهخوبی با Home Assistant کار میکنند و میتوانند در اتوماسیونها، داشبوردها و سناریوهای هوشمندسازی استفاده شوند.
۴. کنترل محلی و وابستگی کمتر به ابر
در بسیاری از پروژهها، ESPHome میتواند داخل شبکه محلی خانه کار کند. این موضوع برای کاربرانی که به حریم خصوصی و پایداری اهمیت میدهند بسیار ارزشمند است.
۵. بهروزرسانی بیسیم
یکی از امکانات مهم ESPHome، امکان بهروزرسانی دستگاهها از طریق شبکه است. سایت رسمی ESPHome هم قابلیت Wireless Updates را بهعنوان یکی از مزیتها معرفی میکند؛ یعنی بعد از راهاندازی اولیه، میتوانید بدون دسترسی فیزیکی مستقیم، دستگاه را بهروزرسانی کنید.
محدودیتها و نکات مهم قبل از شروع
با وجود مزایای زیاد، ESPHome برای همه افراد و همه پروژهها بهترین انتخاب نیست. اگر فقط میخواهید یک وسیله آماده بخرید، نصب کنید و هیچ درگیری فنی نداشته باشید، شاید محصولات آماده بازار برای شما سادهتر باشند.
اما اگر میخواهید خانه هوشمندتان قابل توسعه، دقیق و شخصیسازیشده باشد، ESPHome ارزش یادگیری دارد.
چند نکته مهم قبل از شروع:
- برای کار با ESPHome باید کمی با مفاهیمی مثل Wi‑Fi، برد، سنسور، GPIO و firmware آشنا شوید.
- در پروژههای متصل به برق شهری، ایمنی بسیار مهم است.
- هر پین GPIO برای هر کاری مناسب نیست.
- کیفیت تغذیه برد و رلهها روی پایداری پروژه تأثیر زیادی دارد.
- قبل از آپدیت نسخههای جدید، بهتر است changelog رسمی ESPHome را بررسی کنید.
بهخصوص در نسخههای جدید، ممکن است تغییراتی ایجاد شود که روی پروژههای قبلی تأثیر بگذارد. برای مثال، در changelog نسخه 2026.6.0 به چند نکته مهاجرت و تغییر رفتار اشاره شده است؛ از جمله تغییرات مربوط به امنیت Wi‑Fi در ESP8266 و مهاجرت از custom_components/ به external_components:.
آیا ESPHome برای شروع خانه هوشمند گزینه خوبی است؟

بله، بهخصوص اگر قصد دارید خانه هوشمند خود را با Home Assistant بسازید. ESPHome به شما آزادی عمل زیادی میدهد. میتوانید از پروژههای ساده شروع کنید و بعد بهمرور سراغ سناریوهای حرفهایتر بروید.
برای شروع، پیشنهاد میشود ابتدا یک پروژه ساده انجام دهید؛ مثلاً:
- ساخت سنسور دما و رطوبت اتاق
- ساخت یک رله ساده برای کنترل چراغ آزمایشی
- اتصال یک کلید فیزیکی به Home Assistant
- ساخت سنسور در و پنجره
- ساخت Bluetooth Proxy با ESP32
بعد از انجام چند پروژه ساده، درک شما از ESPHome، Home Assistant و ساختار خانه هوشمند بسیار بهتر میشود.
مسیر پیشنهادی یادگیری ESPHome

اگر تازه میخواهید وارد ESPHome شوید، بهتر است این مسیر را دنبال کنید:
ابتدا با مفهوم ESPHome، Home Assistant و ESP32 آشنا شوید. بعد ESPHome Device Builder را در Home Assistant نصب کنید. سپس یک برد ESP32 ساده تهیه کنید و اولین firmware را روی آن نصب کنید. بعد از آن، یک سنسور ساده مثل سنسور دما یا یک خروجی ساده مثل LED و رله را تست کنید.
بعد از این مرحله، میتوانید پروژههای کاربردیتری بسازید؛ مثل کنترل چراغ، سنسور نشتی آب، نمایشگر وضعیت خانه، کنترل کولر یا سیستم هشدار محلی.
مهمترین نکته این است که از پروژههای ساده شروع کنید. بسیاری از خطاهای ESPHome مربوط به انتخاب اشتباه برد، پین نامناسب، تغذیه ضعیف یا تنظیمات YAML اشتباه هستند. اگر قدمبهقدم پیش بروید، یادگیری ESPHome بسیار سادهتر میشود.
جمعبندی
ESPHome یکی از بهترین ابزارها برای ساخت تجهیزات خانه هوشمند سفارشی است. این ابزار به شما اجازه میدهد بردهایی مثل ESP32 و ESP8266 را به سنسور، رله، کلید، نمایشگر، کنترلر و دستگاههای هوشمند مختلف تبدیل کنید.
قدرت اصلی ESPHome زمانی مشخص میشود که آن را در کنار Home Assistant استفاده کنید. در این حالت، دستگاههای ساختهشده با ESPHome میتوانند از طریق Native API با Home Assistant ارتباط مستقیم و سریع داشته باشند و در اتوماسیونهای خانه هوشمند استفاده شوند.
اگر میخواهید خانه هوشمندتان فقط وابسته به تجهیزات آماده بازار نباشد، ESPHome یکی از مهمترین مهارتهایی است که باید یاد بگیرید. با یک برد ESP32، چند قطعه ساده و کمی تمرین، میتوانید دستگاههایی بسازید که دقیقاً مطابق نیاز خانه شما کار میکنند.
در مقالات بعدی این دستهبندی، نصب ESPHome Device Builder، راهاندازی اولین برد ESP32، ساخت سنسور دما و رطوبت، ساخت رله هوشمند و بررسی ویژگیهای جدید ESPHome را آموزش خواهیم داد.
سوالات متداول
ESPHome چیست؟
ESPHome ابزاری برای تبدیل بردهایی مثل ESP32 و ESP8266 به دستگاههای هوشمند است. با ESPHome میتوانید سنسورها، رلهها، کلیدها، چراغها و نمایشگرها را به Home Assistant متصل کنید.
آیا برای ESPHome باید برنامهنویسی بلد باشم؟
برای شروع، نیاز به برنامهنویسی پیچیده ندارید. بسیاری از پروژهها با فایلهای YAML ساخته میشوند. البته برای پروژههای حرفهایتر، آشنایی بیشتر با سختافزار و تنظیمات ESPHome کمک زیادی میکند.
ESPHome بهتر است یا Tasmota؟
هر دو ابزار برای خانه هوشمند کاربرد دارند، اما ESPHome برای پروژههای سفارشی و هماهنگی عمیق با Home Assistant بسیار محبوب است. Tasmota معمولاً برای فلش کردن بعضی دستگاههای آماده و کنترل عمومیتر استفاده میشود.
ESP32 بهتر است یا ESP8266؟
برای پروژههای جدید، ESP32 معمولاً انتخاب بهتری است؛ چون قدرت بیشتر، حافظه بهتر و امکاناتی مثل Bluetooth دارد. ESP8266 هنوز برای پروژههای ساده مثل رله یا سنسور سبک قابل استفاده است.
آیا ESPHome بدون اینترنت کار میکند؟
در بسیاری از سناریوها، بله. اگر Home Assistant و دستگاه ESPHome در شبکه داخلی خانه باشند، بسیاری از فرمانها و اتوماسیونها میتوانند بهصورت محلی انجام شوند. البته برای نصب، آپدیت یا دریافت بعضی وابستگیها ممکن است به اینترنت نیاز داشته باشید.
آیا ESPHome برای پروژههای برق ۲۲۰ ولت ایمن است؟
خود ESPHome فقط نرمافزار و firmware است. ایمنی پروژه به طراحی سختافزار، نوع رله، سیمکشی، جعبه محافظ، فیوز، ارت و اجرای درست بستگی دارد. برای کار با برق شهری حتماً از فرد متخصص کمک بگیرید.