|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Esp Open Sdk||1,885||2 years ago||140||Makefile|
|Free and open (as much as possible) integrated SDK for ESP8266/ESP8285 chips|
|Openwrt Frp||527||2 months ago||16||mit||Shell|
|Frpc & Frps for OpenWrt|
|Android Emulator||224||2 years ago||10||apache-2.0||Dockerfile|
|Yet another Docker container with Android SDK and Android emulator|
|Mentohust Openwrt Ipk||207||4 months ago||11||C|
|Openwrt Pcap_dnsproxy||200||5 years ago||5||Makefile|
|Pcap_DNSProxy for OpenWrt/LEDE|
|Gcc4mbed||174||a year ago||Makefile|
|Project to allow GCC compilation of code using mbed SDK libraries.|
|Scutclient||155||7 months ago||2||agpl-3.0||C|
|SCUT network client on Linux|
|Nrf51 Pure Gcc Setup||129||8 years ago||8||bsd-3-clause||Assembly|
|A simple and cross-platform GCC setup for nRF51-series development for Windows, OS X and Linux|
|Proxy Wasm Cpp Sdk||123||2 months ago||53||apache-2.0||C++|
|WebAssembly for Proxies (C++ SDK)|
|Vxworks7 Ros2 Build||82||19 days ago||10||apache-2.0||Makefile|
|Build system to automate the build of VxWorks 7 and ROS2|
This repository provides the integration scripts to build a complete standalone SDK (with toolchain) for software development with the Espressif ESP8266 and ESP8266EX chips.
The complete SDK consists of:
The source code above originates from work done directly by Tensilica Inc., Cadence Design Systems, Inc, and/or their contractors.
OpenSource components of the SDK are based on:
To build the standalone SDK and toolchain, you need a GNU/POSIX system (Linux, BSD, MacOSX, Windows with Cygwin) with the standard GNU development tools installed: bash, gcc, binutils, flex, bison, etc.
Please make sure that the machine you use to build the toolchain has at least 1G free RAM+swap (or more, which will speed up the build).
$ sudo apt-get install make unrar-free autoconf automake libtool gcc g++ gperf \ flex bison texinfo gawk ncurses-dev libexpat-dev python-dev python python-serial \ sed git unzip bash help2man wget bzip2
Later Debian/Ubuntu versions may require:
$ sudo apt-get install libtool-bin
$ brew tap homebrew/dupes $ brew install binutils coreutils automake wget gawk libtool help2man gperf gnu-sed --with-default-names grep $ export PATH="/usr/local/opt/gnu-sed/libexec/gnubin:$PATH"
In addition to the development tools MacOS needs a case-sensitive filesystem. You might need to create a virtual disk and build esp-open-sdk on it:
$ sudo hdiutil create ~/Documents/case-sensitive.dmg -volname "case-sensitive" -size 10g -fs "Case-sensitive HFS+" $ sudo hdiutil mount ~/Documents/case-sensitive.dmg $ cd /Volumes/case-sensitive
Be sure to clone recursively:
$ git clone --recursive https://github.com/pfalcon/esp-open-sdk.git
The project can be built in two modes:
Where the toolchain and tools are kept separate from the vendor IoT SDK which contains binary blobs. This makes licensing more clear, and helps facilitate upgrades to vendor SDK releases.
A completely standalone ESP8266 SDK with the vendor SDK files merged
into the toolchain. This mode makes it easier to build software (no
-L flags are needed), but redistributability of
this build is unclear and upgrades to newer vendor IoT SDK releases are
complicated. This mode is default for local builds. Note that if you
want to redistribute the binary toolchain built with this mode, you
To build the self-contained, standalone toolchain+SDK:
$ make STANDALONE=y
This is the default choice which most people are looking for, so just the following is enough:
To build the bare Xtensa toolchain and leave ESP8266 SDK separate:
$ make STANDALONE=n
This will download all necessary components and compile them.
Once you complete build process as described above, the toolchain (with
the Xtensa HAL library) will be available in the
xtensa-lx106-elf/bin/ subdirectory to your
environment variable to execute
xtensa-lx106-elf-gcc and other tools.
At the end of build process, the exact command to set PATH correctly
for your case will be output. You may want to save it, as you'll need
the PATH set correctly each time you compile for Xtensa/ESP.
ESP8266 SDK will be installed in
sdk/. If you chose the non-standalone
SDK, run the compiler with the corresponding include and lib dir flags:
$ xtensa-lx106-elf-gcc -I$(THISDIR)/sdk/include -L$(THISDIR)/sdk/lib
The extra -I and -L flags are not needed when using the standalone SDK.
examples/ contains some example application(s) which
can be built with esp-open-sdk. If you are interested in real-world,
full-fledged, advanced example of a project built using esp-open-sdk,
The project is updated from time to time, to get updates and prepare to build a new SDK, run:
$ make clean $ git pull $ git submodule sync $ git submodule update --init
If you don't issue
make clean (which causes toolchain and SDK to be
rebuilt from scratch on next
make), you risk getting broken/inconsistent
You can build a statically linked toolchain by uncommenting
CT_STATIC_TOOLCHAIN=y in the file
fine-tunable options may be available in that file and/or Makefile.
esp-open-sdk is in its nature merely a makefile, and is in public domain. However, the toolchain this makefile builds consists of many components, each having its own license. You should study and abide them all.
Quick summary: gcc is under GPL, which means that if you're distributing a toolchain binary you must be ready to provide complete toolchain sources on the first request.
Since version 1.1.0, vendor SDK comes under modified MIT license. Newlib, used as C library comes with variety of BSD-like licenses. libgcc, compiler support library, comes with a linking exception. All the above means that for applications compiled with this toolchain, there are no specific requirements regarding source availability of the application or toolchain. (In other words, you can use it to build closed-source applications). (There're however standard attribution requirements - see licences for details).