Skip to content

2. Getting started: setup, clone, initial build

Abdul Nabi edited this page Mar 16, 2021 · 1 revision

Development tools:

VisualStudio Code with PlatformIO

Note: Though I primarily use a Apple MacBook Air with Apple Silicon for development, however VisualStudio Code should run fine across platforms

You can use any ESP32 development environment, however the project is set up for and tested with Visual Studio Code with the PlatformIO IDE plugin so is recommended (plus is the most popular and hassle-free tool so if something does go sideways there's a larger community where one can find solutions).

For info and downloading Visual Studio Code see: Visual Studio Code Link

For info and downloading the PlatformIO IDE plugin for Visual Studio Code see: PlatformIO IDE

Xcode

In the repo a Xcode project (with build settings and flags configured) is provided to allow building a target for macOS... this is handy for debugging the core of the virtual machine as all the debugging tools of Xcode are available.

Windows/Linux Targets

TBD Explain the Xcode flags and they need to be set, and make file`

Test development tools installation

Once the development tools are installed and set up (for PlatformIO IDE a good test is to create a ESP32 blink example project from the PIO Home Screen and run on the ESP32 device to ensure a correct installation... the PlatformIO site has more information on this in their ESP32 page

Cloning and building

Next clone or download the Smalltalkje repository... you should be able to open the PlatformIO project (or Xcode project) and build, configure target (see CONFIGURE TARGET) and run (SEE BUILD/DOWNLOAD/RUN)