-
-
Notifications
You must be signed in to change notification settings - Fork 147
Interpreter
This section was ported from justinknight93/Doolittle, who made a very nice job with its JavaScript interpreter
Some changes were made and some new functions were added, and more are to be add.
Some example scripts are here.
You can copy your favourite scripts in the /scripts folder and have them listed in the "Scripts" menu.
For easier development, you can use this bash script to upload code directly via serial.
API Reference for Native Functions Accessible from JS:
Description: Sets the script to be executed next when the current script ends.
Parameters:
-
script(string): The JavaScript code as a string to be loaded.
Returns: void
Description: Returns the current time in milliseconds since the epoch.
Returns: number: The current timestamp in milliseconds.
Description: Pauses execution for the specified number of milliseconds.
Parameters:
-
ms(number): The number of milliseconds to delay.
Returns: void
Description: Sets the digital value (HIGH or LOW) for a specified pin.
Parameters:
-
pin(number): The pin number. -
value(boolean): The value to write (true for HIGH, false for LOW).
Returns: void
Description: Configures the specified pin to behave as an input or an output.
Parameters:
-
pin(number): The pin number. -
mode(number): The mode to set (INPUT, OUTPUT, etc.).
Returns: void
Description: Get and integer from 0 to 100 relative to the battery level.
Returns: number: 0-100 battery level.
Description: Get and integer from 0 to 100 relative to the battery level.
Returns: string[]: "StickCPlus", "StickCPlus2", "Cardputer", "Core2", "Core", "CoreS3/SE".
Description: Open Bruce WiFi connection menu.
Description: Connects to the specified wifi network (without opening any menu).
Parameters:
-
ssid(string): Network name. -
timeout_in_seconds(number): retry connecting. Defaults to 10 seconds if unspecified. -
pwd(string): Network password (optional for open networks)
Returns: boolean. Returns true if connection was successful, false otherwise.
Description: Disconnect Wifi.
Description: scan for available wifi networks. Also disconnect from current wifi network to perform the scan.
Returns: object: An object array with 3 properties:
-
SSID(string): The network name. -
encryptionType(string): The network encryptionType. Possible values:"UNKNOWN", "TKIP/WPA", "WEP","CCMP/WPA","NONE","AUTO" -
MAC(string): The AP MAC address.
Description: Performs an HTTP GET request to the specified URL. Optionally includes headers.
Parameters:
-
url(string): The URL to send the GET request to. -
headers(string[]): An array of headers to include in the request. Headers should be provided as key-value pairs in the array. Example:[ "Content-Type", "application/json", "Authorization", "Bearer your_token_here", "Accept", "application/json" ]
Returns: object: An object with two properties:
-
response(number): The HTTP response code. -
body(string): The response body.
Description: Creates a color from the given RGB values.
Parameters:
-
r(number): The red component (0-255). -
g(number): The green component (0-255). -
b(number): The blue component (0-255).
Returns: number: The color value in 16-bit RGB format.
Description: Sets the text color for drawing operations.
Parameters:
-
color(number): The color value in 16-bit RGB format.
Returns: void
Description: Sets the text size for drawing operations.
Parameters:
-
size(number): The text size multiplier.
Returns: void
Description: Draws a rectangle with the specified parameters.
Parameters:
-
x(number): The x-coordinate of the top-left corner. -
y(number): The y-coordinate of the top-left corner. -
width(number): The width of the rectangle. -
height(number): The height of the rectangle. -
color(number): The color value in 16-bit RGB format.
Returns: void
Description: Draws a filled rectangle with the specified parameters.
Parameters:
-
x(number): The x-coordinate of the top-left corner. -
y(number): The y-coordinate of the top-left corner. -
width(number): The width of the rectangle. -
height(number): The height of the rectangle. -
color(number): The color value in 16-bit RGB format.
Returns: void
Description: Draws the specified text at the given coordinates.
Parameters:
-
text(string): The text to draw. -
x(number): The x-coordinate where the text starts. -
y(number): The y-coordinate where the text starts.
Returns: void
Description: Returns the width of the display.
Returns: number: The width of the display in pixels.
Description: Returns the height of the display.
Returns: number: The height of the display in pixels.
Description: Draws a line with the specified parameters.
Parameters:
-
x(number): The x-coordinate of the starting point. -
y(number): The y-coordinate of the starting point. -
x2(number): The x-coordinate of the final point. -
y2(number): The y-coordinate of the final point. -
color(number): The color value in 16-bit RGB format.
Returns: void
Description: Draws a single pixel on screen.
Parameters:
-
x(number): The x-coordinate of the pixel. -
y(number): The y-coordinate of the pixel. -
color(number): The color value in 16-bit RGB format.
Returns: void
Description: Fill the screen with the specified color.
Parameters:
-
color(number): The color value in 16-bit RGB format.
Returns: void
Description: Show a message dialog.
Parameters:
-
msg(string): The message text.
Returns: void
Description: Show an error message dialog.
Parameters:
-
msg(string): The message text.
Returns: void
Description: Show a file picker dialog.
Parameters:
-
path(string): Root path (optional, defaults to SDcard root if unspecified)
Returns: string. Selected file full path, or empty string if cancelled.
Description: Show a dialog with multiple choices.
Parameters:
-
choices: an all the choices to show. Choices should be provided as key-value pairs in the array. Example:[ "choice1", "return_val1", "choice2", "return_val2", ...]
Returns: string. Selected choice value, or empty string if cancelled.
Description: Show a file viewer dialog.
Parameters:
-
path(string): file pathname to view.
Returns: void
Description: Show a text input dialog.
Parameters:
-
initval(string): initial text field value (optional). -
maxlen(number): max input string lenght (optional). -
title(string): dialog title (optional).
Returns: string. Typed string, or empty string if cancelled.
Description: check if any key/button is pressed;
Returns: boolean: Returns true if any key/button is pressed, or false otherwise.
Description: Return the current state of 'Previous' button;
Returns: boolean: Returns true if pressed and false if not pressed
Description: Return the current state of 'Select' button;
Returns: boolean: Returns true if pressed and false if not pressed
Description: Return the current state of 'Next' button;
Returns: boolean: Returns true if pressed and false if not pressed
Restriction: Works only in Cardputer
Description: Returns the current state of the keys pressed on the M5Cardputer.
Returns: string[]: An array of strings representing the pressed keys. Possible values include "Delete", "Enter", "Alt", "Tab", "Function", "Option", or the actual key character.
Description: Read a small text file with a single call (<4kb).
Parameters:
-
filename(string): file pathname to read.
Returns: string. File contents, or empty string if not found or any other error.
Description: Write a small text file. Append if file exist.
Parameters:
-
filename(string): path of the file to write. -
data(string): string to write.
Returns: boolean: Returns true if successfull or false if failed
Description: Prints the given message to the Serial monitor.
Parameters:
-
message(string): The message to print.
Returns: void
Description: Read a single line from the serial terminal;
Parameters:
-
timeout_in_ms(number): timeout in milli-seconds. Defaults to 10s if unspecified.
Returns: string: Returns the line received
Description: Execute a supported serial command (see the list here);
Parameters:
-
cmd(string): serial command to execute.
Returns: boolean: Returns true if successfull or false if command failed