# gblach/tlink architecture

> Architecture diagram of the GitHub repository gblach/tlink, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gblach/tlink
- Repository: https://github.com/gblach/tlink

## Overview

##### Project type and purpose
- This is a hardware-design adapter board created in KiCad.
- Purpose: translate the standard Segger J-Link 20-pin IDC interface to the Tag-Connect TC2050 connector (10-pin, 0.10″ or 0.05″) with optional jumpers for power and nTRST.

##### File structure
- Top-level KiCad project files:
- TLink.pro (project definition)
- TLink.sch / TLink.sch-bak (schematic)
- TLink.kicad_pcb / TLink.kicad_pcb-bak (PCB layout)
- Footprint libraries and cache:
- SHF-105‐01...pretty/SHF-105...kicad_mod/step (custom jumper footprint)
- SHF-105...lib, .dcm, .bck (component library for jumpers)
- fp-lib-table, sym-lib-table, fp-info-cache (KiCad library management)
- Output artifacts:
- TLink.zip (Gerber for board fabrication)

##### README for additional insights
- Describes supported connector variants (IDC-20, IDC-10 0.10″, IDC-10 0.05″)
- Notes two jumpers: one ties pin 5 to +5 V/GND, the other ties pin 9 to nTRST
- Includes a rendered image (TLink.png) showing component placement

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Input Connector
    subgraph "Input Connector"
        JLINK["J-Link IDC20 P1"]:::connector
    end

    %% PCB Substrate and Nets
    subgraph "PCB Substrate" 
        SUB["Board Outline & Substrate"]:::substrate
        PR["+5V & GND Rails"]:::power
        NETS["JTAG/SWD Signal Nets (TCK, TMS, TDI, TDO, nTRST, etc.)"]:::signal
    end

    %% Jumpers
    subgraph "Optional Jumpers"
        JMP5["Jumper: Pin5 ↔ +5V/GND"]:::jumper
        JMP9["Jumper: Pin9 ↔ nTRST"]:::jumper
    end

    %% Output Connectors
    subgraph "Output Connectors"
        TC10["Tag-Connect TC2050-IDC (0.10″) P2"]:::connector
        TC05["Tag-Connect TC2050-IDC-050 (0.05″) P3"]:::connector
    end

    %% Project & Libraries
    subgraph "Project Configuration & Libraries"
        PROJ["TLink.pro"]:::config
        FP_TABLE["fp-lib-table"]:::lib
        SYM_TABLE["sym-lib-table"]:::lib
        CACHE["fp-info-cache"]:::lib
    end

    %% Output Artifacts
    subgraph "Manufacturing Outputs"
        GERBER["TLink.zip (Gerber Files)"]:::output
    end

    %% Connections
    JLINK -->|"pins 1–20"| NETS
    NETS -->|"mapped nets"| TC10
    NETS -->|"mapped nets"| TC05

    JMP5 -.->|"optional power tie"| PR
    JMP5 -.->|"net tie"| NETS

    JMP9 -.->|"optional nTRST tie"| NETS

    SUB --> PR
    SUB --> NETS
    SUB --> TC10
    SUB --> TC05

    PROJ --> SUB
    FP_TABLE --> SUB
    SYM_TABLE --> SUB
    CACHE --> SUB

    SUB --> GERBER

    %% Click Events
    click JLINK "https://github.com/gblach/tlink/blob/main/TLink.sch"
    click TC10 "https://github.com/gblach/tlink/blob/main/TLink.sch"
    click TC05 "https://github.com/gblach/tlink/blob/main/TLink.sch"
    click JMP5 "https://github.com/gblach/tlink/blob/main/SHF-105-01-L-D-TH.pretty/SHF-105-01-L-D-TH.kicad_mod"
    click JMP9 "https://github.com/gblach/tlink/blob/main/SHF-105-01-L-D-TH.pretty/SHF-105-01-L-D-TH.kicad_mod"
    click SUB "https://github.com/gblach/tlink/blob/main/TLink.kicad_pcb"
    click PROJ "https://github.com/gblach/tlink/blob/main/TLink.pro"
    click FP_TABLE "https://github.com/gblach/tlink/tree/main/fp-lib-table"
    click SYM_TABLE "https://github.com/gblach/tlink/tree/main/sym-lib-table"
    click CACHE "https://github.com/gblach/tlink/tree/main/fp-info-cache"
    click GERBER "https://github.com/gblach/tlink/blob/main/TLink.zip"

    %% Styles
    classDef connector fill:#eef,stroke:#336,stroke-width:1px
    classDef substrate fill:#f9f9f9,stroke:#666,stroke-width:1px
    classDef signal fill:#d8f8d8,stroke:#088,stroke-width:1px
    classDef power fill:#d8e8f8,stroke:#08f,stroke-width:1px
    classDef jumper fill:#fde2b2,stroke:#f80,stroke-width:1px,stroke-dasharray: 5 5
    classDef config fill:#f0f0f0,stroke:#555,stroke-width:1px
    classDef lib fill:#f0f0f0,stroke:#555,stroke-width:1px
    classDef output fill:#efe,stroke:#393,stroke-width:1px
```
