← Commit history

Publish 0.1.1

Ray ·7ec091fea3 · ·parent f9dc1d1
4 files changed +440−11
package.json+157−4
@@ -1,6 +1,6 @@ {   "slug": "qk1201",-  "version": "0.1.0",+  "version": "0.1.1",   "type": "component",   "description": "HICHON Battery Management, ESOP-8. Datasheet-verified pinout, KiCad symbol/footprint/3D.",   "tags": [@@ -24,6 +24,159 @@     "docs/hero.png",     "docs/qk1201-datasheet.pdf",     "viewers/symbol.html",-    "viewers/footprint.html"-  ]-}\ No newline at end of file+    "viewers/footprint.html",+    "qk1201-etched.step",+    "qk1201-hero.glb",+    "qk1201-hero.overlay.json"+  ],+  "component": {+    "mpn": "QK1201",+    "manufacturer": "HICHON",+    "package": "ESOP-8",+    "pin_count": 9,+    "category": "PMIC",+    "subcategory": "Battery Management",+    "datasheet": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2301051530_HICHON-QK1201_C5345655.pdf",+    "parts": {+      "symbol": "qk1201.kicad_sym",+      "footprint": "qk1201.kicad_mod",+      "model_3d": "qk1201-hero.glb",+      "model_3d_plain": "qk1201.glb",+      "model_3d_step": "qk1201-etched.step",+      "model_3d_step_plain": "qk1201.step",+      "lbr": "qk1201.lbr"+    },+    "distributor_links": {},+    "pins": [+      {+        "number": "1",+        "name": "BAT",+        "type": "power_in",+        "description": "Battery positive terminal. Connects to the Li-ion cell (+). Float charge voltage 4.20V ±1%, trickle-charge threshold 2.7V, discharge cutoff 2.5V, re-enable 2.9V. Absolute max -5V to +4.5V."+      },+      {+        "number": "2",+        "name": "LED",+        "type": "output",+        "description": "Indicator-LED anode drive. Sources ~3 mA typical. Blinks 1 Hz 50% during charging, solid on when fully charged, 0.5s-on / 4.5s-off when battery < 2.9 V, 8× 1 Hz blinks when battery < 2.5 V."+      },+      {+        "number": "3",+        "name": "VDD",+        "type": "power_in",+        "description": "Charger input power (from USB / 5 V rail). Operating range 3.6 V-5 V; UVLO ≈ 2.55 V. Absolute max -5V to +5.5V."+      },+      {+        "number": "4",+        "name": "BAT2",+        "type": "power_in",+        "description": "Supply pin for the internal LDO. Must be tied to the BAT pin per typical application circuit."+      },+      {+        "number": "5",+        "name": "LDO",+        "type": "power_out",+        "description": "Internal LDO output. Requires a 10 µF decoupling capacitor to GND per typical application."+      },+      {+        "number": "6",+        "name": "K1",+        "type": "input",+        "description": "Capacitive touch input. Registers a valid touch when contact lasts between 54 ms and 5 s; >5 s auto-shuts OUT off (safety). Sensitivity is tuned by an optional 1-50 pF cap from K1 to GND (larger cap = less sensitive)."+      },+      {+        "number": "7",+        "name": "SEL",+        "type": "input",+        "description": "Dimming-sequence select. Float: touch cycles OUT duty 25%→50%→100%→0. Tied to GND: touch cycles OUT duty 100%→50%→25%→0. PWM frequency 30 kHz."+      },+      {+        "number": "8",+        "name": "OUT",+        "type": "output",+        "description": "Open-drain low-side switch to the LED lamp cathode. Internal NMOS Rds(on) ~150 mΩ. LED short-circuit protection trips at IOCP ≈ 2.5 A (VBAT = 3.7 V). Absolute max -0.3V to +5.5V."+      },+      {+        "number": "9",+        "name": "GND",+        "type": "power_in",+        "description": "Chip ground and exposed thermal die pad on the underside of the ESOP-8 package. Must be soldered to the PCB ground plane for thermal dissipation."+      }+    ],+    "provenance": {+      "extractor": "ds2sf",+      "datasheet": {+        "url": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2301051530_HICHON-QK1201_C5345655.pdf",+        "pages": 6,+        "sha256": "3d731d5351b46893",+        "source_tier": "lcsc"+      },+      "cad": "KiCad official (CC-BY-SA 4.0)",+      "pins": {+        "total": 9,+        "described": 9,+        "cites_pages": true,+        "refuses_to_fabricate": true+      }+    },+    "viewers": {+      "symbol": "viewers/symbol.html",+      "footprint": "viewers/footprint.html"+    },+    "models_3d": [+      {+        "file": "qk1201.step",+        "role": "plain",+        "up": "Z",+        "units": "mm",+        "origin": "footprint origin = pad-pattern centre",+        "seat": "z = 0",+        "extents_mm": [+          6,+          4.9,+          1.55+        ],+        "zmin_mm": 0,+        "centre_offset_mm": 0,+        "footprint_binding": "identity",+        "sha256": "2d6f7e774e8143e3320cbd59eb5be9f3b7864614644e3b072006e1eb05fb7fa6",+        "checked": "2026-10-07",+        "checked_by": "factory/step_pose.py (Z-up, origin, seat, binding)"+      },+      {+        "file": "qk1201-etched.step",+        "role": "eda",+        "up": "Z",+        "units": "mm",+        "origin": "footprint origin = pad-pattern centre",+        "seat": "z = 0",+        "extents_mm": [+          6,+          4.9,+          1.55+        ],+        "zmin_mm": 0,+        "centre_offset_mm": 0,+        "footprint_binding": "identity",+        "sha256": "750f4223e7554e9a7a797abc576f221454f296038fa39c14405a7e722ed25fa4",+        "checked": "2026-10-07",+        "checked_by": "factory/step_pose.py (Z-up, origin, seat, binding)"+      }+    ]+  },+  "title": "QK1201",+  "brief": "HICHON Battery Management, ESOP-8. Pinout extracted from the datasheet, KiCad symbol/footprint/3D.",+  "metadata": {+    "specs": {+      "Manufacturer": "HICHON",+      "Package": "ESOP-8",+      "Category": "PMIC",+      "Pins": "9"+    }+  },+  "discovery_triggers": [+    "qk1201"+  ],+  "discovery_pitch": "QK1201 (HICHON) component page with datasheet-verified CAD.",+  "visibility": "public"+}
page.json+10−7
@@ -4,7 +4,7 @@   "slug": "qk1201",   "title": "QK1201",   "brief": "HICHON Battery Management, ESOP-8. Pinout extracted from the datasheet, KiCad symbol/footprint/3D.",-  "version": "0.1.0",+  "version": "0.1.1",   "license": "CC-BY-SA-4.0",   "tags": [     "component",@@ -185,10 +185,13 @@     "docs/hero.png",     "docs/qk1201-datasheet.pdf",     "viewers/symbol.html",-    "viewers/footprint.html"+    "viewers/footprint.html",+    "qk1201-etched.step",+    "qk1201-hero.glb",+    "qk1201-hero.overlay.json"   ],-  "visibility": {-    "public": true-  },-  "updated_at": "2026-09-25T04:38:21.261Z"-}+  "visibility": "public",+  "updated_at": "2026-09-25T04:38:21.261Z",+  "description": "HICHON Battery Management, ESOP-8. Datasheet-verified pinout, KiCad symbol/footprint/3D.",+  "org": "adom"+}\ No newline at end of file
qk1201-hero.glbadded
⋯ 1 unchanged line ⋯
qk1201-hero.overlay.jsonadded+273
@@ -0,0 +1,273 @@+{+  "spec": "adom-hero 1.4",+  "mpn": "QK1201",+  "kind": "component + footprint reference art",+  "board_use": false,+  "plane_z_mm": -0.02,+  "units": "metre",+  "upAxis": "Z",+  "layers": {+    "pad_outlines": {+      "material": "Footprint pads - teal dashed outlines - 50 percent opacity",+      "rgba": [+        0.0,+        0.902,+        0.863,+        0.5+      ],+      "pads": 9,+      "span_mm": 7.24,+      "dash_mm": 0.181,+      "gap_mm": 0.1086,+      "pad_stroke_mm": 0.0434+    },+    "silkscreen": {+      "material": "Silkscreen reference lines - 30 percent opacity",+      "rgba": [+        0.92,+        0.96,+        1.0,+        0.3+      ],+      "footprint_items": 7,+      "pin1": {+        "source": "footprint silkscreen",+        "pad": "1"+      }+    },+    "signal_names": {+      "material": "Signal names - 50 percent opacity",+      "rgba": [+        0.92,+        0.96,+        1.0,+        0.5+      ],+      "font": "DejaVu Sans Mono",+      "labels": 8,+      "sides": "top + mirrored underside (single-sided)",+      "fallback_to_pad_number": 0+    }+  },+  "align": {+    "ok": true,+    "centre_offset_mm": 0.0,+    "tolerance_mm": 0.552,+    "orientation_flipped": false,+    "contacts_bbox_mm": [+      -3.0,+      3.0,+      -2.348,+      2.348+    ],+    "pads_bbox_mm": [+      -3.45,+      3.45,+      -2.205,+      2.205+    ],+    "seating_z_mm": -0.0+  },+  "sources": {+    "glb": "qk1201-etched.glb",+    "glb_sha256": "5f2cd60d5063e90b865bb4f905ae3770f7866e662562e9a04051a1ad29bba80a",+    "footprint": "qk1201.kicad_mod",+    "footprint_sha256": "a7971720bdda0353306df93e5fd71765420f318659baa75f0dc1e7a40c1d2eca",+    "pins": "page.json component.pins",+    "pins_sha256": "473985a1c86c6c32e00ec8bd47b3cfb48cb5d5cfaba7b652965a3a78c55c9930"+  },+  "generator": "adom-wiki 1.8.31 (component_hero)",+  "labels": [+    {+      "pad": "1",+      "text": "BAT",+      "x": -3.6,+      "y": -1.905,+      "align": "right",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "2",+      "text": "LED",+      "x": -3.6,+      "y": -0.635,+      "align": "right",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "3",+      "text": "VDD",+      "x": -3.6,+      "y": 0.635,+      "align": "right",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "4",+      "text": "BAT2",+      "x": -3.6,+      "y": 1.905,+      "align": "right",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "5",+      "text": "LDO",+      "x": 3.6,+      "y": 1.905,+      "align": "left",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "6",+      "text": "K1",+      "x": 3.6,+      "y": 0.635,+      "align": "left",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "7",+      "text": "SEL",+      "x": 3.6,+      "y": -0.635,+      "align": "left",+      "vertical": false,+      "h": 0.6+    },+    {+      "pad": "8",+      "text": "OUT",+      "x": 3.6,+      "y": -1.905,+      "align": "left",+      "vertical": false,+      "h": 0.6+    }+  ],+  "pads": [+    {+      "number": "1",+      "shape": "roundrect",+      "center_mm": [+        -2.475,+        -1.905+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "2",+      "shape": "roundrect",+      "center_mm": [+        -2.475,+        -0.635+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "3",+      "shape": "roundrect",+      "center_mm": [+        -2.475,+        0.635+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "4",+      "shape": "roundrect",+      "center_mm": [+        -2.475,+        1.905+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "5",+      "shape": "roundrect",+      "center_mm": [+        2.475,+        1.905+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "6",+      "shape": "roundrect",+      "center_mm": [+        2.475,+        0.635+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "7",+      "shape": "roundrect",+      "center_mm": [+        2.475,+        -0.635+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "8",+      "shape": "roundrect",+      "center_mm": [+        2.475,+        -1.905+      ],+      "size_mm": [+        1.95,+        0.6+      ],+      "rot": 0.0+    },+    {+      "number": "9",+      "shape": "rect",+      "center_mm": [+        0.0,+        0.0+      ],+      "size_mm": [+        2.29,+        3.0+      ],+      "rot": 0.0+    }+  ]+}