- Hardwares are ready
- Driver and flash tool are installed
- Ruff SDK is installed
If preparation is not ready, please refer to Development Preparation
- Create a new directory named
hello-ruff-lite, execute the following commands.
rap init --board tm4c1294-v1
rap init --board esp32-air-v40
- Fill in necessary information according to the tips.
The aim of this step is to add and activate connection channel with development board (one board, one connection channel). One application project can have many connection channel configurations, but only one can be active.
connection channel: descripe how PC connects development board, with port or IP address. Once connection channel has been setup already, all the interactive commands do not need these informations (port, IP address, etc.)
rap session add --name tm4c --paramters serial=0F0036A7
The serial number is fixed for one TM4C1294 developement board. You can acquire it by using
ls /dev/cu.*command on MacOS or
If only one TM4C1294 development board is connected to your PC, you can just skip this step.
rap session add --name esp32 --parameters port=/dev/cu.SLAB_USBtoUART
For different OS, the ESP32’s port is also different. The port is /dev/cu.SLAB* on MacOS, /dev/ttyUSBx on Linux and COMx on Windows.
- Download the Ruff Lite firmware on the download page
- Flash firmware into dev board
rap system upgrade /path/to/ruff-lite-xxx-tm4c1294-v1.bin
rap system upgrade /path/to/ruff-lite-xxx-esp32.zip
- The commands above need to be executed in the Ruff application directory.
- If you use Linux, add
sudobefore rap command.
The default logic of
src/index.js is lighting up the green LED on the board.
#led-1 is green LED on the board (about the LED position, please refer to TM4C1294 board built-in resources)
The default logic of
src/index.js is lighting up the blue LED on the board.
#led is blue LED on the board (about the LED position, please refer to ESP32 board built-in resources)
Since ESP32 has WiFi module inside, you can develop some network-based application. About the WiFi configuration usage, please refer to ESP32 WiFi configuration
If everything goes well, you should see the LED is lighted up after the application starts successfully.
To learn more about Ruff application development, see Ruff Developer Guide - Application Development.