ESP8266 FreeRTOS Projects

A collection of ESP8266 embedded systems projects using FreeRTOS SDK with a Docker-based development environment.

🚀 Projects

• hello_world - Basic FreeRTOS application with chip info and task delays

📁 Structure

esp8266-freertos-projects/ ├── scripts/ # Shared build scripts ├── _project_template/ # Template for new projects ├── .sdk_headers/ # SDK headers (not in git) └── [projects]/ # Individual projects

🛠️ Setup

Prerequisites

• Docker
• Git
• Ubuntu/Linux (with serial port access)

Initial Setup

# Clone repository
git clone git@github.com:Jorgens01/esp8266-freertos-projects.git
cd esp8266-freertos-projects

# Clone and build Docker image
git clone https://github.com/brinth/ESP8266_RTOS_SDK_Docker.git
cd ESP8266_RTOS_SDK_Docker
docker build -t esp8266-rtos .
cd ..

# Extract SDK headers for IntelliSense
./scripts/extract_sdk.sh

# Set serial port permissions
sudo usermod -a -G dialout $USER
# Log out and log back in

📝 Usage

Create New Project

./scripts/new_project.sh my_project
cd my_project
../scripts/build.sh .

Build and Flash

# From project directory
cd hello_world
../scripts/build.sh .
../scripts/flash.sh .
../scripts/monitor.sh .

# From root directory
./scripts/build.sh hello_world
./scripts/flash_monitor.sh hello_world

VSCode

cd hello_world
code .
# Press Ctrl+Shift+B to build

⚙️ Configuration

Change Serial Device

export ESP8266_DEVICE=/dev/ttyUSB0

Project Settings

cd hello_world
../scripts/menuconfig.sh .

🐛 Troubleshooting

Permission denied on serial port

sudo usermod -a -G dialout $USER
# Log out and log back in

IntelliSense not working

./scripts/extract_sdk.sh
cd hello_world && ../scripts/build.sh .
# Reload VSCode

Find serial device

ls -l /dev/ttyUSB*
dmesg | grep tty

🔗 Resources

• ESP8266 RTOS SDK Docs
• FreeRTOS Documentation