ESP32 ROM console¶

When an ESP32 is unable to boot from flash ROM (and the fuse disabling it hasn’t been blown), it boots into a rom console. The console

is based on TinyBasic, and statements entered should be in the form of BASIC statements. As is common in the BASIC language, without a

preceeding line number, commands entered are executed immediately; lines with a prefixed line number are stored as part of a program.

Full list of supported statements and functions¶

System¶

BYE - exits Basic, reboots ESP32, retries booting from flash

END - stops execution from the program, also “STOP”

MEM - displays memory usage statistics

NEW - clears the current program

RUN - executes the current program

IO, Documentation¶

PEEK( address ) - get a 32-bit value from a memory address

POKE - write a 32-bit value to memory

USR(addr, arg1, ..) - Execute a machine language function

PRINT expression - print out the expression, also “?”

PHEX expression - print expression as a hex number

REM stuff - remark/comment, also “’”

Expressions, Math¶

A=V, LET A=V - assign value to a variable

+, -, *, / - Math

,!=,>=,> - Comparisons

ABS( expression ) - returns the absolute value of the expression

RSEED( v ) - sets the random seed to v

RND( m ) - returns a random number from 0 to m

A=1234 - * Assign a decimal value*

A=&h1A2 - * Assign a hex value*

A=&b1001 - Assign a binary value

Control¶

IF expression statement - perform statement if expression is true

FOR variable = start TO end - start for block

FOR variable = start TO end STEP value - start for block with step

NEXT - end of for block

GOTO linenumber - continue execution at this line number

GOSUB linenumber - call a subroutine at this line number

RETURN - return from a subroutine

DELAY - Delay a given number of milliseconds

Pin IO¶

IODIR - Set a GPIO-pin as an output (1) or input (0)

IOSET - Set a GPIO-pin, configured as output, to high (1) or low (0)

IOGET - Get the value of a GPIO-pin

Example programs¶

Here are a few example commands and programs to get you started…

Read UART_DATE register of uart0¶

> PHEX PEEK(&h3FF40078)

15122500

Set GPIO2 using memory writes to GPIO_OUT_REG¶

Note: you can do this easier with the IOSET command

> POKE &h3FF44004,PEEK(&h3FF44004) OR &b100

Get value of GPIO0¶

> IODIR 0,0

> PRINT IOGET(0)

0

Blink LED¶

Hook up an LED between GPIO2 and ground. When running the program, the LED should blink 10 times.

10 IODIR 2,1

20 FOR A=1 TO 10

30 IOSET 2,1

40 DELAY 250

50 IOSET 2,0

60 DELAY 250

70 NEXT A

RUN

Credits¶

The ROM console is based on “TinyBasicPlus” by Mike Field and Scott Lawrence, which is based on “68000 TinyBasic” by Gordon Brandly