什么网站可以做软件有哪些东西吗,网站怎么做预约小程序,一般通过什么键来快速渲染场景,昆山住房和城乡建设局网站1. 项目开篇#xff1a;为什么你需要一个自己的天气站#xff1f; 不知道你有没有过这样的经历#xff1a;早上出门前#xff0c;习惯性地打开手机天气App#xff0c;匆匆看一眼温度和天气图标就冲出门#xff0c;结果半路才发现预报的“多云”变成了突如其来的阵雨…1. 项目开篇为什么你需要一个自己的天气站不知道你有没有过这样的经历早上出门前习惯性地打开手机天气App匆匆看一眼温度和天气图标就冲出门结果半路才发现预报的“多云”变成了突如其来的阵雨或者“微风”变成了能把伞吹翻的大风。手机上的天气信息虽然方便但总觉得隔了一层而且每次都要手动打开不够直观。作为一个玩了十多年嵌入式开发的老鸟我一直觉得把有用的信息“实体化”放在你抬眼就能看到的地方才是智能硬件最有魅力的地方。所以今天我想带你一起动手用一块性价比超高的ESP32-S3开发板结合简单易用的PlatformIO开发环境再加上国内非常稳定的和风天气API打造一个属于你自己的、联网的智能天气显示终端。它不仅仅是一个显示温度和天气图标的“电子相框”更是一个完整的、可定制的物联网项目实战。通过这个项目你不仅能学会如何让硬件连接网络、如何调用开放的API服务、如何处理复杂的JSON数据还能掌握将所有这些技术点串联起来构建一个完整可用的智能系统的能力。无论你是刚接触物联网的新手想找一个有成就感的入门项目还是有一定经验的开发者想找一个稳定可靠的天气数据源来丰富自己的项目这个实战教程都非常适合你。整个过程就像搭积木我们一步步来我踩过的坑、总结的技巧都会毫无保留地分享给你。2. 硬件与软件环境你的“工具箱”准备好了吗工欲善其事必先利其器。在开始敲代码之前我们需要把“战场”布置好。别担心这个项目的硬件需求非常简单软件环境搭建也有清晰的路径可循。2.1 核心硬件ESP32-S3开发板这个项目的“大脑”是一块ESP32-S3开发板。我手头用的是立创EDA的ESP32-S3R8N8开发板它集成了Wi-Fi和蓝牙功能性能足够价格亲民引脚也引出的很全非常适合学习和原型开发。当然市面上任何一款基于ESP32-S3芯片的开发板比如安信可的ESP32-S3-DevKitC-1都可以完美运行本项目。ESP32-S3相比经典的ESP32主频更高外设更丰富特别是USB接口是原生的下载调试更方便。你只需要准备一块这样的板子、一根USB数据线用于供电和下载程序即可。如果后续你想增加显示功能可以再准备一块OLED屏幕或者小尺寸的TFT屏不过我们第一步先聚焦在通过串口打印天气信息确保核心逻辑跑通。2.2 开发环境告别Arduino IDE拥抱PlatformIO很多朋友入门嵌入式喜欢用Arduino IDE因为它简单。但当我们项目稍微复杂一点需要管理多个库文件、进行版本控制或者追求更高效的开发体验时PlatformIO的优势就体现出来了。它本质上是一个嵌入式的开发平台完美集成在VSCode这个强大的编辑器里。你得到的是一个代码高亮、智能提示、一键编译下载、串口监视于一体的专业环境。安装步骤非常简单去官网下载并安装 Visual Studio Code。打开VSCode在扩展市场里搜索“PlatformIO IDE”并安装。安装完成后VSCode左侧边栏会出现一个蚂蚁头一样的PlatformIO图标点击它就进入了我们的主战场。第一次打开可能会自动安装一些核心组件稍等片刻即可。PlatformIO会自动帮你管理各种开发板平台和库省去了手动配置的无数麻烦。我实测下来它的库依赖解决和编译速度都比原生的Arduino环境要稳定和快速。2.3 关键软件库项目的“零部件”我们的项目需要几个关键的库来支持PlatformIO会让安装它们变得异常轻松。主要需要两个ArduinoJson库这是处理JSON数据的“瑞士军刀”。和风天气API返回的数据是JSON格式我们需要这个库来高效地解析出我们关心的温度、天气代码等信息。在PlatformIO中我们可以很方便地搜索并安装它。网络请求支持ESP32的Arduino核心框架已经自带了WiFi和HTTPClient库我们不需要单独安装直接包含头文件即可使用。Gzip解压库可选但推荐和风天气API返回的JSON数据默认是经过Gzip压缩的这能节省网络流量。为了在ESP32上解压我们可以使用一个轻量级的开源库比如uzlib。我们可以手动将其源码放入我们的项目库目录。准备好这三样东西——硬件板子、安装了PlatformIO的VSCode、以及了解我们需要哪些库我们的开发环境就基本就绪了。接下来我们要去获取项目的“数据源泉”和风天气API。3. 获取数据源和风天气API申请与解析实战硬件是身体软件是灵魂而数据就是让这个项目“活”起来的血液。我们需要一个可靠、免费的天气数据源和风天气是一个非常优秀的选择。3.1 注册账号与创建项目首先访问和风天气的官方网站注册一个开发者账号。这个过程很常规用邮箱即可。登录后进入控制台。你会看到一个非常清晰的管理界面。我们需要创建一个“项目”来获取唯一的API密钥KEY。点击创建项目项目名称可以随意起比如“我的桌面天气站”。关键点在于选择订阅版本一定要选择“免费订阅”。对于个人开发者和小型项目免费版提供的调用频率每天1000次完全绰绰有余而且功能齐全包含了我们需要的3天预报、实时天气等。创建成功后你会在项目列表里看到你的项目并得到一个至关重要的KEY一串由字母数字组成的字符串。请妥善保管这个KEY它就像你访问天气数据的密码不要泄露到公开的代码仓库中。我个人的习惯是在代码里用宏定义或者从外部配置文件读取这个KEY而不是硬编码在源码里。3.2 理解API调用与参数拿到KEY后我们来研究一下怎么使用它。和风天气提供了非常清晰的开发文档。我们本项目主要使用“3天天气预报”这个API。它的基本调用格式如下以免费版为例https://devapi.qweather.com/v7/weather/3d?locationYOUR_LOCATION_IDkeyYOUR_API_KEY这里有两个核心参数你需要替换YOUR_API_KEY替换成你刚才获取的那串密钥。YOUR_LOCATION_ID这是地点ID。和风天气使用一套自己的位置编码系统。你需要查询你所在城市的LocationID。如何查询LocationID呢最方便的方法是使用和风天气提供的“城市搜索”API或者在其官方提供的城市ID对照表中查找。通常你可以在其开发文档的“GeoAPI”部分找到相关信息。例如深圳的LocationID是101280601。所以一个完整的、获取深圳未来3天天气的API请求示例就是https://devapi.qweather.com/v7/weather/3d?location101280601key你的KEY。手动测试一下把你构造好的完整URL复制到浏览器的地址栏里按回车。如果一切正常你会看到浏览器返回一大段密密麻麻的JSON数据。别被它吓到这正说明你的API配置成功了这段JSON就包含了未来三天详细的天气信息如最高最低温、天气现象代码、风向风力、日出日落时间等等。3.3 解读返回的JSON数据结构我们来看看返回的JSON数据长什么样这里是一个极度简化的示例{ code: 200, updateTime: 2023-10-27T10:3008:00, fxLink: http://hfx.link/2ax1, daily: [ { fxDate: 2023-10-27, sunrise: 06:30, sunset: 17:45, tempMax: 22, tempMin: 15, iconDay: 101, textDay: 多云, iconNight: 150, textNight: 晴 }, { fxDate: 2023-10-28, sunrise: 06:31, sunset: 17:44, tempMax: 24, tempMin: 16, iconDay: 100, textDay: 晴, iconNight: 151, textNight: 多云 } // ... 第三天数据 ] }code为200表示请求成功。daily是一个数组包含了三天的数据。daily[0]是今天daily[1]是明天daily[2]是后天。对于我们这个初始项目我们最关心的是tempMax最高温、tempMin最低温和iconDay/iconNight白天/夜晚的天气图标代码。iconDay为101代表白天多云100代表晴。和风天气有详细的天气代码表我们可以根据这个代码来在显示屏上显示对应的天气图标比如太阳、云朵、雨伞的图片。理解了这个数据结构我们就知道代码里该怎么去“挖”出我们想要的数据了。接下来我们进入最核心的环节——编写代码让ESP32-S3动起来。4. 工程搭建与核心代码逐行解析环境备好数据源打通现在让我们在PlatformIO中创建项目并一步步编写代码。我会把关键代码拆开揉碎了讲确保你能看懂每一行的作用。4.1 创建PlatformIO项目与库安装打开VSCode点击左侧的PlatformIO图标选择“PIO Home”然后点击“New Project”。给项目起个名字比如esp32s3_weather_station。在Board选择框里输入esp32-s3通常会弹出Espressif ESP32-S3-DevKitC-1之类的选项选择它。框架选择Arduino。然后选择你的项目存放路径点击“Finish”。PlatformIO会自动为你创建好项目骨架包括src放源代码、include放头文件、lib放第三方库等目录。项目创建好后我们需要安装必要的库。点击PlatformIO主页的“Libraries”搜索ArduinoJson选择由Benoit Blanchon维护的那个版本通常是最高版本点击“Add to Project”并选择我们刚创建的项目。这样PlatformIO会自动在项目的platformio.ini配置文件中添加对这个库的依赖。对于Gzip解压我们需要手动处理。在项目的lib目录下新建一个文件夹命名为uzlib。然后你需要从GitHub上找到pfalcon/uzlib这个开源库将其src目录下的所有.c和.h文件下载下来拷贝到我们刚创建的lib/uzlib文件夹里。这样在编译时PlatformIO就会自动将这个库一起编译进去。4.2 封装天气数据获取类Weather Class一个好的编程习惯是把功能模块化。我们将所有与天气API交互、数据解析相关的操作封装成一个Weather类。这样在主程序里调用起来会非常清晰。首先在include目录下创建weather.h头文件定义这个类#ifndef _WEATHER_H #define _WEATHER_H #include Arduino.h #include ArduinoJson.h #include HTTPClient.h // 声明一个解压缩函数我们会在cpp文件中实现 namespace ArduinoUZlib { int decompress(uint8_t *input, uint32_t input_size, uint8_t *output, uint32_t output_size); } class Weather { public: // 构造函数传入API Key和地点ID Weather(String apiKey, String location); // 核心方法更新天气数据发起网络请求并解析 bool update(); // 获取温度数据 int getTempMax(bool is_today true); int getTempMin(bool is_today true); // 获取天气图标代码 int getWeatherIcon(bool is_today true, bool is_day true); private: String _apiKey; String _location; // 使用静态Json文档注意根据返回数据大小调整容量2048对于3天预报足够 StaticJsonDocument2048 _doc; JsonObject _today; JsonObject _tomorrow; }; #endif这个头文件就像一份蓝图说明了Weather类有哪些功能公共方法和需要哪些材料私有成员变量。接着在src目录下创建weather.cpp实现这些功能#include weather.h #include uzlib.h // 包含我们手动添加的uzlib库头文件 Weather::Weather(String apiKey, String location) { _apiKey apiKey; _location location; } bool Weather::update() { HTTPClient http; WiFiClient *client; // 1. 构造完整的API请求URL String url https://devapi.qweather.com/v7/weather/3d?location _location key _apiKey; http.begin(url); // 2. 发送GET请求 int httpCode http.GET(); if (httpCode HTTP_CODE_OK) { // 3. 获取返回的数据流和大小 client http.getStreamPtr(); int dataSize http.getSize(); // 4. 读取原始压缩数据到缓冲区 uint8_t compressedData[dataSize]; client-readBytes(compressedData, dataSize); // 5. 准备解压 uint8_t *decompressedData nullptr; uint32_t decompressedSize 0; // 6. 调用解压函数需要实现ArduinoUZlib::decompress int result ArduinoUZlib::decompress(compressedData, dataSize, decompressedData, decompressedSize); if (result 0) { // 解压成功 // 7. 解析JSON DeserializationError error deserializeJson(_doc, decompressedData, decompressedSize); free(decompressedData); // 释放解压后的内存 if (!error) { // 8. 提取今天和明天的数据对象 _today _doc[daily][0]; _tomorrow _doc[daily][1]; http.end(); return true; // 更新成功 } } // 如果解压或解析失败需要释放内存 if(decompressedData) free(decompressedData); } else { Serial.printf([HTTP] GET请求失败错误码: %d\n, httpCode); } http.end(); return false; // 更新失败 } // 其他getter方法的实现 int Weather::getTempMax(bool is_today) { JsonObject day is_today ? _today : _tomorrow; return day[tempMax].asint(); } // ... getTempMin和getWeatherIcon方法实现类似这段代码是核心中的核心。它完成了从发起HTTPS请求、接收Gzip压缩数据、解压、到最终解析JSON的全过程。我特别加入了错误处理虽然简单在实际项目中你可能会需要更健壮的处理比如网络重试、解析失败回退等。4.3 主程序逻辑main.cpp与Wi-Fi连接最后我们编写主程序文件src/main.cpp它负责统筹一切#include Arduino.h #include WiFi.h #include weather.h // 重要请修改为你自家的Wi-Fi信息 const char* ssid Your_WiFi_SSID; const char* password Your_WiFi_Password; // 重要请使用你自己申请的和风天气KEY和LocationID const char* hfKey 你的和风天气API_KEY; const char* locationId 101280601; // 例如深圳 Weather myWeather(hfKey, locationId); // 创建天气对象 void setup() { Serial.begin(115200); // 初始化串口用于打印信息 delay(1000); Serial.println(\n正在连接Wi-Fi...); WiFi.begin(ssid, password); // 等待Wi-Fi连接最多尝试20次 int retryCount 0; while (WiFi.status() ! WL_CONNECTED retryCount 20) { delay(500); Serial.print(.); retryCount; } if (WiFi.status() WL_CONNECTED) { Serial.println(\nWi-Fi连接成功); Serial.print(IP地址: ); Serial.println(WiFi.localIP()); // 尝试更新天气数据 if (myWeather.update()) { Serial.println(\n 天气数据获取成功 ); Serial.print(今天最高温: ); Serial.print(myWeather.getTempMax(true)); Serial.println(°C); Serial.print(今天最低温: ); Serial.print(myWeather.getTempMin(true)); Serial.println(°C); Serial.print(白天天气代码: ); int icon myWeather.getWeatherIcon(true, true); Serial.println(icon); // 这里可以调用一个函数根据icon代码显示对应的天气描述 // printWeatherDescription(icon); } else { Serial.println(天气数据获取失败请检查网络或API配置。); } // 断开Wi-Fi以省电如果是电池供电项目 WiFi.disconnect(true); Serial.println(Wi-Fi已断开。); } else { Serial.println(\nWi-Fi连接失败请检查密码或信号强度。); } } void loop() { // 主循环可以在这里添加定时更新逻辑例如每30分钟更新一次 // 但注意频繁更新可能触发API调用频率限制 // delay(30 * 60 * 1000); // 30分钟 // 然后重新连接Wi-Fi并调用 myWeather.update() delay(10000); // 目前先延迟10秒方便观察串口输出 }在setup()函数中我们按顺序执行初始化串口 - 连接Wi-Fi - 获取并打印天气数据 - 断开Wi-Fi。这是一个典型的单次任务流程。在loop()函数中我注释了一个定时更新的逻辑你可以根据实际需求比如连接电源的桌面摆件来启用它实现定时自动更新天气。但务必注意免费API的调用频率限制不要设置得太短。5. 编译、烧录与问题排查代码写完了激动人心的时刻到了——让代码在硬件上跑起来5.1 编译与上传用USB线将ESP32-S3开发板连接到电脑。在VSCode底部状态栏PlatformIO应该已经自动检测到了串口如COM3、COM4或/dev/ttyUSB0。如果没有你可以点击状态栏的串口图标手动选择。首先点击PlatformIO工具栏上的“√”图标或者终端里运行pio run进行编译。如果一切顺利你会在终端看到编译成功的提示并生成一个.bin或.elf文件。然后点击“→”图标或运行pio run -t upload进行上传。上传过程中开发板上的LED可能会闪烁这是正常现象。上传成功后程序会自动开始运行。5.2 查看结果与串口调试上传完成后点击PlatformIO工具栏上的“插头”图标Serial Monitor打开串口监视器。将波特率设置为代码中Serial.begin(115200)对应的115200。然后按一下开发板上的复位RST按钮。你将在串口监视器中看到程序输出的日志尝试连接Wi-Fi显示一堆“.”连接成功后的IP地址以及最重要的——获取到的天气数据如果一切正常你会看到类似这样的输出正在连接Wi-Fi... .......... Wi-Fi连接成功 IP地址: 192.168.1.100 天气数据获取成功 今天最高温: 26°C 今天最低温: 19°C 白天天气代码: 101恭喜你你的ESP32-S3已经成功联网并获取到了真实的天气数据。5.3 常见问题与解决方案在实际操作中你可能会遇到一些小麻烦别担心这都是学习的一部分编译错误找不到ArduinoJson.h或HTTPClient.h检查确保在platformio.ini文件中正确引入了库。对于ArduinoJson应该是lib_deps bblanchon/ArduinoJson^6.21.0版本号可能不同。对于HTTPClient它是ESP32 Arduino核心的一部分通常不需要额外声明但确保你的开发板平台是esp32。Wi-Fi连接失败检查ssid和password字符串是否正确确保你的Wi-Fi是2.4GHz网络ESP32通常不支持5GHz并且信号强度足够。尝试在代码中增加WiFi.setTxPower(WIFI_POWER_19_5dBm)来增强发射功率或者在WiFi.begin后增加更长的延迟。HTTP请求失败返回错误码如403、401检查你的API Key是否正确是否在请求URL中正确拼接。免费订阅是否使用了正确的域名devapi.qweather.com。LocationID是否正确。检查在和风天气控制台查看你的API调用次数是否已超限免费版每日1000次。JSON解析失败或数据为乱码检查Gzip解压是否成功。确保uzlib库的文件已正确放置在lib目录下并且decompress函数被正确实现和调用。可以在解压前后打印数据长度进行对比。检查StaticJsonDocument的容量是否足够。如果返回的JSON数据很大可以尝试增大这个值例如改为StaticJsonDocument4096。程序运行一次后停止这是正常的因为我们当前的setup()函数在执行完所有任务后就结束了loop()里只有一个很长的延迟。如果你想让它周期性地工作就需要在loop()里实现重新连接Wi-Fi、更新数据、然后再次延迟的逻辑。但要注意处理网络重连的稳定性。当你看到串口成功打印出天气数据时这个项目最核心、最困难的部分就已经完成了。你已经成功搭建了一个物联网终端的数据链路。接下来就是如何把这些数据“秀”出来。6. 功能扩展从串口打印到图形化显示让数据在串口监视器里显示只是第一步让我们把它变得“好看”起来这才是智能硬件项目的点睛之笔。6.1 连接OLED显示屏我强烈推荐使用一块I2C接口的OLED屏幕通常是0.96或1.3英寸因为它接线简单只需要4根线VCC, GND, SCL, SDA而且有成熟的库支持。将屏幕的VCC和GND连接到ESP32-S3的3.3V和GNDSCL和SDA连接到ESP32-S3的I2C引脚例如GPIO 21作为SDAGPIO 22作为SCL但请以你的开发板原理图为准。在PlatformIO中搜索并安装Adafruit SSD1306和Adafruit GFX库这两个库是驱动OLED显示图形和文字的标准库。6.2 编写显示代码在你的项目中新建一个display.cpp和display.h文件或者直接在main.cpp中添加显示逻辑。核心思路是初始化OLED屏幕。在成功获取天气数据后将温度、天气代码等信息转化为屏幕上的文字和图形。根据iconDay或iconNight的代码在屏幕上绘制对应的图标可以预先定义一些简单的位图比如太阳、云、雨滴的图形。一个简化的显示函数示例#include Adafruit_SSD1306.h #include Adafruit_GFX.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, OLED_RESET); void setupDisplay() { if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // I2C地址通常是0x3C Serial.println(F(SSD1306分配失败)); for(;;); // 死循环阻止继续执行 } display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); display.setCursor(0,0); display.println(Weather Station); display.display(); delay(2000); } void showWeatherOnDisplay(int tempHigh, int tempLow, int weatherCode) { display.clearDisplay(); display.setCursor(0, 0); display.setTextSize(2); display.print(tempHigh); display.print(|); display.print(tempLow); display.println(C); display.setTextSize(1); display.setCursor(0, 20); // 根据weatherCode显示不同的文字描述 switch(weatherCode) { case 100: display.println(Sunny); break; case 101: case 102: display.println(Cloudy); break; case 103: display.println(Partly Cloudy); break; // ... 补充其他天气代码 default: display.println(N/A); break; } // 这里可以添加绘制简单图标的代码 display.display(); }然后在主程序的setup()中在获取天气数据成功后调用showWeatherOnDisplay()函数即可。这样一来你的天气站就有了一个直观的显示界面无需再打开电脑看串口。6.3 进阶优化思路当基础功能实现后你可以考虑很多优化方向让项目更实用、更稳定低功耗设计如果你的设备是电池供电可以在每次更新数据后让ESP32进入深度睡眠Deep Sleep定时唤醒。这可以极大地延长续航时间。数据缓存在网络异常或API暂时不可用时可以显示上一次成功获取的数据提升用户体验。多城市切换通过一个按钮或Web配置界面动态切换要显示的城市LocationID。更多数据显示除了温度还可以显示湿度、风速、空气质量指数AQI需要订阅相应API、日出日落时间等。外壳与美化为你的开发板和屏幕设计一个3D打印外壳把它变成一个真正的桌面摆件。从串口打印到图形化显示这一步的跨越会让你的项目成就感倍增。它从一个技术Demo变成了一个真正可用的产品原型。我自己的第一个版本就放在办公桌上每次抬头看到实时变化的温度和天气图标都觉得当初花时间折腾这些非常值得。