How to build for ESP32

Requirements:

The following tools are required, use apt-get to install them.

• GNU autoconf, libtool, libtool-bin
• GNU flex, bison, gawk,
• libexpat1-dev

Windows:

We utilize VirtualBox (VB) with Ubuntu installed as build environment. If your OS is Linux, you can also setup the build environment according the following steps:

• 1. Download and install VirtualBox-5.0.16-105871-Win (You'd better install the latest version, since I found that the older version such as 4.x cannot install the VB Guest Additions)
• Download ubuntu-15.10-desktop-amd64.iso and install it on VB. Make sure that asign more than 1G RAM and 12G Hard Disk for this virtual machine. The tool chain build process require much memory!
• 2. Setup share file folder: Settings->Share Folders->Add new shared folder, input your share folder path and the select Make Permanent, Note that do not select Auto Mount. Launch Ubuntu and then create a folder to mount the share folder, I create a folder, named share, in the path /mnt. Type the commond in the terminal to mount share folder:

sudo mount -t vboxsf share /mnt/share 

Note: if you mount failed, check whether the module vboxsf is exist by executing commond c lsmod | grep vboxsf. If nothing found, maybe the Guest Additions are not installed correctly. Try to install that again or upgrade your VirtualBox to the latest version.

• 3. Download toolchain: Before downloading, make sure that the git has been installed, if not, install it by sudo apt-get install git. I create path /opt/Espressif and then install to sdk to it, then make the current user the owner:

sudo chown $USER /opt/Espressif/; Execute the following commond to download toolchain:
cd /opt/Espressif/
git clone -b esp108-1.21.0 git://github.com/jcmvbkbc/crosstool-NG.git

• 4. Install toolchain: Before installing, make sure that all the required tools list in Requirements are installed on your virtual machine. Type the following commands to build the toolchain.

cd crosstool-NG
./bootstrap && ./configure --prefix=`pwd` && make && make install
./ct-ng xtensa-esp108-elf
./ct-ng build

• 5. After installing the toolchain, export the bin path by the following commond, then you can build your source on your machine! Note: if your machine is not enough memory, the error such as Build failed in step: 'installing pass-2 core C compiler' may occur. The following screenshot shows the error:

• 6. After installing the toolchain, export the bin path by the following commond, then you can build your source on your machine!

export PATH=/opt/Espressif/crosstool-NG/builds/xtensa-esp108-elf/bin:$PATH

Now that you can place your source in the share folder, build it with your virtual machine.

Build App:

• Create a directory, say LuaNode, and then clone the LuaNode project to it: git clone --recursive https://github.com/Nicholas3388/LuaNode.git
• Create a Bin folder for LuaNode, say LuaNode_Bin, you should place LuaNode_Bin and LuaNode_Esp32 at the same directory.
• Modify the gen_misc.sh, setup the following three variables: SDK_PATH, BIN_PATH, and APP_NAME. SDK_PATH is the path of LuaNode_Esp32; BIN_PATH is the path of LuaNode_Bin; APP is the path of the application that you want to build. The apps you can build is in the apps folder.
• Start to build by input ./gen_misc.sh in your shell.

Linux:

• System requiement: RAM>1G; Hard Disk>10G
• Setup the build environment as that on Windows:)

Mac OS:

• Download and install VirtualBox for Mac
• Assign memory > 1G and hard disk > 12G for the virtual machine
• Setup the build environment as that on Windows:)

HOW TO BUILD (For ESP8266):