← Commit history

component page: CAD + datasheet-first provenance (official mfr datasheet)

Ray ·9b44b4914b ·2mo ago ·parent 98bad5e
1 file changed +136−20
page.json+136−20
@@ -3,8 +3,9 @@   "type": "component",   "slug": "vl53l0x",   "title": "VL53L0X",-  "brief": "Time-of-flight distance sensor, I2C, up to 2m range",+  "brief": "ST time-of-flight ranging sensor, LGA-12. 940 nm VCSEL, up to 2 m, I2C. True distance, ambient-immune. Datasheet-verified.",   "version": "0.1.0",+  "license": "CC-BY-SA-4.0",   "tags": [     "component",     "sensor",@@ -15,36 +16,151 @@     "lga-12",     "stmicroelectronics"   ],-  "license": "MIT",   "component": {     "mpn": "VL53L0X",     "manufacturer": "STMicroelectronics",     "package": "LGA-12",-    "pin_count": null,-    "category": "library",-    "subcategory": "",-    "body_size": null,-    "parts": {},-    "distributor_links": {}+    "pin_count": 12,+    "category": "Sensor",+    "subcategory": "Time-of-flight distance sensor",+    "datasheet": "https://www.st.com/resource/en/datasheet/vl53l0x.pdf",+    "parts": {+      "symbol": "vl53l0x.kicad_sym",+      "footprint": "vl53l0x.kicad_mod",+      "model_3d": "vl53l0x.glb"+    },+    "distributor_links": {},+    "pins": [+      {+        "number": "1",+        "name": "AVDDVCSEL",+        "type": "power_in",+        "description": "VCSEL supply rail. Connect to the main supply (2.6 to 3.5 V) and decouple as close as possible to the pin. Tied to AVDD in the reference application."+      },+      {+        "number": "2",+        "name": "AVSSVCSEL",+        "type": "power_in",+        "description": "VCSEL ground return. Connect to the main ground plane; may be tied to the other ground pins in the application schematic."+      },+      {+        "number": "3",+        "name": "GND",+        "type": "power_in",+        "description": "Module ground; connect to the main ground plane."+      },+      {+        "number": "4",+        "name": "GND2",+        "type": "power_in",+        "description": "Standard pin forced to the ground domain in the application schematic to avoid instabilities. Connect to the main ground."+      },+      {+        "number": "5",+        "name": "XSHUT",+        "type": "input",+        "description": "Hardware shutdown / reset input, active low. Must always be driven to avoid leakage; a ~10 k\u03a9 pull-up to IOVDD is recommended if the host state is unknown. XSHUT is required to enter hardware standby (no I\u00b2C activity in that state)."+      },+      {+        "number": "6",+        "name": "GND3",+        "type": "power_in",+        "description": "Standard pin forced to the ground domain in the application schematic. Connect to the main ground."+      },+      {+        "number": "7",+        "name": "GPIO1",+        "type": "output",+        "description": "Programmable interrupt output, open-drain. Requires an external pull-up (recommended 10 k\u03a9 to IOVDD). Leave unconnected if unused."+      },+      {+        "number": "8",+        "name": "DNC",+        "type": "unconnected",+        "description": "Do-not-connect. Must be left floating in the application; not a general-purpose pin despite being labelled 'Digital input' in the datasheet."+      },+      {+        "number": "9",+        "name": "SDA",+        "type": "bidirectional",+        "description": "I\u00b2C serial data line (fast mode, up to 400 kHz). Open-drain; requires an external pull-up (typically 1.5-2 k\u03a9 to IOVDD at 2.8 V / 400 kHz). Default 7-bit device address is 0x52 (programmable)."+      },+      {+        "number": "10",+        "name": "SCL",+        "type": "input",+        "description": "I\u00b2C serial clock input (fast mode, up to 400 kHz). Requires an external pull-up to IOVDD (typically 1.5-2 k\u03a9)."+      },+      {+        "number": "11",+        "name": "AVDD",+        "type": "power_in",+        "description": "Main analog supply, 2.6 to 3.5 V. Decouple with 100 nF and 4.7 \u00b5F placed as close as possible to AVDDVCSEL and AVSSVCSEL."+      },+      {+        "number": "12",+        "name": "GND4",+        "type": "power_in",+        "description": "Standard pin forced to the ground domain in the application schematic. Connect to the main ground."+      }+    ],+    "provenance": {+      "extractor": "ds2sf",+      "datasheet": {+        "url": "https://www.st.com/resource/en/datasheet/vl53l0x.pdf",+        "pages": 38,+        "sha256": "f0ae51414474d311",+        "source_tier": "mfr"+      },+      "cad": "KiCad official (CC-BY-SA 4.0)",+      "pins": {+        "total": 12,+        "described": 12,+        "cites_pages": true,+        "refuses_to_fabricate": true+      }+    },+    "viewers": {+      "symbol": "viewers/symbol.html",+      "footprint": "viewers/footprint.html"+    }   },-  "readme": "# VL53L0X\n\nTime-of-flight distance sensor, I2C, up to 2m range\n\nThe VL53L0X is a time-of-flight (ToF) laser-ranging sensor from STMicroelectronics. Measures distances up to 2m with I2C interface. Uses a 940nm VCSEL laser for accurate distance measurement in compact form.",+  "metadata": {+    "specs": {+      "Type": "Time-of-flight distance sensor",+      "Emitter": "940 nm VCSEL (invisible)",+      "Range": "up to ~2 m",+      "Measurement": "absolute distance (ambient-immune)",+      "Interface": "I2C + XSHUT + GPIO1 interrupt",+      "Field of view": "25\u00b0",+      "Supply voltage": "2.6-3.5 V",+      "Package": "LGA-12 (4.4 x 2.4 mm)"+    }+  },+  "sections": [+    "hero",+    "viewers",+    "readme",+    "breadcrumbs",+    "info"+  ],+  "discovery_triggers": [+    "vl53l0x",+    "time of flight sensor",+    "tof distance sensor",+    "laser ranging",+    "lidar sensor i2c"+  ],+  "discovery_pitch": "VL53L0X time-of-flight distance sensor (LGA-12) with datasheet-verified pinout, KiCad symbol/footprint/3D, and full provenance.",   "author": {-    "name": "Kyle Bergstedt",-    "email": "[email protected]"+    "name": "Ray",+    "email": "[email protected]"   },-  "visibility": "public",+  "dependencies": {},   "hero": {     "type": "image",     "path": "docs/hero.png"   },-  "sample_prompts": [],-  "discovery_triggers": [],-  "discovery_pitch": null,-  "metadata": {},-  "created_at": "2026-05-28T05:34:27.571Z",-  "updated_at": "2026-05-28T05:34:27.571Z",-  "description": "ST time-of-flight ranging sensor, LGA-12. 940 nm VCSEL, up to 2 m, I2C. True distance, ambient-immune. Datasheet-verified.",-  "dependencies": {},   "files": [     "page.json",     "README.md",