Program Upload

The following page provides an example of uploading and running a program.

Setup

So you've tinkered with the REPL and have flushed out some basic functionality, which you've then finalized by writing it up as a full Lua script in a text file on your local machine. How do you then upload and run this script? Follow these steps:

Enter command mode.

LUA

$ command

Upload the program with the desired name.

LUA

/ upload|program("my_program.lua")

As the uploader utilises the same communications channel as the serial client, you now must close your serial client.

If you are using Tio, press:

CTRL-t followed by:
'q'

If you are using Putty, simply close the window.

Some serial clients (Teraterm) allow the user to 'Disconnect' without closing the window, which is more convenient for this use case.

If you are using Linux/OSX on your local machine, run the following in your terminal emulator:

BASH

user@pc> cd <directory of 'program_uploader.py'>
user@pc> python program_uploader.py <your program script> /dev/ttyUSB1

If you are using Windows on your local machine, run the following in Windows powershell:

POWERSHELL

PS C:> cd <directory of 'program_uploader.py'>

(In this example, 'C:\Downloads')

POWERSHELL

PS C:\Downloads> python program_uploader.py 
<path to your program script>\<your program script name> COM<port number>

See 'GETTING STARTED' section if you are unsure on how to ascertain '<port number>'.

Confirm the program uploader has completed successfully:

BASH

Upload success!

Re-establish serial communications and again, enter command mode.

LUA

$ command

List the saved programs. Your program should be listed (ordered by upload order).

LUA

/ list|programs

Program 1 : my_program.lua

Exit command mode.

LUA

/ exit

Run your program.

LUA

$ run_program("my_program.lua")

Hello World!

The program uploader script is available here. The Python installer for windows is available here.

Ensure that you select 'Customize installation'-'Next' then tick 'Add Python to environment variables' and 'Precompile standard library'.

Ensure that you also install pyserial (after you've install Python, run the following command in Windows Powershell):

POWERSHELL

PS C:> pip install pyserial