如何高效地阅读本书

随着信息技术的快速发展，相关的学习资料呈现爆炸式的增长。如何快速、高效地学习新的知识、掌握新的技术，是每个工程师都面临的问题。在本书的编写和出版过程中，为了帮助读者更高效地阅读本书，我们做了如下设计。

本书源码的获取方法

本书的相关源码已经开源，读者可以通过以下两个途径获取本书的源码，还可以前往https://www.esp32.com/bookc3书籍讨论版块，反馈您在阅读本书过程中的想法和问题。

排版约定

为了帮助读者更好地理解本书内容，全书将使用如下排版规则：

关于文本框

项目源码：

项目源码：本书注重理论和实践相结合，因此几乎每章最后一节都配有智能照明程实战项目，对应的工程步骤和源码地址将记录在类似的文本框中。

扩展阅读：

扩展阅读：书中类似文本框中的内容属于扩展阅读内容，供读者进行知识扩展，以便读者更加深入地理解相关的技术。

小贴士：

小贴士：实用小贴士，书中类似文本框中的内容往往是代码成功运行的非常关键的信息和提醒。

关于本书中的命令

本书中的大多数命令是在Linux系统下执行的，字符“$”是提示符。如果命令需要超级用户的权限来执行命令，则提示符用“#”来替代。Mac系统下命令提示符为“%”，如4.2.3节（在Mac系统下安装ESP-IDF开发环境）。

关于本书的字体

为了符合大多数读者的阅读习惯，本书正文的中文采用宋体，英文和数字等采用Times New Roman。

等宽字体：不仅用于文件内容、命令输出，还用于正文中出现的代码示例、组件、函数、变量、代码文件名、代码目录或字符串等。其中，代码和文件内容增加了行号。书中采用的是Courier New等宽字体。

等宽粗体：在示例中用于表示需要用户输入的命令或文字，按下回车键可输入的命令。书中采用的是Courier New等宽粗体。

英文字体：表示协议名称、专名词、缩写词的英文单词采用Times New Roman英文字体。

示例1：

通过云平台完成固件更新是更为普遍的方案，本节将借助ESP RainMaker从云端向设备推送OTA升级信息。ESP RainMaker同样使用的是esp_https_ota组件，ESP RainMaker SDK中整合了OTA升级部分的代码，通过调用esp_rmaker_ota_enable()函数即可启用OTA升级。需要注意的是，ESP RainMaker提供了两种OTA升级方式，此处需要选择通过主题形式接收OTA升级消息。订阅与OTA升级相关的主题后，可以通过这些主题接收MQTT消息并解析出固件的URL，同时通过这些主题推送当前更新的进度及最终状态。ESP RainMaker OTA升级功能的代码位于esp-rainmaker/components/esp_rainmaker/src/ota目录下，该目录下与固件下载相关的代码位于源文件esp_rmaker_ota.c中。

示例2：

下面的命令可生成CA证书所需的CSR，读者按照提示输入即可，Organization Name可随意输入（这是因为只是在本地使用CSR）。