VIZO VIZO DOCS
desktop_windows To the workbench
menu_book Engineering manual v1.0

How to use VIZO:A visual language for interacting with the board

VIZO is not a chatbot for generic conversations, but a graphical engineering tool. You interact with the system using colored arrows, measurement markers, and selection frames directly over the PCB photo or schematic diagram.

bolt Work process

Diagnosis in 3 simple steps

1

1. Put a board or schematic on the bench

Click «+» at the bottom of the screen: take a camera shot, pick a photo from gallery, or attach a PDF schematic / Boardview file.

2

2. Place an arrow or a measurement

Point an arrow at a suspect chip or record voltage with a pin marker (for example, 19V, 0V).

3

3. Launch node analysis (->)

The system will extract the pinout from documentation, compute PWM startup conditions, and provide verified solutions.

VIZO Workbench
alt_route Tool semantics

What arrow and pin colors mean

Every action by the technician on the canvas passes typed spatial vectors into the VIZO core. Below is the system response and UI result for each tool.

Blue arrow (Identification / Datasheet)
Technician action:

Used to identify components. Point the tip at a part — VIZO recognizes the laser marking, explains its circuit role, and attaches the factory pinout crop.

System processing:

SnapEngine resolves RefDes in Boardview. SkiaMacroCropper generates a high-res crop. The Librarian agent validates the MPN, queries distributor catalogs, downloads factory PDF, and extracts the pinout.

UI Output:

Interactive chip callout appears with [Pinout], [PDF], and [Analogs] badges. The card provides pin-by-pin functions and operating voltages.

Yellow arrow (Suspicion / In-circuit test) Action: In-Circuit Test
Technician action:

Indicates a node under inspection. The system generates an in-circuit multimeter procedure without desoldering: diode-mode voltage drop (mV), resistance to GND, and control thresholds.

System processing:

AI Architect calculates node physics, power rails, pull-up/pull-down dividers, and forms a non-destructive test sequence without removing components.

UI Output:

Yellow bounding box on the PCB. The card details diode-mode drops (mV), resistance to GND (Ω), and expected enable signals.

Red arrow (Short circuit / Defect) Action: Root Cause & Cascade
Technician action:

The component is verified failed. The system isolates the shorted rail, highlights the connected power bus, and identifies components at risk of cascade breakdown (high/low-side FETs, downstream loads).

System processing:

System skips re-inspection. It traces backward for root causes (VIN surges, gate driver runaway) and forward for downstream cascade damage.

UI Output:

Red box around defective component. Diagnostic card presents pre-soldering risk checklist (gate driver, high-side FET, load shorts).

Green arrow (Working / Verified OK) Action: Step Forward
Technician action:

Mark a verified, properly operating circuit node.

System processing:

Node is committed to ProvenHealthyNodes facts. The model excludes it from further failure hypotheses and advances along the Power Sequence.

UI Output:

Green healthy badge. The diagnostic card proceeds to the next stage in the startup sequence.

Pin marker (Voltage reading / Manual input) Action: Telemetry Pin
Technician action:

Placed on a test point or chip lead with a specified voltage (e.g. 19V, 0V). When 0V is recorded on a rail, the system provides a structured diagnostic checklist: controller start conditions (EN/VCC), load resistance to GND, and current sense circuits.

System processing:

Live OSNAP magnetically snaps reading to CAD pad. Reading is treated as Ground Truth. If 0V or anomalous voltage is detected, system calculates causes (open pull-up, protection trip, shorted load).

UI Output:

Orange badge with exact voltage right on the pin. Card provides circuit analysis explaining voltage drops and root causes.

crop Crop — Dense cluster / Schematic section focus Tool: Crop Focus
Technician action:

Select dense SMD clusters or intricate schematic areas using a rectangle.

System processing:

Client extracts full-resolution crop without downscaling entire board. SpatialFrameAggregator identifies all components inside bounding box and feeds them as a unified cluster.

UI Output:

AI analyzes multi-component interactions concurrently (e.g. full charger support circuitry) without losing optical line sharpness.

auto_awesome Hidden gems

Hidden UI superpowers you should know

flip Purple X-Ray is an active portal

If a component is on the other side, it renders with a dashed purple outline and a [🔄 BOT] badge. Clicking this badge automatically flips the board in 3D and glides the camera directly to that component on the reverse layer.

ads_click Clickable chips in instruction text

Every component mentioned in the diagnostic text (e.g. 🎯 PU401 or 🎯 PR302) is an interactive button. Clicking it instantly centers and zooms the workbench on that component.

pin Quick input with auto-magnetic snap

When placing a Pin marker near a lead, VIZO pre-fills the designator (e.g. PU401.16:). Do not delete it — simply type 19V and press Enter.

restart_alt Safe cancel with zero quota loss

If you press «Cancel» during analysis, submit an empty query by accident, or experience a network drop, the diagnostic count is automatically refunded.

travel_explore Interactive forum fix jump

In the forum precedents carousel, clicking a solution card (e.g. «Typical fault: shorted capacitor PC501») automatically highlights and flies to that exact capacitor on your board.

