Skip to content
A simple and fast web IDE to create C++ applications for ESP32 microcontrollers based on arduino-code syntax
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build
config
libs
src
static
test/unit
.babelrc
.editorconfig
.gitignore
README.md
arduino-flash.png
arduino-setup.png
demo.png
index.html
logo.png
package.json
webpack.config.js

README.md

Cody++

Cody++ is a simple and fast web IDE to create C++ applications for ESP32 microcontrollers based on arduino-code syntax.

Demo

Checkout the demo. If you want to take a look at some of the examples mentioned in the menu on the left hand side, feel free to do so.

Quick start

So far, no installation instructions are needed. Feel free to use the hosted demo. To use our generated code you have to install several libraries in arduino. You can install them after you open the Arduino IDE and search for them under Tools -> Manage Libraries.

The following libraries should be installed:

  • Adafruit SSD1306 (works only with version 1.1.2, not 1.2.x)
  • Adafruit-GFX-Library (latest version, tested with 1.3.4)
  • SparkFun SX1509 (latest version, tested with 2.0.1)

We also have to make sure that the ESP core is installed correctly. If you have a linux based oprating system, it is quite simple. Open an terminal enter the following commands:

:~$ sudo usermod -a -G dialout $USER && \
    sudo apt-get install git && \
    wget https://bootstrap.pypa.io/get-pip.py && \
    sudo python get-pip.py && \
    sudo pip install pyserial && \
    mkdir -p ~/Arduino/hardware/espressif && \
    cd ~/Arduino/hardware/espressif && \
    git clone https://github.com/espressif/arduino-esp32.git esp32 && \
    cd esp32 && \
    git submodule update --init --recursive && \
    cd tools && \
    python2 get.py

The ESP core is using python the flash the microcontroller, so you have to check your python version. Python is preinstalled in most linux distributions.

:~$ python --version
Python 2.7.15rc1

If you are under windows, you have to install python first. Therefore you have to download it from the offical webpage and run the installer. You can now go on with integrating the ESP32 core to arduino. TO do so, you have to open your Arduino IDE and navigate to File -> Preferences -> Additional Boards Manager URLs. Paste the link given in the picture below into the input field.

Confirm the window, wait until all neccessary files are installed and set up and proceed with the next steps.

Generate and use Cody++ to build a program for the ESP32

Generate the arduino code with the hosted Cody++ IDE. After that, open your Arduino IDE and create a new blank sketch and paste the generated code into it. Now you only have to copy the neccessary headers (ft_ESP32_IOobjects.h, ft_ESP32_IOobjects.cpp) - you find these files in the direcotry /lib, updated files can be found here - in the same directory where your arduino project is located. Compiling your first arduino project made with Cody++ should now be very easy. Its time to flash your ESP32. To do so, upload the compiled sketch to the ESP32 which should be connected with a usb cabel to your computer. The following settings are neccessary:

Only a few steps are left to program your ESP32. Beside our Cody++ software and the Arduino IDE, you will need the correct ESP32 hardware. There are two possible hardware platfroms mentioned on our offical documentation page. I would prefer the smaller one. To setup the ESP32 correctly please visit the ft32 github page.

Cody++ (with FT32 robots) in use

Video dokumentation (in german):

German pubils testing our Robots:

Environment Setup

If you want to take part or to modify and use the project on your own, you have to setup your operating system properly. I am currently using Linux Mint 19 and the following instructions are related to this operating system. Other Linux distributions are possible, but the commands may variant. It is also possible to setup and VM with virtual box.

  1. Download and install Linux Mint 19.
  2. Make sure the latest updates are installed:
    sudo apt-get update && sudo apt-get dist-upgrade --yes
  3. Download and install Atom (my favourite integrated development environment tool)
  4. Setup Atom IDE for syntax highlighting, language and github support: Launch Atom -> Edit -> Preferences -> Install:
    Install packages: atom-ide-ui, ide-vue, Language-vue
  5. Install npm package manager: ...
You can’t perform that action at this time.