← Commit history

pin 1: carry the footprint's marker into the .lbr, the viewer and page.json (silk-marker, drawn, top-left)

Ray ·79dca12f31 ·2mo ago ·parent c4f2116
5 files changed +249−116
ams1117-1-8v.lbr+1−1
@@ -69,7 +69,7 @@   <wire x1="1.8500" y1="3.3500" x2="1.8500" y2="-3.3500" width="0.1000" layer="51"/>   <text x="0" y="4.010" size="1.27" layer="25" align="bottom-center">&gt;NAME</text>   <text x="0" y="-4.010" size="1.27" layer="27" align="top-center">&gt;VALUE</text>-</package>+<!--adom-pin1--><polygon width="0.0500" layer="21"><vertex x="-3.1300" y="3.3100"/><vertex x="-3.3700" y="3.6400"/><vertex x="-2.8900" y="3.6400"/><vertex x="-3.1300" y="3.3100"/></polygon></package> </packages> <symbols> <symbol name="SOT-223-3_TabPin2">
package.json+2−1
@@ -24,6 +24,7 @@     "docs/hero.png",     "docs/ams1117-1-8v-datasheet.pdf",     "viewers/symbol.html",-    "viewers/footprint.html"+    "viewers/footprint.html",+    "pads.json"   ] }\ No newline at end of file
pads.jsonadded+121
@@ -0,0 +1,121 @@+{+ "schema": "adom.pads/1",+ "slug": "ams1117-1-8v",+ "footprint": "SOT-223-3_TabPin2",+ "generated_from": {+  "footprint": "SOT-223-3_TabPin2@sha256:8ae5f03e2c16377a",+  "pins": "page.json:component.pins",+  "overrides": null+ },+ "pin1": {+  "pad": "1",+  "at": [+   -3.15,+   -2.3+  ],+  "corner": "top-left",+  "source": "silk-marker",+  "derived_from": "SOT-223-3_TabPin2@sha256:8ae5f03e2c16377a"+ },+ "pad_count": 3,+ "paste_apertures": 0,+ "issues": [+  {+   "kind": "pin-has-no-pad",+   "pin": "4",+   "detail": "page.json declares pin \"4\" but the footprint has no such pad"+  }+ ],+ "pads": [+  {+   "pad": "1",+   "kind": "smd",+   "shape": "roundrect",+   "at": [+    -3.15,+    -2.3+   ],+   "rot": 0.0,+   "size": [+    2.0,+    1.5+   ],+   "layers": [+    "F.Cu",+    "F.Mask",+    "F.Paste"+   ],+   "thermal": false,+   "pin": "1",+   "name": "GND",+   "type": "power_in",+   "description": "Ground / common return pin. On the fixed 1.8V version (AMS1117-1.8V), pin 1 (labeled VSS/ADJ in the pinout table) functions as the device ground reference. Connect to system single-point ground.",+   "is_pin1": true,+   "source": {+    "geometry": "SOT-223-3_TabPin2.kicad_mod",+    "meaning": "page.json:component.pins",+    "correspondence": "kicad: symbol pin number == pad name"+   }+  },+  {+   "pad": "2",+   "kind": "smd",+   "shape": "roundrect",+   "at": [+    -3.15,+    0.0+   ],+   "rot": 0.0,+   "size": [+    2.0,+    1.5+   ],+   "layers": [+    "F.Cu",+    "F.Mask",+    "F.Paste"+   ],+   "thermal": false,+   "pin": "2",+   "name": "VOUT",+   "type": "power_out",+   "description": "Regulated 1.8V output pin (1.764V min / 1.836V max, ±2%). Sources up to 1A of load current. Requires a 10uF tantalum output capacitor for stability.",+   "is_pin1": false,+   "source": {+    "geometry": "SOT-223-3_TabPin2.kicad_mod",+    "meaning": "page.json:component.pins",+    "correspondence": "kicad: symbol pin number == pad name"+   }+  },+  {+   "pad": "3",+   "kind": "smd",+   "shape": "roundrect",+   "at": [+    -3.15,+    2.3+   ],+   "rot": 0.0,+   "size": [+    2.0,+    1.5+   ],+   "layers": [+    "F.Cu",+    "F.Mask",+    "F.Paste"+   ],+   "thermal": false,+   "pin": "3",+   "name": "VIN",+   "type": "power_in",+   "description": "Unregulated input supply pin. Operating range up to 15V (typ) / 18V (abs max); must be at least Vout + Vdropout (≥3.1V for the 1.8V fixed variant per electrical characteristics). Recommend 10uF tantalum bypass capacitor to GND.",+   "is_pin1": false,+   "source": {+    "geometry": "SOT-223-3_TabPin2.kicad_mod",+    "meaning": "page.json:component.pins",+    "correspondence": "kicad: symbol pin number == pad name"+   }+  }+ ]+}\ No newline at end of file
page.json+124−113
@@ -1,118 +1,129 @@ {- "schema_version": 1,- "type": "component",- "slug": "ams1117-1-8v",- "title": "AMS1117-1.8V",- "brief": "MSKSEMI AMS1117 1 8V Voltage Regulators - Linear, Low Drop Out (LDO) Regulators, SOT-223. Datasheet-verified pinout, KiCad symbol/footprint/3D.",- "version": "0.1.0",- "license": "CC-BY-SA-4.0",- "tags": [-  "component",-  "pmic",-  "ams1117-1.8v"- ],- "component": {-  "mpn": "AMS1117-1.8V",-  "manufacturer": "MSKSEMI AMS1117 1 8V",-  "package": "SOT-223",-  "pin_count": 4,-  "category": "PMIC",-  "subcategory": "Voltage Regulators - Linear, Low Drop Out (LDO) Regulators",-  "datasheet": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2308021705_MSKSEMI-AMS1117-1-8V_C7380514.pdf",-  "parts": {-   "symbol": "ams1117-1-8v.kicad_sym",-   "footprint": "ams1117-1-8v.kicad_mod",-   "model_3d": "ams1117-1-8v.glb",-   "model_3d_step": "ams1117-1-8v.step",-   "lbr": "ams1117-1-8v.lbr"+  "schema_version": 1,+  "type": "component",+  "slug": "ams1117-1-8v",+  "title": "AMS1117-1.8V",+  "brief": "MSKSEMI AMS1117 1 8V Voltage Regulators - Linear, Low Drop Out (LDO) Regulators, SOT-223. Datasheet-verified pinout, KiCad symbol/footprint/3D.",+  "version": "0.1.0",+  "license": "CC-BY-SA-4.0",+  "tags": [+    "component",+    "pmic",+    "ams1117-1.8v"+  ],+  "component": {+    "mpn": "AMS1117-1.8V",+    "manufacturer": "MSKSEMI AMS1117 1 8V",+    "package": "SOT-223",+    "pin_count": 4,+    "category": "PMIC",+    "subcategory": "Voltage Regulators - Linear, Low Drop Out (LDO) Regulators",+    "datasheet": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2308021705_MSKSEMI-AMS1117-1-8V_C7380514.pdf",+    "parts": {+      "symbol": "ams1117-1-8v.kicad_sym",+      "footprint": "ams1117-1-8v.kicad_mod",+      "model_3d": "ams1117-1-8v.glb",+      "model_3d_step": "ams1117-1-8v.step",+      "lbr": "ams1117-1-8v.lbr"+    },+    "distributor_links": {},+    "pins": [+      {+        "number": "1",+        "name": "GND",+        "type": "power_in",+        "description": "Ground / common return pin. On the fixed 1.8V version (AMS1117-1.8V), pin 1 (labeled VSS/ADJ in the pinout table) functions as the device ground reference. Connect to system single-point ground."+      },+      {+        "number": "2",+        "name": "VOUT",+        "type": "power_out",+        "description": "Regulated 1.8V output pin (1.764V min / 1.836V max, ±2%). Sources up to 1A of load current. Requires a 10uF tantalum output capacitor for stability."+      },+      {+        "number": "3",+        "name": "VIN",+        "type": "power_in",+        "description": "Unregulated input supply pin. Operating range up to 15V (typ) / 18V (abs max); must be at least Vout + Vdropout (≥3.1V for the 1.8V fixed variant per electrical characteristics). Recommend 10uF tantalum bypass capacitor to GND."+      },+      {+        "number": "4",+        "name": "VOUT",+        "type": "power_out",+        "description": "SOT-223 tab pin, electrically connected to VOUT (pin 2). Acts as the primary heatsinking pad; solder to a copper pour to reduce thermal resistance (θJC ≈ 20°C/W, dropping toward ~30°C/W total with a 5cm×5cm 2-side pour)."+      }+    ],+    "provenance": {+      "extractor": "ds2sf",+      "datasheet": {+        "url": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2308021705_MSKSEMI-AMS1117-1-8V_C7380514.pdf",+        "pages": 14,+        "sha256": "768f1a5d913d6211",+        "source_tier": "lcsc"+      },+      "cad": "KiCad official (CC-BY-SA 4.0)",+      "pins": {+        "total": 4,+        "described": 4,+        "cites_pages": true,+        "refuses_to_fabricate": true+      }+    },+    "viewers": {+      "symbol": "viewers/symbol.html",+      "footprint": "viewers/footprint.html"+    },+    "pin1": {+      "pad": "1",+      "at": [+        -3.15,+        -2.3+      ],+      "corner": "top-left",+      "source": "silk-marker",+      "derived_from": "SOT-223-3_TabPin2@sha256:8ae5f03e2c16377a",+      "mark": "drawn"+    }+  },+  "metadata": {+    "specs": {+      "Manufacturer": "Unknown",+      "Package": "SOT-223",+      "Category": "PMIC",+      "Pins": "4"+    }   },-  "distributor_links": {},-  "pins": [-   {-    "number": "1",-    "name": "GND",-    "type": "power_in",-    "description": "Ground / common return pin. On the fixed 1.8V version (AMS1117-1.8V), pin 1 (labeled VSS/ADJ in the pinout table) functions as the device ground reference. Connect to system single-point ground."-   },-   {-    "number": "2",-    "name": "VOUT",-    "type": "power_out",-    "description": "Regulated 1.8V output pin (1.764V min / 1.836V max, \u00b12%). Sources up to 1A of load current. Requires a 10uF tantalum output capacitor for stability."-   },-   {-    "number": "3",-    "name": "VIN",-    "type": "power_in",-    "description": "Unregulated input supply pin. Operating range up to 15V (typ) / 18V (abs max); must be at least Vout + Vdropout (\u22653.1V for the 1.8V fixed variant per electrical characteristics). Recommend 10uF tantalum bypass capacitor to GND."-   },-   {-    "number": "4",-    "name": "VOUT",-    "type": "power_out",-    "description": "SOT-223 tab pin, electrically connected to VOUT (pin 2). Acts as the primary heatsinking pad; solder to a copper pour to reduce thermal resistance (\u03b8JC \u2248 20\u00b0C/W, dropping toward ~30\u00b0C/W total with a 5cm\u00d75cm 2-side pour)."-   }+  "sections": [+    "hero",+    "viewers",+    "readme",+    "breadcrumbs",+    "info"   ],-  "provenance": {-   "extractor": "ds2sf",-   "datasheet": {-    "url": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2308021705_MSKSEMI-AMS1117-1-8V_C7380514.pdf",-    "pages": 14,-    "sha256": "768f1a5d913d6211",-    "source_tier": "lcsc"-   },-   "cad": "KiCad official (CC-BY-SA 4.0)",-   "pins": {-    "total": 4,-    "described": 4,-    "cites_pages": true,-    "refuses_to_fabricate": true-   }+  "discovery_triggers": [+    "ams1117-1.8v"+  ],+  "discovery_pitch": "AMS1117-1.8V (Unknown) component page with datasheet-verified CAD.",+  "author": {+    "name": "Ray",+    "email": "[email protected]"+  },+  "dependencies": {},+  "hero": {+    "type": "image",+    "path": "docs/hero.png"   },-  "viewers": {-   "symbol": "viewers/symbol.html",-   "footprint": "viewers/footprint.html"-  }- },- "metadata": {-  "specs": {-   "Manufacturer": "Unknown",-   "Package": "SOT-223",-   "Category": "PMIC",-   "Pins": "4"-  }- },- "sections": [-  "hero",-  "viewers",-  "readme",-  "breadcrumbs",-  "info"- ],- "discovery_triggers": [-  "ams1117-1.8v"- ],- "discovery_pitch": "AMS1117-1.8V (Unknown) component page with datasheet-verified CAD.",- "author": {-  "name": "Ray",-  "email": "[email protected]"- },- "dependencies": {},- "hero": {-  "type": "image",-  "path": "docs/hero.png"- },- "files": [-  "page.json",-  "README.md",-  "ams1117-1-8v.kicad_sym",-  "ams1117-1-8v.kicad_mod",-  "ams1117-1-8v.glb",-  "ams1117-1-8v.step",-  "ams1117-1-8v.lbr",-  "docs/hero.png",-  "docs/ams1117-1-8v-datasheet.pdf",-  "viewers/symbol.html",-  "viewers/footprint.html"- ]+  "files": [+    "page.json",+    "README.md",+    "ams1117-1-8v.kicad_sym",+    "ams1117-1-8v.kicad_mod",+    "ams1117-1-8v.glb",+    "ams1117-1-8v.step",+    "ams1117-1-8v.lbr",+    "docs/hero.png",+    "docs/ams1117-1-8v-datasheet.pdf",+    "viewers/symbol.html",+    "viewers/footprint.html"+  ] }\ No newline at end of file
viewers/footprint.html+1−1
@@ -23,7 +23,7 @@ rect.pad.hi{stroke:var(--hi);stroke-width:.15;paint-order:stroke} #tip .td{font-size:11px;color:var(--ink);margin-top:5px;line-height:1.4} </style></head><body> <div class=bar><span class=h>PCB footprint</span><span class=sp></span><button class="lyrtog on" data-lyr="copper"><span class="d" style="background:#e35d5d"></span>Copper</button><button class="lyrtog on" data-lyr="silk"><span class="d" style="background:#e6edf3"></span>Silkscreen</button><button class="lyrtog" data-lyr="fab"><span class="d" style="background:#8b949e"></span>Fab</button><button class="lyrtog" data-lyr="courtyard"><span class="d" style="background:#bc8cff"></span>Courtyard</button></div>-<div class=stage id=stage><svg xmlns='http://www.w3.org/2000/svg' viewBox='-4.800 -4.000 9.600 8.000' style='width:100%;height:100%'><line class='ly-silk' x1='-1.850' y1='-3.410' x2='1.910' y2='-3.410' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-silk' x1='-1.850' y1='3.410' x2='1.910' y2='3.410' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-silk' x1='1.910' y1='-3.410' x2='1.910' y2='-2.150' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-silk' x1='1.910' y1='3.410' x2='1.910' y2='2.150' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-courtyard' x1='-4.400' y1='-3.600' x2='-4.400' y2='3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-courtyard' x1='-4.400' y1='3.600' x2='4.400' y2='3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-courtyard' x1='4.400' y1='-3.600' x2='-4.400' y2='-3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-courtyard' x1='4.400' y1='3.600' x2='4.400' y2='-3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-fab' x1='-1.850' y1='-2.350' x2='-1.850' y2='3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='-1.850' y1='-2.350' x2='-0.850' y2='-3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='-1.850' y1='3.350' x2='1.850' y2='3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='-0.850' y1='-3.350' x2='1.850' y2='-3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='1.850' y1='-3.350' x2='1.850' y2='3.350' stroke='#f472b6' stroke-width='0.100'/><rect class='ly-copper pad' data-num='1' data-name='GND' x='-4.150' y='-3.050' width='2.000' height='1.500' rx='0.375' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='-3.150' y='-2.300' font-size='0.900' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>1</text><rect class='ly-copper pad' data-num='2' data-name='VOUT' x='-4.150' y='-0.750' width='2.000' height='1.500' rx='0.375' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='-3.150' y='0.000' font-size='0.900' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>2</text><rect class='ly-copper pad' data-num='2' data-name='VOUT' x='2.150' y='-1.900' width='2.000' height='3.800' rx='0.500' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='3.150' y='0.000' font-size='1.100' transform='rotate(-90 3.150 0.000)' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>2</text><rect class='ly-copper pad' data-num='3' data-name='VIN' x='-4.150' y='1.550' width='2.000' height='1.500' rx='0.375' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='-3.150' y='2.300' font-size='0.900' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>3</text></svg></div>+<div class=stage id=stage><svg xmlns='http://www.w3.org/2000/svg' viewBox='-4.800 -4.000 9.600 8.000' style='width:100%;height:100%'><line class='ly-silk' x1='-1.850' y1='-3.410' x2='1.910' y2='-3.410' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-silk' x1='-1.850' y1='3.410' x2='1.910' y2='3.410' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-silk' x1='1.910' y1='-3.410' x2='1.910' y2='-2.150' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-silk' x1='1.910' y1='3.410' x2='1.910' y2='2.150' stroke='#d8b4fe' stroke-width='0.120'/><line class='ly-courtyard' x1='-4.400' y1='-3.600' x2='-4.400' y2='3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-courtyard' x1='-4.400' y1='3.600' x2='4.400' y2='3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-courtyard' x1='4.400' y1='-3.600' x2='-4.400' y2='-3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-courtyard' x1='4.400' y1='3.600' x2='4.400' y2='-3.600' stroke='#4ade80' stroke-width='0.050'/><line class='ly-fab' x1='-1.850' y1='-2.350' x2='-1.850' y2='3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='-1.850' y1='-2.350' x2='-0.850' y2='-3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='-1.850' y1='3.350' x2='1.850' y2='3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='-0.850' y1='-3.350' x2='1.850' y2='-3.350' stroke='#f472b6' stroke-width='0.100'/><line class='ly-fab' x1='1.850' y1='-3.350' x2='1.850' y2='3.350' stroke='#f472b6' stroke-width='0.100'/><rect class='ly-copper pad' data-num='1' data-name='GND' x='-4.150' y='-3.050' width='2.000' height='1.500' rx='0.375' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='-3.150' y='-2.300' font-size='0.900' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>1</text><rect class='ly-copper pad' data-num='2' data-name='VOUT' x='-4.150' y='-0.750' width='2.000' height='1.500' rx='0.375' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='-3.150' y='0.000' font-size='0.900' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>2</text><rect class='ly-copper pad' data-num='2' data-name='VOUT' x='2.150' y='-1.900' width='2.000' height='3.800' rx='0.500' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='3.150' y='0.000' font-size='1.100' transform='rotate(-90 3.150 0.000)' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>2</text><rect class='ly-copper pad' data-num='3' data-name='VIN' x='-4.150' y='1.550' width='2.000' height='1.500' rx='0.375' fill='#f59e0b' stroke='#00000033' stroke-width='0.03' opacity='0.94'/><text class='padnum' x='-3.150' y='2.300' font-size='0.900' fill='#1c1206' text-anchor='middle' dominant-baseline='central' pointer-events='none' font-family='ui-monospace,monospace' font-weight='700'>3</text><polygon class='ly-silk adom-pin1' points='-3.130,-3.310 -3.370,-3.640 -2.890,-3.640 -3.130,-3.310' fill='#d8b4fe' stroke='none'><title>pin 1</title></polygon></svg></div> <div id=tip></div> <script> var KIND="footprint", MPN="RAY/AMS1117-1-8V", PINS=[{"desc":"","name":"GND","number":"1","type":""},{"desc":"","name":"VOUT","number":"2","type":""},{"desc":"","name":"VOUT","number":"4","type":""},{"desc":"","name":"VIN","number":"3","type":""}];