MojoScale Studio Docs

Getting Started

Start here if you are new to Studio. This is the shortest path from a blank project to code running on an ESP32-S3 board.

Introduction Program boards from the browser

Write constrained Python syntax in Studio, let the checker catch unsupported APIs, then flash the prepared firmware and script.

Install / Flash No toolchain setup

Pick the project target, connect over Web Serial, and Studio flashes firmware, filesystem assets, and your script together.

ESP32 in 5 minutes Hello World

Use system first. It gives you timing, heap, scheduling, and small runtime helpers.

Networking Connect Wi-Fi

Use browser-only environment variables for secrets, then call wifi.connect() from the script.

Open Studio

Create a project and choose the supported ESP32-S3 target for the board.

Write a small script

Use documented modules like system, wifi, gpio, camera, and cv.

Lint and save

Studio checks supported imports, syntax, callbacks, env vars, and model usage before flashing.

Flash from the browser

Connect the board and let Studio send firmware, filesystem assets, your script, and optional model data.

import system

print("hello from mojoscale")
print(system.heap())
print(system.heap_largest())

Guides

Learn by task, then drop into the generated API page when you need exact signatures, parameters, and return values.

Read a sensor

Start with DHT temperature and humidity readings, then use GPIO and ADC for lower-level I/O.

Read dht Send an HTTP request

Send readings, pull configuration, or call webhooks from the board.

Read http MQTT

Connect to your broker, publish readings, subscribe to commands, and react to events.

Read mqtt Run a web server

Expose simple routes directly from firmware for setup screens, status endpoints, and diagnostics.

Read webserver Computer vision

Load the single flashed model and run prediction or detection from camera frames.

Read cv Industrial protocols

Use Modbus and bus modules for structured polling and device integration.

Read modbus

API Reference

Generated from the same stubs used by Studio docs, linting, and autocomplete. Open a module when you need exact signatures and parameter details.

Runtime

system

System runtime native Berry module.

11 functions env

Browser-local environment values.

0 functions time

Real-world time, date, NTP synchronization, and DS3231 RTC support.

19 functions mojoscale_math

Hardware-oriented math helpers for MojoScale Studio.

101 functions control

Feedback control and PID controllers.

14 functions

Networking

wifi

Wi-Fi native Berry module.

24 functions mojoscale_messaging

MojoScale device channel messaging.

8 functions mqtt

MQTT native Berry module.

6 functions http

HTTP client native Berry module.

2 functions webserver

Embedded webserver native Berry module.

10 functions ble

BLE native Berry module.

13 functions

Sensors & I/O

ads1115

ADS1115 16-bit I2C analog-to-digital converter module.

30 functions camera

Camera native Berry module.

15 functions bh1750

BH1750 ambient light sensor module.

17 functions bno085

BNO085 9-axis sensor-fusion IMU module.

23 functions bmp180

BMP180 temperature and pressure module.

9 functions ina219

INA219 current, voltage, and power monitor module.

26 functions bme280

BME280 temperature, humidity, and pressure module.

22 functions button

High-level button, switch, and digital input handling.

12 functions dht

DHT temperature and humidity module.

1 function ds18b20

DS18B20 temperature sensor module.

10 functions sht4x

SHT4x temperature and humidity module.

9 functions hx711

HX711 load-cell amplifier module.

32 functions vl53l0x

VL53L0X time-of-flight distance sensor module.

44 functions icm42688

ICM-42688 6-axis IMU module.

26 functions mpu6050

MPU6050 accelerometer and gyroscope module.

34 functions max31855

MAX31855 thermocouple module.

16 functions max31865

MAX31865 RTD temperature module.

28 functions mfrc522

MFRC522 RFID/NFC reader module.

31 functions gps

UART GNSS receiver module.

22 functions pcf8574

PCF8574 I2C GPIO expander module.

30 functions pulse

Hardware pulse counter module.

17 functions motor

DC motor and simple robot drive helpers.

24 functions relay

High-level relay control for on/off loads.

9 functions stepper

Stepper motor control module.

24 functions ultrasonic

Ultrasonic distance sensor module.

15 functions rotary

Rotary encoder module.

18 functions servo

Servo motor control module.

14 functions pca9685

PCA9685 16-channel PWM driver module.

34 functions neopixel

Addressable RGB/RGBW LED strip module.

27 functions touch

Capacitive touch sensor module.

16 functions joystick

Analog joystick module.

22 functions lm358

LM358 microphone sound sensor module.

19 functions adc

ADC native Berry module.

3 functions gpio

GPIO native Berry module.

5 functions microphone

Generic analog and I2S microphone module.

58 functions pwm

PWM output module.

11 functions

Buses & Protocols

can

Raw CAN 2.0 bus access over the ESP32 TWAI controller.

20 functions j1939

SAE J1939 engine-network access over ESP32 TWAI/CAN.

35 functions i2c

I2C native Berry module.

8 functions modbus

Industrial Modbus native Berry module.

9 functions onewire

OneWire native Berry module.

10 functions spi

SPI native Berry module.

9 functions uart

UART native Berry module.

5 functions

Vision & AI

cv

Computer vision and ESP-DL model module.

12 functions

Displays

ui

Graphical UI module backed by LVGL.

93 functions ssd1306

SSD1306 monochrome OLED display module.

18 functions lcd

Character LCD native Berry module.

28 functions tm1637

TM1637 7-segment display module.

21 functions max7219

MAX7219 LED display driver module.

33 functions

Storage

filesystem

Internal flash filesystem backed by user SPIFFS.

22 functions sdcard

microSD card storage module.

25 functions kv

Key-value storage native Berry module.