ESP8266 – ESP8266WiFiSTA库 – hostname

说明

利用hostname函数可以获取WiFi路由器分配给ESP8266模块的主机名，同时也可以输入参数手动给ESP8266模块设置hostname（主机名）。

语法

WiFi.hostname()
WiFi.hostname(hostname)

简例：

Serial.printf("当前的hostname: %s\n", WiFi.hostname().c_str());//读取当前的hostname并输出
Serial.printf("即将修改hostname为Station_Taichi");
WiFi.hostname("Station_Taichi");//设置新的hostname
Serial.printf("当前hostname: %s\n", WiFi.hostname().c_str());

Serial.printf("当前的hostname: %s\n", WiFi.hostname().c_str());//读取当前的hostname并输出

Serial.printf("即将修改hostname为Station_Taichi");

WiFi.hostname("Station_Taichi");//设置新的hostname

Serial.printf("当前hostname: %s\n", WiFi.hostname().c_str());

参数

hostname，数据类型可为String型。我们手动设置的主机名的最大长度为32个字符。可以使用大写字母（A-Z），小写字母（a-z），数字（0-9），符号（.）和符号（-）。大小写字母之间没有区别，不允许将空格或者空格字符作为hostname。这里只列举了一部分规则，详细说明请参阅此链接：https://github.com/esp8266/Arduino/blob/master/libraries/ESP8266WiFi/src/ESP8266WiFiSTA.cpp。一旦hostname超过32个字符的限制, 则无法完成主机名设置。

返回值

输入参数的情况下，如果设置新的hostname成功，会返回true。如果超过了32个字符的限制，或者设置失败，则函数将返回false而不会分配新的主机名。返回值数据类型为布尔型。

没有输入参数的情况下，会返回当前的hostname，数据类型为string型。

示例程序

当您将WiFi连接信息修改后并且将本示例程序上传ESP8266开发板后，开发板随即会自动连接WiFi。WiFi连接成功后，您将通过串口监视器看到ESP8266模块的主机名称。我们是通过以下示例程序中的WiFi.hostname()来获取该主机名的。在程序的后续部分中，我们使用了WiFi.hostname(“Station_Taichi”)来将ESP8266模块的主机名改为Station_Taichi。

/**********************************************************************
  项目名称/Project          : 零基础入门学用物联网
  程序名称/Program name     : WiFi.hostname();演示
  团队/Team                : 太极创客团队 / Taichi-Maker (www.taichi-maker.com)
  作者/Author              : 小黑
  日期/Date（YYYYMMDD）     : 20200405
  程序目的/Purpose          :
  此程序使用ESP8266WiFiSTA库来演示在无线终端模式下获取hostname并修改
  -----------------------------------------------------------------------
  本示例程序为太极创客团队制作的《零基础入门学用物联网》中示例程序。
  该教程为对物联网开发感兴趣的朋友所设计和制作。如需了解更多该教程的信息，请参考以下网页：
  http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/iot-c/esp8266-nodemcu-web-client/http-request/
***********************************************************************/
#include <ESP8266WiFi.h>

#define AP_ssid   "TaichiMaker_WIFI" //这里改成你的设备当前环境下要连接的接入点名字
#define password  "xxxxxxxx"         //这里改成你的设备当前环境下要连接的接入点密码

int i = 0;//用来判定连接是否超时的累加量

