ESP8266 Basic Interperter

Depreciated Page. New site established specificaly for this.

http://ESP8266Basic.com

This is a work in progress and will be maturing as time goes on.This is a proof of concept and should not be used by any person, animal or inanimate object.

Flashing tool to install interpreter on micro controller.

Language Specification:This basic inspired interpreter implements a subset of standard basic commands. It is by no means complete and is lacking significant documentation.

Contents 1 Important (Read First): 2 Flashing the ESP8266 Basic Firmware: 3 Base Commands: 3.1 if .. then 3.2 goto 3.3 gosub and return 3.4 Branch Labels 3.5 print 3.6 input 3.7 let 4 Hardware interface commands: 4.1 po 4.2 pi 5 Web Interface GUI Commands: 5.1 wprint 5.2 Button: 5.3 textbox: 5.4 wait: 6 WiFI Commands: 6.1 connect:

Important (Read First):

Note that the parsing the basic interpreter uses requires that commands uses spaces exactly as shown below.
IF extra spaces are added or omitted it will not parse the command properly.

Flashing the ESP8266 Basic Firmware:

1. Download the package from the download link above.
2. Extract the flashing utility in to its own folder as it will create some files in its directory upon execution.
3. Run the "ESP_Basic_Flasher.exe"
4. Select the comport for your ESP from the drop down.
5. Click the "Firmware Flash" button in the top right corner.
6. reset the ESP8266 unit gpio0 is grounded.
7. Click "OK" when upload is compeat.

Base Commands:

if .. then

The if then command will compare 2 values or variables.

To check if strings are equal to each other use '==', for numbers use '='.

if {variable or value} {=, ==,>,<,<>,} {variable or value} then {statement to be executed if true}

goto

Will jump to the branch label of your choice

goto {label}

gosub and return

Will jump to the branch label of your choice and allow you to return to the location you call the gosub from and continue executing code after the return command is executed. The gosub command has a stack of 255 return points so it is possible to gosub from inside a gosub.

gosub {label}

return

Branch Labels

A branch label allows you to jump from one part of the program to another. It can be a single string of characters with no spaces

{label} (branch labels like in qbasic. No colon required)

print

Will output text or a variable to the serial interface

print {value or variable}

input

Will request input from the user and place it in to a variable. Variable dose not need to be declared prior to request.

input {optional string or variable to display in prompt} {value or variable}

let

Let will perform math or string operations on a set of values or variables and place the result in to a variable.

To ad strings together you must use the '&' symbol instead of the '+'

Can also be used to evaluate logic operations like in the if then statement. If the result is true it will return a 1 otherwise a 0

let {Result variable} = {value or variable} {operator *,/,+,-,&} {value or variable}

let {Result variable} = {value or variable} {=, ==,>,<,<>,} {value or variable}

Hardware interface commands:

po

po allows you to set pin on the esp high or low

po {pin no value or variable} {value or var 1/0}

pi

Will place the high or low status of a pin in to the variable chose.

Useful for reading push buttons and other electronic inputs.

pi {pin no} {var to place result 1/0}




Web Interface GUI Commands:

wprint

Will print text to the browser. Text will be sent to the browser upon the wait command.

wprint {value or variable}

Button:

Functions like a goto command. Will be sent to the browser on the wait command.

button {value or variable} {Branch Label}

textbox:

Note that variable must be populated prior to use. 

The text inside the text entry filed will be what ever is in the variable.

Will be displayed in the browser on the wait command

textbox {variable name}

wait:

Sends all the accumulated gui commands to the browser.

The browser will display once this command is run

wait

WiFI Commands:

connect:

Will connect you to the wifi network using the ssid and password.

connect {Variable or String for SSID} {Variable Or String for password}