Espruino：面向微控制器的JavaScript

_|__|__-|。_|。|__|__||_。

Espruino是一个用于微控制器的JavaScript解释器。它专为只有128KB闪存和8KB RAM的设备设计。

浏览Espruino网站(尝试使用右上角的搜索)，并阅读常见问题解答。

还有JavaScript命令和教程的参考资料。但是，Espruino网站上的文档将匹配可供下载的版本，而不是GitHub上的最新版本。

此处提供Espruino Board和Pico Board的构建(针对每个Git提交自动构建)。

首先，请尝试检查我们的论坛是否尚未发现或涉及您的问题。

提交错误，并提供清晰的复制步骤：一个小的测试用例(不是整个程序)，以及实际和预期的结果。如果你想不出这些，请先在论坛上发帖，因为这可能只是你的代码中的一些东西，我们可以帮助你。

如果您的电路板不是我们制造的，而是预装了Espruino，那么您应该联系制造商。

我们尝试并支持我们销售的主板的用户，但如果您购买了非官方主板，您的问题可能得不到解决。在这种情况下，请考虑捐款以帮助支付解决问题所需的时间(即使如此，我们也不能保证解决所有问题)。

测试目录中有一堆测试。有关如何运行它们的示例，请参阅tests/readme.md。

官方支持的主板是最受支持的。它们预装了Espruino，您可以轻松下载最新版本的Espruino并将其刷新给它们。

虽然Espruino可以在其他主板上运行，但我们不能从它们身上赚钱，因此负担不起测试、修复或支持它们上的固件。我们依赖于社区。

如果您是电路板制造商，有兴趣获得您的电路板的正式支持，请查看此页面。

Espruino已经移植到其他板和平台上(例如EFM32和SAMD)，但是它们有一个习惯，就是先被贡献，然后再也不维护。发生这种情况的所有板都驻留在unmainained_boards分支中。

首先查看有关构建过程的文档-这应该会澄清很多关于Espruino架构的潜在问题。

如果您正在使用现有的架构，一切都可以从boards/BOARDNAME.py完成。请看一个类似的电路板.py文件作为示例。

Board/*.py文件描述CPU、可用引脚和连接-因此可以创建相关的链接器脚本、标头和文档。

电路板/管脚/*.csv是芯片数据手册中管脚定义表的副本。STM32芯片的它们是由Boards/*.py文件读入的，但它们不是必需的-有关示例，请参阅板/MICROBIT.py。

Src/jshardware.h实际上是SPI/I2C/ETC的简单抽象层，应该在target/arch/jshardware.c中实现。

如果您正在使用esprino进行您自己的个人项目-请继续，我们希望您玩得开心-并请让我们知道您在http://www.espruino.com/Forum！上使用它做了什么。

阅读Espruino分发所依据的MPLv2许可证的条款，并确保您遵守该条款。

MPLv2规定，您修改的任何文件都必须以源代码形式提供。您创建的新文件不需要提供(尽管我们建议这样做！)。

除非征得我们的同意(商标归我们所有)，否则您不能称您的董事会为西班牙董事会。

请不要分叉西班牙人-改进变得很难分享，从长远来看，每个人都是输家。

请回馈给项目一些东西-无论是代码改进、文档还是支持。

我们花了很多时间在论坛上支持Espruino，但我们只能这么做，因为我们从Espruino电路板的销售中赚钱。如果您的用户请求我们的支持，那么我们绝对没有义务帮助他们。然而，如果您积极帮助所有用户(不仅仅是您自己)改进Espruino，我们会更有动力。