Skip to content

lab-401/fzDigiLab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lab401 DigiLab

DigiLab

Overview

Lab401's DigiLab by tixlegeek is a Flipper Zero® accessory that introduces a new way to explore electronics. Designed to be the first tool you reach for when you're developing, debugging, tinkering or exploring digital electronics.

Key Features

  • Discover signals via the Scope application
  • Probe for voltages and frequencies in the Probe function
  • Detect, discover and interact with SPI & I2C devices directly via the SPI Probe and I2C Probe functions

What Makes DigiLab Special

The DigiLab allows you to feel the circuits you're exploring by combining:

  • RGB LED
  • Flipper's speaker
  • Vibration motor

This combination lets you:

  • See voltage fluctuations
  • Hear the difference between different protocols
  • Feel the different signals flowing around a circuit

Versatile Usage Modes

  • Desktop mode - with included custom-designed mini-probes
  • Portable mode - with included probe tip

Compatibility & Open Source

  • Compatible with the full range of BusPirate accessories
  • 100% Open Source and Open Hardware
  • Perfect combination of functional, fun and educational

Getting Started

Purchase & Setup

  1. Purchase your DigiLab from Lab401's or authorized resellers
  2. Unbox your device and familiarize yourself with it
  3. Install the "Lab401 DigiLab" app from the Flipper App store or Flipper App
  4. Open the app : Navigate to Apps > GPIO > 401/DigiLab

digilab

Calibration Process

The first time you use DigiLab (or when reinstalling the app), calibration is required:

  1. Connect the probes
  2. Place the red probe on the "+5v" pad on the top left of the device
  3. While holding the probe on the "+5v" pad, click "OK"
  4. Your DigiLab is now successfully calibrated!

calibration

Note: If accuracy drifts or you made a calibration mistake, you can easily recalibrate via the "Calibration" menu.


DigiLab Functionality

The DigiLab app includes four main tools:

  1. Scope
  2. Probe
  3. I2C Probe
  4. SPI Probe

1. Scope

The Scope tool allows you to intuitively feel, measure and understand all kinds of signals.

scope

At first glance, it looks like a traditional oscilloscope, allowing you to measure and track track minimum, maximum and average voltages, and see how they change over time.

However, when it's configured to use a combination of the physical feedback mechanisms, it's a bit more of a magic wand than a traditional oscilloscope.

By clicking on the "Config" option, you can link and configure multiple different physical feedback mechanisms to different measured values or alerts.

Example Configuration: One example could be: listen to the signal, track voltage via LED colour, and vibrate if the voltage exceeds a configured value. You can mix and match many different options.

alerts

Feedback Options

Sound:

  • Off - No audio feedback
  • Alert - Audio triggers when "Alert" condition is met
  • On - Follows the voltage/signal measured

Vibro:

  • Off - No haptic feedback
  • Alert - Triggers when "Alert" condition is met

LED:

  • Off - No audio feedback
  • Alert - Audio triggers when "Alert" condition is met
  • Follow - Follows the voltage (Gradient between green and red for 0-12v)
  • Variance - Follows the calculated variance of the measured signal
  • Trigger - Follows when signal exceeds auto-calculated trigger level

Alert Options:

  • Voltage: v<3.3, v>3.3, v<5, v>5, MAX
  • Osc: When signal oscillates around 0v (digital signals, clocks, communications)
  • ~x: When signal is close to x volts

2. Probe

The Probe tool provides quick, clear indication of:

  • Voltages up to 12v
  • Frequencies up to 200kHz
  • Continuous voltages

Ideal for initial circuit exploration or debugging multiple pins.

probe2

3. I2C Probe

DigiLab's I2C probe automatically scans for I2C devices connected via onboard pins.

i2cScan

DigiLab's I2C probe will automatically scan for I2C devices connected via the onboard pins. The DigiLab includes an on-board I2C EEPROM (Memory Chip, U6, on the right side of the PCB) to allow you to experiment with the I2C Probe tool out of the box. (You can even use it to store information that you want to keep "secret" from your Flipper..)

Scanned Devices

When you open the tool, it will automatically scan for I2C Devices. When the scan is completed, you'll be presented with the results. If more than one device was detected, you can use the arrow keys to scroll through the devices.

i2cresults

Prediction Engine

Based on the information gleaned during the scan, the DigiLab will use its in-built heuristics database to try to predict what the detect device might be. You can launch the Prediction Engine by clicking the "Info" button. If results are found you can scroll through them via the arrow buttons.

i2c-prediction

Read/Write Registers

The DigiLab also features a handy embedded hexadecimal editor, which can be used to directly read/write the registers of I2C devices. For example, the device included on the DigiLab board is an EEPROM memory - you can read/write directly into its memory. If it was another device, such as an I2C thermometer, you could peek into its registers directly to obtain the temperature information!

hexedit

hexscreen

Usage Steps:

  1. Set OFFSET - Register's address or starting read address
  2. Set DATA LEN - Number of octets to read from device
  3. Navigate the data:
    • Short press Left/Right: Select octet to edit
    • Long press Left/Right: Navigate faster through octets
    • Short press Up/Down: Increment/Decrement octet's value
    • Long press Up/Down: Increment/Decrement by 16 (4 most significant bits)
    • OK: Save/send
    • Return: Quit hexadecimal editor

4. SPI Probe

Similar to I2C Probe:

  • Scans for connected SPI devices
  • Attempts to determine device nature based on scan results

spi


Technical Specifications

Limitations

The DigiLab is designed for low-voltage digital electronics, compatible with IoT/Arduino/Raspberry/Consumer Electronics ecosystems:

  • Voltage: 0 - 12v
  • Frequency: ~0Hz - 200KHz
  • SPI + I2C: 3.3v only

Accessories

DigiLab is compatible with all BusPirate v5 accessories, specifically: BusPirate Flash Adaptors - for easy connection of DIP8, SOP8 and WSON8 flash chips.

⚠️ Please note, the BusPirate port outputs 3.3v. Do not connect 1.8v accessories, or you will release magic smoke.


Support & Contributions

Acknowledgements

Lab401 would like to thank tixlegeek as the engineer behind the DigiLab, artist for the box and application, and as guardian of this repository.

Getting Help

For assistance with DigiLab (questions, bugs, etc.):

  1. Check existing issues in the GitHub repository
  2. Create new issue if your subject isn't addressed

Contributing to the Project

We welcome contributions! Please follow standard etiquette:

  1. Create an issue
  2. Create a fork + development branch
  3. Push your changes
  4. Create a Pull Request

Note: There is a delay between accepted PRs and contributions going live in the FlipperZero store.

About

Lab401's Digilab companion app for flipper zero

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages