Arduino:基于 Arduino 生态的 ESP8266 芯片支持项目

Star11
2
代码
代码
Issues
Pull Requests
讨论
Wiki
分析
Star11
2

ESP8266 core for Arduino

分支14Tags37
文件最后提交记录最后更新时间
.github
Bump actions/checkout from 5 to 6 (#9296) Bumps [actions/checkout](https://github.com/actions/checkout) from 5 to 6. - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/v5...v6) --- updated-dependencies: - dependency-name: actions/checkout dependency-version: '6' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
7 个月前
bootloaders
A new approach for erasing WiFi Settings (#8828) * A new approach for erasing WiFi Settings Add support for hardware reset function call - simulates EXT_RST via HWDT. Add reset selection to `ESP.eraseConfig()` for calling hardware reset after erasing the WiFi Settings. Update ArduinoOTA to use `ESP.eraseConfig(true)` Externalized `ArduinoOTA.eraseConfigAndReset()` Add OTA examples to illustrate using erase config changes. * style fixed confused example * improve wording * Add new state to retry eraseConfigAndReset * Removed unreachable error test from examples. Removed continuous retry of "eraseConfig" and allow the script to assign an error handling option for "eraseConfig" failure. Update example to use error handling option. * In eboot for function ets_wdt_enable() added missing arguments * Update comments and example * Wording * Rebuilt eboot.elf with current tools from ./get.py * Requested changes. * cleanup comments * Update hardware_reset Avoid using "[[noreturn]]" - not accepted for a .c file function Updated to use __attribute__((noreturn)) to handle both .cpp and .c file functions.
2 年前
cores
SpiUtils - explicit asm instead of volatile (#9256) * SpiUtils - explicit asm instead of volatile getting rid of volatile arg(s) is must-have for -std=c++20 and later provide helper macros to init & load vars at specific points in code modify existing macros to use c++-style casts & less volatile change locals to plain non-volatile variables, avoid extra memw also fixes unintentional const mask load in (pre_cmd) branch * words * 'a' constraint for output as noted in implementation, all but sp
11 个月前
doc
Boards - fix & update Mercury (#9238) * update Mercury Board * fix --------- Co-authored-by: Maxim Prokhorov <prokhorov.max@outlook.com>
1 年前
libraries
certs-from-mozilla.py - Update Mozilla CCADB URL (#9264) site that provides CCADB is now at URL "ccadb.my.salesforce-sites.com"
10 个月前
package
Boards - fix & update Mercury (#9238) * update Mercury Board * fix --------- Co-authored-by: Maxim Prokhorov <prokhorov.max@outlook.com>
1 年前
tests
Mock - clean up in UdpContext destructor (#9312) * Fix possible crash in UdpContext host mocking. I saw this crash in UdpContext.h happen after some hours of regular NTP requests.... ``` [17:38:51] ADE: voltage spike: phase A, factor=0.81, cycles=1 (mock) ClientContext::connect: ::connect(): Connection refused (mock) ClientContext::connect: ::connect(): Connection refused (mock) ClientContext::connect: ::connect(): Connection refused (mock) ClientContext::connect: ::connect(): Connection refused [17:41:14] ADE: voltage spike: phase A, factor=0.86, cycles=2 (mock) ClientContext::connect: ::connect(): Connection refused (mock) ClientContext::connect: ::connect(): Connection refused (mock) ClientContext::connect: ::connect(): Connection refused (mock) ClientContext::connect: ::connect(): Connection refused [17:43:49] ADE: voltage spike: phase B, factor=1.12, cycles=3 (mock) ClientContext::connect: ::connect(): Connection refused (mock) =====> UdpServer port: 2390 <===== [17:44:31] NTP: waiting for response from '81.169.233.252' timed out Program received signal SIGSEGV, Segmentation fault. 0x000055555556848c in std::_Function_base::_M_empty() const () (gdb) where #0 0x000055555556848c in std::_Function_base::_M_empty() const () #1 0x00005555555685be in std::function<void ()>::operator bool() const () #2 0x00005555555684b8 in UdpContext::mock_cb() () #3 0x00005555555683af in check_incoming_udp() () #4 0x0000555555567fa6 in main () ``` I tracked it down to UdpContext::mock_cb() which is calling a std::function callback that's been destroyed thus used-after-free. I believe what happens is: 1. UdpContext::unref() calls delete this when refcount hits 0 (line 56) 2. The destructor (~UdpContext(), line 47) is empty — it never calls register_udp(_sock, nullptr) to remove itself from the global udps map 3. check_incoming_udp() iterates udps, finds the dangling pointer, calls mock_cb() on freed memory 4. _on_rx (a destroyed std::function) → segfault in _M_empty() The disconnect() method already does the right thing (lines 78-84: closes socket + unregisters), but it's never called before the object is destroyed via unref(). The fix is to make the destructor clean up properly. I tested intensely, no crashes since. * Format destructor for UdpContext for clarity Fixes code-style CI.
3 个月前
tools
Tools - upload.py exception handling fixes (#9186) - don't check exc_info() in `finally`, it only works without `except` with just `try` and `finally` see https://docs.python.org/3/reference/compound_stmts.html#try after `except Exception as e:` block, `e` is already deleted - handle a rare case when esptool code does not close 'erase_file'. printing paths may cause encoding issues, so just fall through silently - simplify ordering of write_flash & erase_region arguments since we always end up in write_flash, prefer to think of it as argument pairs 'addr' + 'path'. actual binaries go first, erase temporaries go last. construct write args beforehand and apply when finishing with the command line. both commands can appear multiple times, for manual or scripting cases, where multiple regions should be erased / written to
1 年前
variants
Boards - fix & update Mercury (#9238) * update Mercury Board * fix --------- Co-authored-by: Maxim Prokhorov <prokhorov.max@outlook.com>
1 年前
.git-blame-ignore-revs
Fix commit hash for the clang-format changes (#8525) GitHub PR rebase-merge of #8464 introduced a new commit, instead of using the one from the PR tree. Point to that new one in the `master` branch. (fixing 24c41524dc56c683d8926671bdd639d7411f2815 changes)
4 年前
.gitignore
Tools - ignore more cache / temporary files in git (#9255) - boards.txt.py & mkbuildoptglobals.py temporaries / backups - clangd cache & .json - all .local.txt
1 年前
.gitmodules
eboot: .RODATA, upstream uzlib, move CRC, save 112 bytes (#7844) RODATA can be copied automatically by the bootrom, so no reason not to allow its use for strings and constants in eboot.c Revert to pfalcon's original uzlib since the single patch to remove RODATA is not required. Rationalize eboot.ld linker script, clean up BSS and init it in code. Saves 112 bytes of space in the bootloader sector by removing the extra code associated with literal loads. * Move CRC out of bootload sector We added protection to only erase the bootload sector when flashing an image when the new sector != the old sector. This was intended to minimize the chance of bricking (i.e. if there was a powerfail during flashing of the boot sector the chip would be dead). Unfortunately, by placing the CRC inside the eboot sector *every* application will have a unique eboot sector (due to the crc/len), so this protection doesn't work. Move the CRC into the first 8 bytes of IROM itself. This frees up extra space in the boot sector and ensures that eboot won't be reflashed unless there really is an eboot change.
5 年前
.readthedocs.yaml
Docs - readthedocs.io latest (#9236)
1 年前
ISSUE_TEMPLATE.md
Update ISSUE_TEMPLATE.md (#4474) * Update ISSUE_TEMPLATE.md Proposal for issue template update * Update ISSUE_TEMPLATE.md Updates per feedback. * Update ISSUE_TEMPLATE.md Update based on feedback.
8 年前
LICENSE
add missing LICENSE file (GNU Library Public License, version 2)
10 年前
POLICY.md
Update POLICY.md Included review feedback from igrr included feedback in PR (typos)
8 年前
README.md
Document git version install, upkeep and PR management (#8902)
2 年前
boards.txt
Boards - fix & update Mercury (#9238) * update Mercury Board * fix --------- Co-authored-by: Maxim Prokhorov <prokhorov.max@outlook.com>
1 年前
keywords.txt
Remove obsolete PWMRANGE in keywords.txt (#8447) PWMRANGE was defined up until v2.7.4: ``` $ cd ~/Library/Arduino15/packages/esp8266/hardware/esp8266 $ grep -R "PWMRANGE" 2.7.4 2.7.4/keywords.txt:PWMRANGE LITERAL1 2.7.4/tests/host/common/Arduino.h:#define PWMRANGE 1023 2.7.4/cores/esp8266/core_esp8266_wiring_pwm.cpp:static int32_t analogScale = PWMRANGE; 2.7.4/cores/esp8266/Arduino.h:#define PWMRANGE 1023 ``` The define was removed in favour of the Arduino standard value of 255 but the keyword coloring was left behind: ``` $ cd ~/Library/Arduino15/packages/esp8266/hardware/esp8266 $ grep -R "PWMRANGE" 3.0.2 3.0.2/keywords.txt:PWMRANGE LITERAL1 ``` In the Arduino IDE, the coloring makes it look like PWMRANGE still exists, when it doesn't, which is confusing. Signed-off-by: Phill Kelley <pmk.57t49@lgosys.com>
4 年前
package.json
3.1.2 is released (#8894)
3 年前
platform.txt
Tools - makecorever.py explicit output argument (#9248) * Tools - makecorever.py explicit output argument Don't hide where the file is actually placed Using pathlib instead of raw strings to simplify path ops Plus, add stdout preview when output is missing Clean-up git-describe <-> version availility checks * typo * fix unhandled exc in git cmd * unused escape * RELEASE using same values
1 年前
programmers.txt
remove the need to set programmer, by setting upload tool
11 年前

ESP8266 Wi-Fi芯片的Arduino核心

===============================

快速链接

ESP8266上的Arduino

这个项目为Arduino开发环境带来了对ESP8266芯片的支持。它允许您使用熟悉的Arduino函数和库编写草图，并直接在ESP8266上运行它们，无需外部微控制器。

ESP8266 Arduino核心随附用于通过TCP和UDP进行Wi-Fi通信的库，设置HTTP，mDNS，SSDP和DNS服务器，执行OTA更新，使用闪存中的文件系统，以及与SD卡，伺服电机，SPI和I2C外设一起工作。

内容

使用板管理器安装

自1.6.4版起，Arduino支持使用板管理器安装第三方平台包。我们提供了适用于Windows，Mac OS和Linux（32位和64位）的包。

  • 下载并安装Arduino IDE 1.x 或 2.x
  • 启动Arduino并打开偏好设置窗口
  • 在Arduino IDE的“文件”>“首选项”>“附加板管理器URL”字段中输入https://arduino.esp8266.com/stable/package_esp8266com_index.json。您可以添加多个URL，用逗号分隔。
  • 从“工具”>“板”菜单中打开板管理器并安装esp8266平台（安装后别忘了从“工具”>“板”菜单中选择您的ESP8266板）。

最新发布 板管理器链接：https://arduino.esp8266.com/stable/package_esp8266com_index.json

文档：https://arduino-esp8266.readthedocs.io/en/3.1.2/

使用git版本安装

也称为最新git或master分支。

使用PlatformIO

PlatformIO是一个开源的物联网开发生态系统，具有跨平台构建系统、库管理器以及对Espressif（ESP8266）开发的全面支持。它可在以下流行的主机操作系统上运行：macOS，Windows，Linux 32/64以及Linux ARM（如Raspberry Pi，BeagleBone，CubieBoard）。

使用make构建

makeEspArduino是任意ESP8266 Arduino项目的通用Makefile。使用Make代替Arduino IDE可以更轻松地进行自动化和生产构建。

文档

最新开发版本的文档：https://arduino-esp8266.readthedocs.io/en/latest/

问题和支持

ESP8266社区论坛是关于ESP8266 Arduino问题和答案的成熟社区。Stackoverflow也是一个替代选择。如果您需要帮助，有“如何做...”类型的问题，遇到与本仓库未托管的第三方库相关的问题，或者只是想讨论如何解决问题，请在那里提问。

如果您觉得该论坛很有帮助，请考虑通过捐款来支持它。

如果您遇到了您认为是ESP8266 Arduino核心或其关联库中错误的问题，或者您想要提出改进的建议，欢迎您在这里向GitHub提交问题：https://github.com/esp8266/Arduino/issues。

请尽可能提供上下文信息，以及问题模板中请求的信息：

  • 您正在使用的ESP8266 Arduino核心版本（您可以在板管理器中查看）
  • 您的草图代码；请将其放在代码块内，参阅GitHub Markdown手册
  • 如果在运行时遇到问题，请附带串行输出。将其放在一个代码块中，就像代码一样。
  • 对于编译时出现的问题，启用IDE的详细编译器输出，并附上该输出（也在代码块内）
  • ESP8266开发板型号
  • IDE设置（板的选择，闪存大小）
  • 等等

贡献指南

对于代码和文档的小幅修正，请直接提交拉取请求。你可以在这里找到关于这一过程的简单介绍：《开源贡献者的 Git 指南与速查表》。

查看待解决的简单问题列表——待处理的简易问题。解决这些问题有助于推动项目进展。

较大的改动（比如重写现有代码、向核心添加新功能、增加新库）通常需要先开启一个议题进行讨论。这类改动的 PR 需要经过测试和批准。

包含大量小提交（如“哎呀”、“修复错别字”、“忘了添加文件”等）的功能分支，在提拉取请求之前应先合并。同时，请避免在一个 PR 中放入多个不相关的变化。

许可证与致谢

Arduino IDE 由 Arduino 团队开发和维护，遵循GPL许可证。

ESP8266核心包含了xtensa gcc工具链，同样受到GPL保护。

Esptool.py最初由Fredrik Ahlberg（@themadinventor，@kongo）创建，现在由Angus Gratton(@projectgus)根据GPLv2.0许可证维护。

本构建中包含的Espressif的NONOS SDK采用Espressif MIT许可证。

ESP8266核心文件遵循LGPL许可证。

Peter Andersson编写的SPI闪存文件系统(SPIFFS)被用于该项目，它使用了MIT许可证。

Ralph Hempel编写的umm_malloc内存管理库在此项目中使用，遵循MIT许可证。

Peter Lerup编写的SoftwareSerial库及示例依据LGPL 2.1分发。

Thomas Pornin编写的BearSSL库，基于https://github.com/earlephilhower/bearssl-esp8266构建，项目使用MIT许可证分发。

ARM Limited编写的LittleFS，以BSD 3-clause许可证发布。

pfalcon编写的uzlib库，(c)2014-2018年Paul Sokolovsky，采用ZLib许可协议（https://www.zlib.net/zlib_license.html）。uzlib基于以下组件：Joergen Ibsen的tinf库（解压缩）、Simon Tatham的静态哈夫曼树程序、Paul Sokolovsky的LZ77压缩器；整个库由Paul Sokolovsky集成和维护。

其他有用链接

项目介绍

ESP8266 core for Arduino

LGPL-2.1 C++4.47 K提交数
定制我的领域
README
93616.63 K13.14 K访问 GitHub