description Header slot click to view PDF

When a schematic PDF is loaded, clicking the top bar slot [ 📄 schematic.pdf ] opens the full schematic in the built-in fullscreen viewer.

my_location Secret to sub-millimeter calibration: «The 3-Pass Clockwise Rule»

How to achieve 0.2 mm CAD alignment precision on any smartphone camera

VIZO utilizes an 8-DOF Direct Linear Transformation (DLT Homography). Moving one control point recalculates perspective across the entire board. To align CAD pads with QFN 0.4–0.5 mm lead pitches, use the iterative 3-pass method:

Pass 1 Zoom: 1.0x
Rough board outline fit

At full view, align the 4 reticles with outer PCB corners or mounting screw holes (H1..H4).

Pass 2 Zoom: 3.0x–5.0x
Clockwise landmark lock

Zoom in and align reticles with pin 1 of corner ICs clockwise: TL → TR → BR → BL.

Pass 3 Zoom: Max (RMB)
Final fine adjustment

Final verification loop. Use Right Mouse Button (RMB) to instantly pull the nearest corner under your cursor without scrolling.

mouse RMB / Alt + LMB: Instant grab of nearest corner under cursor at high zoom.
rotate_90_degrees_cw 90° & Flip buttons: Rotate or mirror grid if board is upside down.
warning Red wireframe: Warns of self-intersecting or degenerate corner coordinates.
conversion_path Topology & Animation

Signal and power rail tracing (Signal Tracer)

VIZO features a built-in topological visualization engine that transforms static netlists into directed energy flows with animated current particles passing through series components and jumping across board layers.

arrow_forward 1. Directed Flow

Traces originate from physical sources (connector JDCIN, IC output) through 2-pin passives (PL402.1 → PL402.2) to loads. Glowing neon particles indicate current direction at 60 FPS.

layers 2. Layer-Hopping Via Jump

When a signal dives into internal layers, the line does not break. The engine locates the nearest via (VIA), renders a pulsing purple ring, and casts an X-ray dashed ray to the reverse side component.

account_tree 3. Power & Gate-Drive Separation

Main power rails (19V / 3.3V) display in cyan, while PWM controller gate-drive signals display in separate green rays. You immediately see where gate switching pulses originate.

Signal trace color coding:

Cyan (Cyan) Main power rail, USB D+, TX
Green (Green) Gate Drive, Enable, Power Good
Purple (Purple) Secondary rails, USB D-, RX, audio right
Yellow (Yellow) Clock (CLK), Feedback (FB)
layers Interactive HUD

Anatomy of an interactive part callout

psychology Documentation on demand mode (On-Demand Context)

VIZO intentionally disables background bulk-loading of datasheets for all board components to maximize responsiveness and keep the AI context clean. Basic mode operates instantly on internal engineering memory. When a node is in a «gray zone» (voltage is abnormal), click the chip name and toggle 🧠. The factory PDF becomes an absolute anchor of truth, matching your readings against the manufacturer's Electrical Characteristics down to the millivolt.

🧠
Center chip (Attach to AI):

Click the chip name to enable the brain icon. The next question automatically sends the full pin table of that IC into the model context.

📄
Badge [ PDF ] (Factory datasheet):

Opens the official manufacturer PDF in the built-in viewer, including offline support on phones.

📌
Badge [ Pinout ] (Package drawing):

Click to expand a datasheet crop of the package with pin numbers (QFN, SOIC, TO-220) and names (VIN, GND, BOOT, EN).

🔄
Badge [ Analogs ] (Pin-to-pin replacements):

A list of 100% compatible chips from other brands when the original IC is not in the shop.

Pinout drawing
tips_and_updates Secrets of efficient work

VIZO engineering tips

1

Worn-off chip marking

If the package is burned or covered in coating, pick the Pin tool, tap the chip body, and type the likely part number (e.g. TPS51125). The model will fetch docs from your text.

2

Dense schematics and crossings

If the drawing is a thick mesh of crossing lines, select the suspect node with Crop. The model gets a high-resolution crop so the lines do not smear.

3

Follow-up questions in the bar

Do not clear the board for a new question. Type below: “Pin 3 is only 0.4V instead of 1.8V, why?” — VIZO will compute the divider in front of that pin.

keyboard Navigation and gestures

Controlling the workbench on PC and phones

mouse Computer and mouse
  • Mouse wheel Smooth zoom around the cursor
  • Hold LMB (Hand) Pan the board on the table
  • Double-click Reset zoom to 1:1
  • Escape Clear the crop box
  • Enter Send the measurement for analysis
touch_app Phone and tablet
  • Two-finger pinch Pinch-to-zoom
  • One-finger swipe Pan the board in Hand mode
  • Double-tap Reset zoom
  • Swipe a card left/right Flip hypotheses and fixes
  • Swipe the PDF window down Quickly close the datasheet
developer_board

Ready to test it on your board?

Open the workbench, load the first board, and see how fast datasheet crops and node analysis feel.

Go to the workbench arrow_forward