File Manager

The Jumperless has a built in File Manager which you can access in the menu with /, or enter U in the menu and Jumperless will mount as a USB Mass Storage drive called JUMPERLESS where you can edit files on the filesystem.

File System Structure

├── config.txt
│
├── slots/
│   ├── slot0.yaml
│   ├── slot1.yaml
│   ├── slot2.yaml
│   └── ... (up to slot7.yaml)
│
└── python_scripts/
    ├── history.txt
    ├── cool_micropython_script.py
    ├── ... (your python scripts go here)
    │
    └── examples/
        ├── adc_basics.py
        ├── dac_basics.py
        ├── gpio_basics.py
        ├── led_brightness_control.py
        ├── node_connections.py
        ├── stylophone.py
        ├── uart_basics.py
        ├── uart_loopback.py
        └── voltage_monitor.py

Each slot's configuration is stored as a YAML file in the /slots/ directory, and the global hardware configuration is in /config.txt.

Navigation

Basic Movement

File Manager Commands

File Type Icons and Colors

Jumperless eKilo Text Editor

The File Manager also has text editor based off eKilo

Editor Controls

• Ctrl+S: Save file
• Ctrl+Q: Quit editor
• Ctrl+P: Save and launch MicroPython REPL
• Arrow keys: Navigate cursor
• Rotary encoder: Move cursor horizontally
• Click encoder: Enter character selection mode (you can scroll through the letters on the OLED and click again to insert it)

Character Selection With the Click Wheel and OLED

When using the rotary encoder in the editor:

• Click encoder: Enter character selection mode
• Rotate encoder: Cycle through available characters
• Click encoder: Confirm character selection
• Wait 3 seconds: Exit character selection mode

Yes, you could write code with just the click wheel and the OLED if you really wanted to.

OLED Display Support

If you have an OLED connected, the File Manager shows: - Current path and selected file - File navigation with scrolling support - Real-time updates as you navigate

MicroPython Examples

The File Manager automatically creates example Python scripts in /python_scripts/examples/:

Basic Hardware Examples

• adc_basics.py: Basic ADC (Analog-to-Digital Converter) operations.

  • This example shows how to read analog voltages from all ADC channels (0-3). Connect voltage sources to ADC inputs and monitor readings in real-time.

• dac_basics.py: Basic DAC (Digital-to-Analog Converter) operations.

  • Shows how to set DAC voltages on all channels (DAC_A, DAC_B, TOP_RAIL, BOTTOM_RAIL).
  • Hardware setup: Connect voltmeter or LED to DAC output pins.

• gpio_basics.py: Basic GPIO (General Purpose Input/Output) operations.

  • This example demonstrates digital I/O, direction control, and pull resistors.
  • Tests input mode with pull-up, pull-down, and floating configurations.

• node_connections.py: Node connection and routing operations.

  • This example shows how to connect/disconnect nodes, check connections, and clear all connections.
  • Demonstrates working with breadboard nodes, DAC outputs, and GPIO pins.
• uart_loopback.py: UART Loopback Demo.
  • Demonstrates UART communication by looping back data from UART_TX to UART_RX.
  • Open a serial monitor on the Jumperless's second port at 115200 baud to see the looped messages.

Interactive Examples

• interaction_demo.py: Interactive Demo - Control connections with probe, encoder, and buttons.

  • This example shows how to use all the interactive controls together.
  • No special hardware needed - use the probe to tap nodes, the encoder to adjust bridge spread, and buttons to change colors.

• led_brightness_control.py: LED Brightness Control Demo.

  • Tap breadboard pads 1-60 to control the voltage on an LED and display the current draw.
  • Hardware setup: Connect LED anode to breadboard row 15, connect LED cathode to GND.
  • Displays voltage and current on OLED.

• stylophone.py: Jumperless Stylophone.

  • Musical instrument using probe and GPIO to generate audio tones.
  • Hardware setup: Connect speaker between rows 25 (positive) and 55 (negative).
  • Touch breadboard pads to play different frequencies, use probe buttons to adjust sustain.

You can trigger them to regenerate if you messed them up by deleting it with x (when you're in the File Manager), and then entering m to create new copies of any examples it doesn't see.

Editing Slot Files

Slot files (located in /slots/) use YAML format and can be edited directly! They're human-readable files containing:

• bridges - Your circuit connections
• power - Rail and DAC voltages
• colors - Wire colors from Wokwi or custom colors
• config - Routing preferences and GPIO settings

Example slot file:

version: 2
sourceOfTruth: bridges

bridges:
  - {n1: 1, n2: 10, dup: 2, color: red}
  - {n1: NANO_D5, n2: GPIO_1, dup: 2}
  - {n1: TOP_RAIL, n2: 5, dup: 2}

power:
  topRail: 3.30
  bottomRail: 2.50
  dac0: 3.33
  dac1: 0.00

Named nodes you can use: NANO_D0-D13, NANO_A0-A7, GPIO_1-8, TOP_RAIL, BOTTOM_RAIL, GND, DAC0_5V, DAC1_5V, and more (see glossary)

When you edit and save a slot file, the Jumperless will automatically reload it if it's the active slot. This works whether you're using the onboard eKilo editor or have the Jumperless mounted as a USB Mass Storage drive and are editing the files on your computer in you favorite editor.

USB Mass Storage

Enter U in the menu and Jumperless will mount as a USB Mass Storage drive called JUMPERLESS where you can edit files on the filesystem.

Keep in mind that file operations are pretty slow, so make sure to give it time to fully save files when you drop them onto the filesystem.

When you're finished u (or just eject the drive) will unmount the Mass Storage device.

You can also enter Z for a little debug menu

Navigation Reference

File Operations

System