تغییر نام وای فای برد ESP32 (ویرایش HostName)

در این آموزش یاد میگیرید که چگونه نام میزبان (Hostname) ماژول ESP32 را دریافت کرده و آن را به یک نام سفارشی تغییر دهید. این کار بسیار ساده است، اما باید مراحل را دقیقاً به ترتیب صحیح انجام دهید تا بدون خطا اجرا شود.
قبل از شروع، باید ESP32 Arduino Core را در محیط Arduino IDE نصب کرده باشید تا بتوانید پروژههای مخصوص ESP32 را کامپایل و آپلود کنید.
دریافت نام میزبان (ESP32 Get Hostname)
نام میزبان (Hostname) در ESP32، همان نامی است که سایر دستگاههای WiFi در شبکه، ماژول شما را با آن میبینند.
برای دریافت این نام، از تابع زیر استفاده میشود:
Serial.println(WiFi.getHostname());
با اجرای این دستور، نام پیشفرض ماژول ESP32 روی مانیتور سریال چاپ میشود.
بهصورت پیشفرض، نامی که ماژول به شبکه معرفی میکند معمولاً یک رشته تصادفی و عمومی است، مشابه تصویر زیر:

همانطور که میبینید، این نام چندان گویا نیست و بهتر است برای مدیریت بهتر در شبکه، آن را به یک نام اختصاصی و معنیدار تغییر دهید.
در بخش بعدی، دقیقاً یاد میگیرید چگونه این کار را انجام دهید.
تغییر نام Hostname در ESP32 با Arduino IDE
برای تغییر نام Hostname در ماژول ESP32، باید تابع WiFi.setHostname() را قبل از فراخوانی توابع WiFi.mode() و WiFi.begin() اجرا کنید — دقیقاً به همین ترتیب.
اگر ترتیب رعایت نشود، تغییر نام اعمال نخواهد شد.
مثال: تغییر Hostname سفارشی در ESP32
#include <WiFi.h>
// اطلاعات شبکه WiFi خود را وارد کنید
const char* ssid = "yourNetworkSSID";
const char* password = "yourNetworkPassword";
const char* MyHostName = "ESP32-Test";
void setup(){
Serial.begin(115200);
WiFi.setHostname(MyHostName); // تنظیم نام Host پیش از اتصال
WiFi.mode(WIFI_STA); // تنظیم حالت WiFi به Station Mode
WiFi.begin(ssid, password); // اتصال به شبکه
Serial.println("\nConnecting to WiFi Network ..");
// انتظار تا زمان برقراری اتصال
while(WiFi.status() != WL_CONNECTED){
Serial.print(".");
delay(100);
}
// چاپ IP و نام جدید ESP32
Serial.println("\nConnected to the WiFi network");
Serial.print("Local ESP32 IP: ");
Serial.println(WiFi.localIP());
Serial.print("ESP32 HostName: ");
Serial.println(WiFi.getHostname());
}
void loop(){
// هیچ کاری انجام نمیدهد
}
پس از آپلود این کد، خروجی روی مانیتور سریال نمایش داده میشود. در صورتی که در اولین اجرا پیامها را مشاهده نکردید، ESP32 را یک بار ریستارت کنید.

پس از اجرای موفق، روتر شما نام جدید ماژول را بهصورت زیر تشخیص میدهد:

در برخی موارد ممکن است لازم باشد چند ثانیه صبر کنید یا حتی مودم را ریستارت کنید تا نام جدید در شبکه بهروزرسانی شود.
در بیشتر موارد، تغییر بهصورت آنی اعمال میشود.
نکته مهم
رشتهی Hostname در ESP32 فقط میتواند شامل:
- حروف (A-Z, a-z)
- اعداد (0-9)
- و کاراکتر خط تیره
-باشد.
از سایر کاراکترها مانند فاصله، علامتها یا حروف خاص استفاده نکنید.
سعی کنید نام انتخابی کوتاه، خوانا و توصیفی باشد تا در شبکه بهراحتی شناسایی شود.
فهرست قطعات مورد نیاز
برای انجام آزمایشهای این مقاله و دیگر آموزشهای سری ESP32، به قطعات زیر نیاز دارید (این لینکها به کیتهای پیشنهادی آموزشی مربوطاند):
- برد ESP32
- Breadboard و سیم جامپر
- کابل USB و منبع تغذیه مناسب
در این آموزش یاد گرفتید که Hostname پیشفرض ESP32 یک نام عمومی و تصادفی است که سایر دستگاهها در شبکه آن را مشاهده میکنند.
با اجرای چند خط ساده کد، میتوانید آن را به نامی سفارشی و معنادار تغییر دهید.








