PlatformIO: 跨平台嵌入式开发利器

需积分: 22 93 浏览量更新于2024-07-15 收藏 22.07MB PDF 举报

"PlatformIO是一个专业且跨平台的嵌入式开发工具，旨在简化和统一为各种嵌入式系统和物联网(IoT)项目的工作流程。它为软件开发人员提供了全面的支持，无论他们是业余爱好者还是专业人士，都能轻松处理从简单的Arduino草图到复杂的低级C程序的开发。PlatformIO的核心功能包括一个强大的构建系统，能够自动处理软件依赖关系，消除了手动配置环境的繁琐过程。此外，它与Microsoft VSCode编辑器无缝集成，拥有高评价的IDE扩展，并且已被全球超过750,000个独特开发者安装使用。 PlatformIO Core是一个独立的命令行界面(CLI)工具，允许开发人员在不同环境中使用，同时提供与多种云平台和Web服务的集成。它解决了在使用特定SDK或示例嵌入式应用程序之外的软件集成、打包和库依赖性问题。该项目采用Apache 2.0许可证，开源且无许可费用，保证了开发者的灵活性和自由度。 PlatformIO文档包含了从基本介绍到高级特性的详细内容，包括PlatformIO IDE的使用、PlatformIO Core CLI的命令、PlatformIO Home的界面、教程和示例、项目配置文件"platformio.ini"的设置、环境变量的管理、脚本的高级使用、库管理、开发平台和框架的选择、电路板的列表、自定义平台和板的支持、调试工具、单元测试、静态代码分析、远程开发、PlatformIO账户的管理、云和桌面IDE的使用、持续集成(CI)功能、编译数据库的生成、关于PlatformIO的文章、常见问题解答以及版本更新日志等。通过PlatformIO，开发者可以享受到一个整合的开发环境，无需担心供应商锁定，因为它提供开源解决方案，支持跨平台使用，并且具有高度的可扩展性和灵活性。无论是在项目初期还是在复杂项目的维护阶段，PlatformIO都为开发者提供了强大的支持和便利。"

PlatformIO Documentation, Release 5.1.0

• macOS Homebrew

Installer Script

Warning: PlatformIO DOES NOT require administrative/sudo permissions. Please install using default user

account WITHOUT EXTRA PERMISSIONS.

Super-Quick (Mac / Linux)

To install or upgrade PlatformIO Core paste that at a Terminal prompt:

python3 -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/

˓→master/scripts/get-platformio.py)"

# or using `curl`

curl -fsSL https://raw.githubusercontent.com/platformio/platformio-core-installer/

˓→master/get-platformio.py -o get-platformio.py

python3 get-platformio.py

# or using `wget`

wget https://raw.githubusercontent.com/platformio/platformio-core-installer/master/

˓→get-platformio.py -O get-platformio.py

python3 get-platformio.py

Local Download (Mac / Linux / Windows)

To install or upgrade PlatformIO Core, download (save as. . . ) get-platformio.py script. Then run the following:

# change directory to folder where is located downloaded "get-platformio.py"

cd /path/to/dir/where/is/located/get-platformio.py/script

# run it

python get-platformio.py

On Windows OS it may look like:

# change directory to folder where is located downloaded "get-platformio.py"

cd C:\path\to\dir\where\is\located\script\get-platformio.py

# run it

python.exe get-platformio.py

Note: If you need to have access to platformio or platformio.exe commands from other applications or

terminal in your OS, please Install Shell Commands.

12 Chapter 1. Contents

PlatformIO Documentation, Release 5.1.0

After that, you should be able to run PlatformIO from terminal. No restart is required.

Windows

Please read one of these instructions How do I set or change the PATH system variable?

You need to edit system environment variable called Path and append C:\Users\UserName\.

platformio\penv\Scripts; path in the beginning of a list (please replace UserName with your account

name).

Uninstall PlatformIO Core and dependent packages

• Uninstall PlatformIO Core tool

# uninstall standalone PlatformIO Core installed via `pip`

pip uninstall platformio

# uninstall Homebrew's PlatformIO Core (only macOS users if you installed

