Temporal Badge

// JUMPERIDE FLOW

Get Started

Write badge apps in MicroPython from the browser, run them over WebSerial, and save them directly to the badge filesystem.

01

Connect

Open JumperIDE and select the badge serial device.

  1. Visit ide.jumperless.org in a browser that supports WebSerial.
  2. Press Connect and choose the ESP32-S3 badge serial port.
  3. On macOS it is usually the USB/JTAG serial device. On Windows it appears as a COM port.
02

Run Code

Use the raw REPL workflow from JumperIDE.

  1. Open or create a script in the editor.
  2. Press Run / Stop or use F5 to execute the current file.
  3. Read print output and exceptions in the terminal pane.
03

Save Files

Edit directly on the badge filesystem.

  1. Browse the filesystem tree for /apps, /lib, and /tests.
  2. Create files or directories for your app.
  3. Use the green Save button or Ctrl + S to write changes.
04

First App

Clear the OLED, print text, show the LED matrix, then exit.

  1. Create /apps/hello.py.
  2. Use oled_clear(), oled_println(), oled_show(), and led_show_image().
  3. Sleep for a moment, clean up LEDs, and return to the menu.

// HELLO BADGE

Starter Script

In a single-file app, the badge hardware calls are already injected into the global scope. Imported modules should use from badge import *. 

import time

oled_clear()
oled_println("Hello")
oled_println("Temporal")
oled_show()

led_override_begin()
led_show_image(IMG_HEART)
time.sleep(3)

led_clear()
led_override_end()
exit()

// INPUT LOOP

Read Buttons Once

Use edge-triggered input for menu navigation and level-triggered input for continuous movement.

button_pressed(id)

Returns true once per press, then stays false until release and a new press. Store the result if more than one branch needs it.

button(id)

Returns true while the button is held. Use it for movement, repeated actions, or joystick-style controls.