Quick Start Guide - ESP32 RPC System

Projectstructuur

Zie <project_dir>/FILE_REFERENCE.md voor de volledige bestandsstructuur.

Installation (3 Schritte)

1. ESP32 Firmware Uploaden

cd eps32_host
pio run -e esp32doit-devkit-v1 -t upload
pio run -e esp32doit-devkit-v1 -t monitor  # Controleer output

2. Python Dependencies

cd python_client
pip install -r requirements.txt

3. Verbinding Configureren

USB/WiFi mode kiezen tijdens boot

Je kunt de communicatie-mode ook kiezen tijdens het opstarten van de ESP32-NodeMCU:

Houd knop 0 ingedrukt tijdens boot om de mode te selecteren.
Laat los na boot om de geselecteerde mode te gebruiken.

WiFi configure mode tijdens boot

Als de ESP32 in WiFi mode staat:

Houd knop 1 ingedrukt tijdens boot om WiFi configure mode te openen.

Snel Testen

GUI Test (Aanbevolen)

cd python_client/nodeMCU_gui
python nodeMCU_gui.py

Klik “Connect”
Test GPIO, System, PWM functies
Zie responses in output

Via Python Script

cd python_client/examples
python example_usage.py

Advanced Monitoring

cd python_client/examples
python advanced_example.py

Basis Voorbeelden

Eenvoudige GPIO

from rpc_client import RPCClient
from config import COMM_USB, RPC_OK

client = RPCClient(comm_mode=COMM_USB)
client.connect()

# Pin 13 als OUTPUT
result, msg = client.pinMode(13, 1)

# HIGH schrijven
result, msg = client.digitalWrite(13, 1)

# Lezen
result, msg, value = client.digitalRead(13)

client.disconnect()

Analog Lezen

# ADC pin lezen
result, msg, value = client.analogRead(36)  # 0-4095
print(f"ADC: {value}")

Systeem Info

# Milliseconds
result, msg, ms = client.getMillis()

# Vrij geheugen
result, msg, mem = client.getFreeMem()

# Chip ID
result, msg, id = client.getChipID()

PWM/LED Dimmen

# Setup PWM: channel 0, 5kHz, 8-bit (0-255)
client.ledcSetup(0, 5000, 8)

# Helderheid instellen
for brightness in [0, 64, 128, 192, 255]:
    client.ledcWrite(0, brightness)

Optionele Libraries (ADC 3208, DIO, QC, OLED)

# ADC 3208
result, msg, raw = client.adcReadRaw(0, averageCount=4)
result, msg, voltage = client.adcReadVoltage(0, averageCount=4)
result, msg, pressed = client.isButtonPressed(0)

# DIO
result, msg, value = client.dioGetInput()
result, msg, bit_set = client.dioIsBitSet(0)
result, msg = client.dioSetOutput(0)
result, msg = client.dioSetBit(0)
result, msg = client.dioClearBit(0)
result, msg = client.dioToggleBit(0)

# QC7366 counter
result, msg = client.qcEnableCounter(0)
result, msg, count = client.qcReadCountRegister(0)
result, msg = client.qcClearCountRegister(0)
result, msg = client.qcDisableCounter(0)

# OLED
result, msg = client.oledClear()
result, msg = client.oledWriteLine(0, "Hello", 0)

Troubleshooting

Problem	Solution
USB verbinding faalt	Controleer poort: `ls /dev/tty*`
“No response” error	Zet `CONFIG['debug'] = True`
WiFi verbinding faalt	Controleer SSID in `config.h`
Permission denied	`sudo usermod -a -G dialout $USER`

Meer details

Protocol, result codes en uitbreiden: <project_dir>/TECHNICAL_REFERENCE.md

Veel plezier met je ESP32-NodeMCU RPC systeem! 🚀