˓→it via Homebrew before)

brew uninstall platformio

• Dependent packages, global libraries are installed to core_dir folder (in user’s HOME directory). Just remove

it.

Integration with custom applications (extensions, plugins)

We recommend using PlatformIO Core Installer Script when you integrate PlatformIO Core into an application, such

as extension or plugin for IDE. Examples that use this installer are:

• platformio-node-helpers, is used by PlatformIO IDE for VSCode and PlatformIO IDE for Atom

Prerequisite

Python Interpreter

PlatformIO Core Installer Script is written in Python and is compatible with Python 2.7+ and Python 3.5+. We highly

recommend using the latest Python 3.

Python is installed by default on the most popular Unix OS (macOS, Linux, FreeBSD). If there is no Python on a user

machine (you can check running python --version), we have 2 options:

1. Ask the user to install Python 3 using our guide Install Python Interpreter

2. You can automatically Download Portable Python 3 and unpack it in a cache folder of your application. Later,

you can use unpacked_protable_python_dir/python.exe for the installer script.

Installer Script

There are 2 options on how to work with PlatformIO Core Installer Script:

1. Bundle get-platformio.py ﬁle into your application

2. Download get-platformio.py ﬁle on demand.

1.3. PlatformIO Core (CLI) 15

PlatformIO Documentation, Release 5.1.0

In both cases, you will need to have get-platformio.py script on the end-user machine. You can copy or

download it to a cache/temporary folder.

A list of arguments and options for the installer script is available via

python get-platformio.py --help

Workﬂow

We will describe a simple workﬂow on how to automatically install PlatformIO Core (CLI) for end-user of your

application/extension. We assume that get-platformio.py script is already copied/downloaded and exists on

the end-user machine. See above how to get it.

Step 1. Where is PlatformIO Core installed?

You should check the PlatformIO Core installation state each time when the user starts your application. You need to

call the Installer Script with check core arguments:

python get-platformio.py check core

This command returns 0 “exit code” when PlatformIO Core is already installed and is ready for use, otherwise, the

non-zero code of subprocess will be returned and you need to install PlatformIO Core (see Step #2 below).

If you need to have full information about PlatformIO Core installation state, please run with --dump-state option

and specify a folder or a full path where to save data in JSON format:

get-platformio.py check core --dump-state tmpdir/pioinstaller-state.json

Now, read JSON ﬁle and use platformio_exe binary to call PlatforIO Core using CLI (see CLI Guide). You can

also export penv_bin_dir into system environment PATH variable and platformio command will be available

without a full path.

Example of pioinstaller-state.json run on macOS:

{

"cache_dir": "/Users/Freedom/.platformio/.cache",

"core_dir": "/Users/Freedom/.platformio",

"core_version": "4.3.1",

"installer_version": "0.2.0",

"is_develop_core": false,

"penv_bin_dir": "/Users/Freedom/.platformio/penv/bin",

"penv_dir": "/Users/Freedom/.platformio/penv",

"platformio_exe": "/Users/Freedom/.platformio/penv/bin/platformio",

"python_exe": "/Users/Freedom/.platformio/penv/bin/python",

"system": "darwin_x86_64"

}

Step 2. Install PlatformIO Core

To install PlatformIO Core into the virtual environment in an automatic mode, please call installer script without any

arguments:

python get-platformio.py

16 Chapter 1. Contents

剩余2784页未读，继续阅读

方忄艮少

粉丝: 0
资源: 1

PlatformIO: 跨平台嵌入式开发利器

platformio.pdf

内容管理平台详细设计说明书V1.0.doc

libvirt-docs-5.1.0-9.xen48.el7.x86_64.rpm

spire.pdf-FE-5.1.0.ZIP

spire.pdf.free-5.1.0.jar

com.springsource.org.apache.bcel-5.1.0.jar

jbpm-human-task-5.1.0.Final-sources.jar

jbpm-persistence-jpa-5.1.0.Final-sources.jar

org.kevoree.api-5.1.0.jar

jboss-5.1.0.GA-src.tar.gz

最新资源