Skip to content

Releases: nthnn/Uartix

Uartix v1.1

31 Jul 23:57
Compare
Choose a tag to compare

Uartix

A strange dynamic programming language that performs mathematical computations on a connected Raspberry Pi Pico through UART connectivity.

# Hello world example

greet = func(name)
    render "Hello, " + name;

greet("world");

See the complete documentation here.

Getting Started

Before installing Uartix, make sure you have JDK 22 (or OpenJDK) installed on your system. Follow the steps below to get started on different operating systems and to build various components from the source.

Installing Uartix

Linux

  1. Download the .deb File: Visit the release page and download the latest *.deb file for Uartix.

  2. Install Uartix: Open your terminal and navigate to the directory where the .deb file is located. Run the following command to install Uartix:

    sudo dpkg -i uartix_*.deb
  3. Running Uartix: After successfully install the .deb package, you can now run the command uartix on your terminal.

Windows

  1. Download the .zip File: Go to the release page and download the latest .zip file for Uartix.

  2. Extract the File: Extract the contents of the .zip file to C:\uartix.

  3. Set Environment Path: Add C:\uartix\bin to your Environment Path variables to ensure you can run Uartix from any command prompt.

Firmware Installation

To install the Uartix firmware on your Raspberry Pi Pico, follow these steps:

  1. Enter Flash Mode: Connect your Raspberry Pi Pico to your system while holding the BOOTSEL button to enter flash mode.

  2. Download the UF2 Binary: Download the UF2 binary of the Uartix firmware from the release page.

  3. Install the Firmware: Drag and drop the downloaded UF2 file into the Raspberry Pi Pico storage that appears on your computer.

Building from Source

Interpreter

To build the interpreter:

  1. Open in IntelliJ: Open the Uartix repository in IntelliJ IDEA.
  2. Build Artifacts: From the menu, go to Build menu item and select Build Artifacts > Build.

Launcher

On Ubuntu, to build the Uartix launcher, ensure you have Rust and cargo installed on your system. Follow these steps:

  1. Install Dependencies:

    sudo apt-get install mingw-w64
    rustup target add x86_64-pc-windows-gnu
  2. Build the Launcher: Run the following commands to build the launcher:

    cargo build --release
    cargo build --release --target x86_64-pc-windows-gnu

Firmware

To build the Uartix firmware from source, simply follow the steps below.

  1. Installing Raspberry Pi Pico on Arduino IDE: Install the Raspberry Pi Pico boards on your Arduino IDE by following the steps here.
  2. Open in Arduino IDE: Open the file picoware/picoware.ino in your Arduino IDE.
  3. Build & Upload: Connect your Raspberry Pi Pico board on flash mode then upload and build the Picoware on your Arduino IDE.

Full Changelog: v1.0...v1.1

Uartix v1.0

30 Jun 16:06
Compare
Choose a tag to compare

Uartix

A strange dynamic programming language that performs mathematical computations on a connected Raspberry Pi Pico through UART connectivity.

# Hello world example

greet = func(name)
    render "Hello, " + name;

greet("world");

See the complete documentation here.

Getting Started

Before installing Uartix, make sure you have JDK 22 (or OpenJDK) installed on your system. Follow the steps below to get started on different operating systems and to build various components from the source.

Installing Uartix

Linux

  1. Download the .deb File: Visit the release page and download the latest *.deb file for Uartix.

  2. Install Uartix: Open your terminal and navigate to the directory where the .deb file is located. Run the following command to install Uartix:

    sudo dpkg -i uartix_*.deb
  3. Running Uartix: After successfully install the .deb package, you can now run the command uartix on your terminal.

Windows

  1. Download the .zip File: Go to the release page and download the latest .zip file for Uartix.

  2. Extract the File: Extract the contents of the .zip file to C:\uartix.

  3. Set Environment Path: Add C:\uartix\bin to your Environment Path variables to ensure you can run Uartix from any command prompt.

Firmware Installation

To install the Uartix firmware on your Raspberry Pi Pico, follow these steps:

  1. Enter Flash Mode: Connect your Raspberry Pi Pico to your system while holding the BOOTSEL button to enter flash mode.

  2. Download the UF2 Binary: Download the UF2 binary of the Uartix firmware from the release page.

  3. Install the Firmware: Drag and drop the downloaded UF2 file into the Raspberry Pi Pico storage that appears on your computer.

Building from Source

Interpreter

To build the interpreter:

  1. Open in IntelliJ: Open the Uartix repository in IntelliJ IDEA.
  2. Build Artifacts: From the menu, go to Build menu item and select Build Artifacts > Build.

Launcher

On Ubuntu, to build the Uartix launcher, ensure you have Rust and cargo installed on your system. Follow these steps:

  1. Install Dependencies:

    sudo apt-get install mingw-w64
    rustup target add x86_64-pc-windows-gnu
  2. Build the Launcher: Run the following commands to build the launcher:

    cargo build --release
    cargo build --release --target x86_64-pc-windows-gnu

Firmware

To build the Uartix firmware from source, simply follow the steps below.

  1. Installing Raspberry Pi Pico on Arduino IDE: Install the Raspberry Pi Pico boards on your Arduino IDE by following the steps here.
  2. Open in Arduino IDE: Open the file picoware/picoware.ino in your Arduino IDE.
  3. Build & Upload: Connect your Raspberry Pi Pico board on flash mode then upload and build the Picoware on your Arduino IDE.

Full Changelog: https://github.com/nthnn/Uartix/commits/v1.0