void setup(void)
{
  Serial.begin(9600);  // 启动串口通讯，波特率设置为9600
  Serial.println("开始连接");
  
  //调用 WiFi.begin()函数，开始连接接入点
  WiFi.begin(AP_ssid, password);
  Serial.print("正在连接到");
  Serial.print(AP_ssid);
  
  //这里的循环用来判断是否连接成功的。连接过程中每隔500毫秒会检查一次是否连接成功，，并打一个点表示正在连接中
  //连接成功后会给出提示，但是若60秒后还是没有连接上，则会提示超时
  while (WiFi.status() != WL_CONNECTED) {
    i++;
    delay(500);
    Serial.print(".");
    if (i > 120) { //60秒后如果还是连接不上，就判定为连接超时
      Serial.print("连接超时！请检查网络环境");
      break;
    }
  }
  Serial.println("网络连接成功");
  
  //这一部分用来输出连接网络的基本信息
  Serial.println("500");              // 延时500毫秒
  Serial.print("当前工作模式:");     // 告知用户设备当前工作模式
  Serial.println(WiFi.getMode());
  Serial.print("连接到的接入点名字:");
  Serial.println(AP_ssid);            // 告知用户建立的接入点WiFi名
  Serial.print("连接到的接入点密码:");
  Serial.println(password);        // 告知用户建立的接入点WiFi密码
  Serial.print("无线终端模式成功开启，网络连接成功");
  delay(1000);
  Serial.printf("当前的hostname: %s\n", WiFi.hostname().c_str());//读取当前的hostname并输出
  Serial.printf("即将修改hostname为Station_Taichi");
  delay(1000);
  WiFi.hostname("Station_Taichi");//设置新的hostname
  Serial.printf("当前hostname: %s\n", WiFi.hostname().c_str());
}

void loop() {
  delay(1000);
}

/**********************************************************************

项目名称/Project : 零基础入门学用物联网

程序名称/Program name : WiFi.hostname();演示

团队/Team : 太极创客团队 / Taichi-Maker (www.taichi-maker.com)

作者/Author : 小黑

日期/Date（YYYYMMDD） : 20200405

程序目的/Purpose :

此程序使用ESP8266WiFiSTA库来演示在无线终端模式下获取hostname并修改

-----------------------------------------------------------------------

本示例程序为太极创客团队制作的《零基础入门学用物联网》中示例程序。

该教程为对物联网开发感兴趣的朋友所设计和制作。如需了解更多该教程的信息，请参考以下网页：

http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/iot-c/esp8266-nodemcu-web-client/http-request/

***********************************************************************/

#include <ESP8266WiFi.h>

#define AP_ssid "TaichiMaker_WIFI" //这里改成你的设备当前环境下要连接的接入点名字

#define password "xxxxxxxx" //这里改成你的设备当前环境下要连接的接入点密码

int i = 0;//用来判定连接是否超时的累加量

void setup(void)

{

Serial.begin(9600); // 启动串口通讯，波特率设置为9600

Serial.println("开始连接");

//调用 WiFi.begin()函数，开始连接接入点

WiFi.begin(AP_ssid, password);

Serial.print("正在连接到");

Serial.print(AP_ssid);

//这里的循环用来判断是否连接成功的。连接过程中每隔500毫秒会检查一次是否连接成功，，并打一个点表示正在连接中

//连接成功后会给出提示，但是若60秒后还是没有连接上，则会提示超时

while (WiFi.status() != WL_CONNECTED) {

i++;

delay(500);

Serial.print(".");

if (i > 120) { //60秒后如果还是连接不上，就判定为连接超时

Serial.print("连接超时！请检查网络环境");

break;

}

Serial.println("网络连接成功");

//这一部分用来输出连接网络的基本信息

Serial.println("500"); // 延时500毫秒

Serial.print("当前工作模式:"); // 告知用户设备当前工作模式

Serial.println(WiFi.getMode());

Serial.print("连接到的接入点名字:");

Serial.println(AP_ssid); // 告知用户建立的接入点WiFi名

Serial.print("连接到的接入点密码:");

Serial.println(password); // 告知用户建立的接入点WiFi密码

Serial.print("无线终端模式成功开启，网络连接成功");

delay(1000);

Serial.printf("当前的hostname: %s\n", WiFi.hostname().c_str());//读取当前的hostname并输出

Serial.printf("即将修改hostname为Station_Taichi");

delay(1000);

WiFi.hostname("Station_Taichi");//设置新的hostname

Serial.printf("当前hostname: %s\n", WiFi.hostname().c_str());

}

void loop() {

delay(1000);

}

位置导航: ESP8266库 / ESP8266WiFiSTA库 / 本页