← Commit history

Two-column docs, jump tabs top+bottom, fits height clamp with no internal scroll; drop Fusion line

Caleb ·78e9a338fa ·2mo ago ·parent b5b77b8
1 file changed +43−49
README.html+43−49
@@ -8,12 +8,12 @@   }   * { box-sizing:border-box; margin:0; padding:0; }   html, body { background:var(--bg); color:var(--body);-    font:15px/1.6 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;+    font:14.5px/1.55 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;     scrollbar-width:none; -ms-overflow-style:none; overflow:hidden; }   html::-webkit-scrollbar, body::-webkit-scrollbar { width:0; height:0; display:none; }   #wrap { max-width:880px; margin:0 auto; padding:24px 20px 40px; }   h2 { color:var(--text); font-size:25px; margin:8px 0 6px; letter-spacing:-.01em; }-  h3 { color:var(--text); font-size:19px; margin:28px 0 8px; }+  h3 { color:var(--text); font-size:19px; margin:24px 0 7px; }   h4 { color:var(--text); font-size:16px; margin:22px 0 6px; }   h5 { color:var(--text); font-size:14.5px; margin:18px 0 5px; }   p  { margin:9px 0; }@@ -42,8 +42,13 @@     border:1px solid var(--border); border-radius:8px; padding:8px 13px; margin:11px 0; }   .fig { background:var(--surface); border:1px solid var(--border); border-radius:10px;     padding:12px; margin:16px 0 6px; text-align:center; }-  .fig img { max-width:100%; max-height:400px; width:auto; height:auto; border-radius:6px; }+  .fig img { max-width:100%; max-height:200px; width:auto; height:auto; border-radius:6px; }   .fig img + img { margin-top:10px; }+  .cols { columns:2; column-gap:30px; }+  .figfloat, .fig, .seealso, pre.code { break-inside:avoid; }+  .figfloat { margin:10px 0; }+  .figfloat .fig { margin:0; }+  .figfloat .figcap { margin:6px 0 0; }   .figcap { color:var(--muted); font-size:12.5px; text-align:center; margin:6px 0 16px; }   .tblwrap { overflow-x:auto; margin:13px 0; }   table { border-collapse:collapse; width:100%; font-size:13.5px; }@@ -65,7 +70,7 @@   .dot.on { background:var(--accent); }   .count { color:var(--muted); font-size:12.5px; min-width:46px; text-align:right; }   .srcnote { color:var(--muted); font-size:13px; }-  .secdiv { border:none; border-top:1px solid var(--border); margin:40px 0 0; }+  .secdiv { border:none; border-top:1px solid var(--border); margin:32px 0 0; }   footer { color:var(--muted); font-size:12.5px; margin-top:34px; border-top:1px solid var(--border); padding-top:12px; } </style></head><body> <div id="wrap">@@ -116,7 +121,8 @@     <h2>White Paper: Molecule Design</h2>     <p class="meta">Adom Industries, Inc. · Version 1.0 · September 2025</p>     <p class="seealso related">Related wiki pages: <a href="https://wiki.adom.inc/adom/base-scaffold-system" target="_blank" rel="noopener">Base Scaffold system</a> · <a href="https://wiki.adom.inc/adom/base-scaffold-control-panel" target="_blank" rel="noopener">Workcell Control Panel</a> · <a href="https://wiki.adom.inc/adom/adom-machine-parts-library" target="_blank" rel="noopener">Machine parts library</a></p>-    <figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp02.png" loading="lazy" alt="">+    <div class="cols">+    <div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp02.png" loading="lazy" alt=""> </figure> <p>Adom Industries, Inc.</p> <p>Version 1.0</p>@@ -164,15 +170,12 @@ </ul> <h3>Machine Pins and Contacts</h3> <figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp11.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 1: Available Contacts and Machine Pins</p>+</figure><p class="figcap">Figure 1: Available Contacts and Machine Pins</p></div> <p>Machine pins’ primary function is mechanical, and secondary is electrical. The robotically controlled pincers throughout the Adom Factory interact with molecules, test equipment, and other devices using these machine pins, making them a cornerstone of the factory.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp12.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 2: Pincers Gripping a Machine Pin</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp13.jpg" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 3: Machine Pins and Contacts on a Molecule</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp12.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 2: Pincers Gripping a Machine Pin</p></div>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp13.jpg" loading="lazy" alt="">+</figure><p class="figcap">Figure 3: Machine Pins and Contacts on a Molecule</p></div> <p>Machine pins have machine pin contacts pressed into the tops of them, so other machine pins and wires can be inserted into them. On a molecule, power and signals can be routed to the corner machine pins, if desired.</p> <p>Machine pin contacts are purely electrical in function. They are pressed directly into molecules for connecting power and signals via wires, other machine pins, and machine pin needles.</p> <p class="figcap">Table 1: Machine Pin Comparison</p>@@ -196,13 +199,11 @@ <h4>Base Scaffold</h4> <p><a href="https://wiki.adom.inc/adom/base-scaffold-system" target="_blank" rel="noopener">The base scaffold is the mechanical and electrical foundation</a> of the electronics workspace. It mounts into each workcell, and all other scaffolds and molecules mount onto it. Electrically, it contains a control panel, which provides power and comms to all projects.</p> <p>The base scaffold is 576mm square and provides an 18x18 grid of large machine pin contacts at 32mm spacing. It is the mechanical foundation of the electronics project.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp14.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 4: Base Scaffold</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp14.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 4: Base Scaffold</p></div> <p>Slots for clamps are arrayed throughout, which can be used to secure other scaffolds or molecules. Molecules and scaffolds with large corner machine pins can mount directly onto the base scaffold, while those with medium machine pins require medium-class user scaffolds, which insert into the base scaffold or other user scaffolds.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp15.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 5: Top View of Base Scaffold Panels</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp15.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 5: Top View of Base Scaffold Panels</p></div> <h5>Workcell Control Panel</h5> <p><a href="https://wiki.adom.inc/adom/base-scaffold-control-panel" target="_blank" rel="noopener">The control panel is the user interface to the Base Scaffold System</a>. The scaffold side control panel travels with the scaffold while the workcell side lives in the workcell. The workcell control panel is backed by a Raspberry Pi Compute 5, providing power and data. The scaffold control panel gives users full control of an RP2350A microcontroller and provides power distribution. Capabilities are as follows:</p> <ul>@@ -248,9 +249,8 @@ <li>SWD and UART debug plus boot and reset control of the user MCU, carried across the dock</li> </ul> </ul>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp16.jpg" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 6: Control Panel — workcell (top) and scaffold (bottom) halves</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp16.jpg" loading="lazy" alt="">+</figure><p class="figcap">Figure 6: Control Panel — workcell (top) and scaffold (bottom) halves</p></div> <h4>User Scaffolds</h4> <p>User scaffolds come in a variety of shapes and sizes. They can be used for a number of purposes:</p> <ul>@@ -259,9 +259,8 @@ <li>Adapt from a scaffold with large machine pin contacts to medium machine pin contacts</li> <li>Provide a shift in Z level to align molecules</li> </ul>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp17.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 7: User Scaffold (8mm Pitch)</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp17.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 7: User Scaffold (8mm Pitch)</p></div> <p>For example, the user scaffold shown in Figure 7, above, has some key elements:</p> <ul> <li>Large machine pins in the corners, allowing it to mount to a scaffold with large machine pin contacts</li>@@ -283,9 +282,8 @@ </ul> </ul> <p>Another user scaffold is shown in Figure 8, below. This provides additional options for molecule sizing, but lacks slots for clamping due in part to the tighter spacing of machine pin contacts.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp18.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 8: User Scaffold (4mm Pitch)</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp18.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 8: User Scaffold (4mm Pitch)</p></div> <h4>Clamping</h4> <p>Clamps are used to establish a temporary mechanical connection between two layers in the project. This allows projects to be assembled and disassembled layer by layer. With multiple devices stacked on top of each other, clamps can be used to ensure pincers are able to remove top-most devices without inadvertently removing lower devices. Some typical application where clamps would be useful include:</p> <ul>@@ -293,46 +291,40 @@ <li>Placing one molecule onto another</li> <li>Use of a molecule where non-negligible forces or vibrations are induced, e.g. motors and other electromechanical devices</li> </ul>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp03.png" loading="lazy" alt=""><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp04.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 9: Early Prototype of a Clamp (Two Views)</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp05.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 10: A Clamp Connecting Two Scaffolds</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp03.png" loading="lazy" alt=""><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp04.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 9: Early Prototype of a Clamp (Two Views)</p></div>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp05.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 10: A Clamp Connecting Two Scaffolds</p></div> <h3>Molecules</h3> <p>As mentioned in the introduction, a molecule is a PCB that adheres to Adom Industries’ design rules. These design rules can be applied to make a molecule out of a single resistor, sensors, microcontrollers, and vastly more complex systems. The purpose of these design rules is to facilitate robotically automated prototyping of electronics. Thus, every electronic component can be onboarded into our factory in molecule form.</p> <p class="figcap">Table 2: Comparison of Traditional PCBs and Molecules</p> <div class="tblwrap"><table><tr><th><strong>Traditional PCB</strong></th><th><strong>Molecule</strong></th></tr><tr><td>Mounting holes/ mechanical fasteners are not required, or can be located wherever</td><td>Require a machine pin at each corner to provide a mechanical interfaces</td></tr><tr><td>Any connector can be used</td><td>Electrical connection points from one molecule to another should only use machine pins and contacts</td></tr><tr><td>No particular size or spacing requirements need to be observed</td><td>All machine pins and contacts should be fit to a grid, with spacing any integer multiple of 2mm</td></tr><tr><td>Meant to be picked up by human hands</td><td>The workcell pincers pick up the molecule using the corner machine pins</td></tr><tr><td>Can have slide switches, push buttons, and other kinds of human interfaces</td><td>Machine pin jumpers should be used where possible, with potential for support of various human interfaces to be validated in the future</td></tr></table></div> <p>Each molecule can function as a breakout for a single raw component, but for many components it is preferable to design the molecule to be self-contained for basic operation. In practice, this means adding with supporting components like decoupling caps, oscillators, pull-up/-down resistors, etc. Where multiple configurations are common, jumpers and nested molecules can be utilized to keep the system compact and functional.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp06.jpg" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 11: Molecule with Extra Components for Self-Contained Operation</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp06.jpg" loading="lazy" alt="">+</figure><p class="figcap">Figure 11: Molecule with Extra Components for Self-Contained Operation</p></div> <p class="seealso">Example Molecules on the wiki: <a href="https://wiki.adom.inc/adom/bmi270-molecule" target="_blank" rel="noopener">BMI270 IMU</a> · <a href="https://wiki.adom.inc/adom/bmv080-molecule" target="_blank" rel="noopener">BMV080 PM2.5</a> · <a href="https://wiki.adom.inc/adom/bme690-molecule" target="_blank" rel="noopener">BME690 environmental</a> · <a href="https://wiki.adom.inc/adom/usb3-to-ethernet-dataonly-molecule" target="_blank" rel="noopener">USB3-to-Ethernet</a></p> <p>In general, it is convenient to consider the center of the lower-left corner machine pin to be the XY origin, with the Z plane of the origin defined by the top surface of the molecule. The design rules discussed above then dictate that all machine pins and contacts should be positioned a distance from the origin that is a multiple of 2mm.</p> <h4>Wiring</h4> <p>Wires are the primary means of establishing electrical connection from the workcell control panel to molecules, and from molecule to molecule. The current approach is use of precision-bent enamel coated wire, which provides a low profile conduction path that remains rigid across the span of the workcell.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp07.jpg" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 12: Molecules Arranged on Scaffolds and Wired Together</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp07.jpg" loading="lazy" alt="">+</figure><p class="figcap">Figure 12: Molecules Arranged on Scaffolds and Wired Together</p></div> <p>Medium machine pin contacts can be connected with 24AWG wire, as shown in Figure 12 above, and large machine pin contacts can be connected with 14AWG wire.</p> <p>Currently, human involvement is required for the wiring process, but it will soon become fully automated in order to achieve rapid design setup and iteration.</p> <p>This approach to wiring does not ensure impedance matching for the many high speed applications across all sectors of electronics. This limitation will be resolved soon.</p> <h4>Jumpers</h4> <p>Jumpers are common in all sectors of electronics. On a molecule, it is desirable for the jumpers to be able to be manipulated by the pincers. This is achieved using a machine-pin-style jumper, as shown in Figure 13 below. Jumpers can be designed in a variety of configurations.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp08.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 13: Molecule with Several Machine Pin Jumpers</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp08.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 13: Molecule with Several Machine Pin Jumpers</p></div> <h4>Nested Molecules</h4>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp09.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 14: Molecule Using Nested Molecules for Configurability</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp09.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 14: Molecule Using Nested Molecules for Configurability</p></div> <p>One approach to maximize configurability on a molecule is to use nested molecules. This allows components to be quickly swapped without requiring additional space on the scaffold or adjusting wires. The buck converter shown in Figure 14 demonstrates this at depth, with each nested molecule able to be swapped for others that have the same or larger footprint.</p> <h4>Wings</h4> <p>In general, molecule and scaffold sizes are discussed in terms of the center-to-center distance of machine pins and machine pin contacts. For example, the 64x64mm user scaffold shown in Figure 7, which has its corner machine pins 64mm apart, is in fact 94mm wide. Due to the importance of machine pins, machine pin contacts, and standardized grids in the Adom Factory, this convention persists. So, the space on the PCB outside the machine pins is considered extra and is referred to as a “wing.” In the broadest terms, a wing is any portion of PCB that extends beyond the rectangular bounding box defined by a molecule or scaffold’s corner machine pins. Figure 15 below demonstrates use of a wing to make room for additional machine pin contacts required for accessing all necessary pins on the RP2350B-RM2 molecule.</p>-<figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp10.png" loading="lazy" alt="">-</figure>-<p class="figcap">Figure 15: A Molecule with a Wing on Right Edge</p>+<div class="figfloat"><figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/wp10.png" loading="lazy" alt="">+</figure><p class="figcap">Figure 15: A Molecule with a Wing on Right Edge</p></div> <p>While there are several technical classifications of wings being defined, the details thereof exceed the scope of this document.</p>+    </div>   </section>    <hr class="secdiv">@@ -341,6 +333,7 @@     <p class="meta">Practical guidance: sane PCB design practices, naming, clamping, wings.       Live version <a href="https://docs.google.com/document/d/1LkYCzQ6w03saC3rsyJgP75t7mG2T0FIEeN36KHn8VPE/edit" target="_blank" rel="noopener">in Google Docs</a>.</p>     <p class="seealso related">Related wiki pages: <a href="https://wiki.adom.inc/adom/adom-machine-parts-library" target="_blank" rel="noopener">Machine parts library</a> · <a href="https://wiki.adom.inc/adom/adom-kicad-library" target="_blank" rel="noopener">Adom KiCad library (PCM feed)</a> · <a href="https://wiki.adom.inc/adom/base-scaffold-system" target="_blank" rel="noopener">Base Scaffold system</a></p>+    <div class="cols">     <h3>Welcome to the Adom Molecule Design Guide!</h3> <p>Here we will walk you through a number of concepts and provide resources so that you can design your own Molecules for the Adom Factory in no time!</p> <p>First, please review the W<a href="https://docs.google.com/presentation/d/1LQSI1YMCZsVmC5ofULPHoJVyt0phHyBwX1fbb88-CRs/edit" target="_blank" rel="noopener">hat is a Molecule Slide Deck </a>- this will cover beginner concepts.</p>@@ -487,6 +480,7 @@ <figure class="fig"><img src="https://wiki.adom.inc/adom/molecule-design-guide/render/assets/dg02.png" loading="lazy" alt=""> </figure> <p>The benefit of doing this is that we don’t take up the next position on the 8mm grid of the Scaffold below with our machine pins. Thus, another Molecule that does not have a wing on its top edge could still fit in that scaffold hole pattern, allowing maximum density in the circuit layout.</p>+    </div>   </section>    <nav class="tabs" id="nav-bottom">