bluer-sbc 9.168.1__py3-none-any.whl → 9.319.1__py3-none-any.whl

bluer_sbc/README/designs/pwm_generator.py

@@ -0,0 +1,71 @@
+from bluer_objects import README
+from bluer_objects.README.items import ImageItems
+from bluer_objects.README.consts import assets_url, designs_url
+
+from bluer_sbc.README.design import design_doc
+
+
+assets2 = assets_url(
+    suffix="pwm-generator",
+    volume=2,
+)
+
+marquee = README.Items(
+    [
+        {
+            "name": "pwm generator",
+            "marquee": f"{assets2}/20251116_125132.jpg",
+            "url": "./bluer_sbc/docs/pwm-generator.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {
+        designs_url(
+            "pwm-generator/wiring.png?raw=true",
+        ): designs_url(
+            "pwm-generator/wiring.svg",
+        ),
+        **{
+            f"{assets2}/{timestamp}.jpg": ""
+            for timestamp in [
+                "20251116_124854",
+                "20251116_125104",
+                "20251116_125112",
+                "20251116_125132",
+                "20251116_125140",
+                "20251116_125146",
+                "20251116_125200",
+                "20251116_125206",
+                "20251116_125212",
+            ]
+        },
+    }
+)
+
+parts = {
+    "dc-power-plug": "",
+    "dc-power-jack": "",
+    "dsn-vc288": "",
+    "plexiglass": "2 x 80 cm x 100 cm",
+    "pwm-manual-dc-motor-controller": "",
+    "nuts-bolts-spacers": "M3: ({})".format(
+        " + ".join(
+            [
+                "4 x bolt",
+                "4 x nut",
+                "4 x 40 mm spacer",
+            ]
+        )
+    ),
+}
+
+
+docs = [
+    design_doc(
+        "pwm-generator",
+        items,
+        parts,
+    )
+]

bluer_sbc/README/designs/regulated_bus.py

@@ -0,0 +1,79 @@
+from bluer_objects import README
+from bluer_objects.README.items import ImageItems
+from bluer_objects.README.consts import assets_url, designs_url
+
+from bluer_sbc.README.design import design_doc
+
+
+assets2 = assets_url(
+    suffix="regulated-bus",
+    volume=2,
+)
+
+marquee = README.Items(
+    [
+        {
+            "name": "regulated bus",
+            "marquee": f"{assets2}/20251113_113332.jpg",
+            "url": "./bluer_sbc/docs/regulated-bus.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {
+        designs_url(
+            "regulated-bus/wiring.png?raw=true",
+        ): designs_url(
+            "regulated-bus/wiring.svg",
+        ),
+        **{
+            f"{assets2}/{timestamp}.jpg": ""
+            for timestamp in [
+                "20251112_214845",
+                "20251113_103345",
+                "20251113_103404",
+                "20251113_103646",
+                "20251113_103653",
+                "20251113_103659",
+                "20251113_103703",
+                "20251113_103713",
+                "20251113_103722",
+                "20251113_104805",
+                "20251113_113332",
+                "20251116_234737",
+            ]
+        },
+    }
+)
+
+parts = {
+    "dc-power-plug": "",
+    "dsn-vc288": "",
+    "XL4015": "",
+    "white-terminal": "2 x",
+    "pin-headers": "2 x (2 x 3, 90 degree)",
+    "PCB-double-9x7": "10 x 15 holes",
+    "nuts-bolts-spacers": "M3: ({})".format(
+        " + ".join(
+            [
+                "7 x bolt",
+                "7 x nut",
+                "1 x 5 mm spacer",
+                "7 x 15 mm spacer",
+                "2 x 25 mm spacer",
+                "3 x 35 mm spacer",
+            ]
+        )
+    ),
+    "plexiglass": "2 x 88 cm x 88 cm",
+}
+
+
+docs = [
+    design_doc(
+        "regulated-bus",
+        items,
+        parts,
+    )
+]

bluer_sbc/README/designs/shelter.py

@@ -38,6 +38,9 @@ items = ImageItems(
         f"{assets2}/20251109_000641.jpg": "",
         f"{assets2}/20251109_002124.jpg": "",
         f"{assets2}/20251109_002639.jpg": "",
+        f"{assets2}/20251124_094744.jpg": "",
+        f"{assets2}/20251202_101949.jpg": "",
+        f"{assets2}/20251202_102912.jpg": "",
     }
 )
 

bluer_sbc/README/designs/swallow/__init__.py

@@ -0,0 +1,20 @@
+from bluer_objects import README
+
+from bluer_sbc.README.designs.consts import assets2
+
+latest_version: int = 6
+
+
+def image_template(version: int) -> str:
+    return assets2 + f"swallow/design/v{version}/{{}}?raw=true"
+
+
+marquee = README.Items(
+    [
+        {
+            "name": "swallow",
+            "marquee": image_template(latest_version).format("01.jpg"),
+            "url": "./bluer_sbc/docs/swallow",
+        }
+    ]
+)

bluer_sbc/README/designs/swallow/consts.py

@@ -0,0 +1,7 @@
+from bluer_objects.README.consts import assets_url
+
+
+swallow_assets2 = assets_url(
+    "swallow",
+    volume=2,
+)

bluer_sbc/README/designs/swallow/docs.py

@@ -0,0 +1,24 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.swallow import image_template
+from bluer_sbc.README.designs.swallow.parts import parts
+from bluer_sbc.README.designs.swallow import history
+from bluer_sbc.README.designs.swallow import latest_version
+
+items = ImageItems(
+    {
+        image_template(latest_version).format(f"{index+1:02}.jpg"): ""
+        for index in range(6)
+    }
+)
+
+docs = [
+    design_doc(
+        "swallow",
+        items,
+        parts,
+        own_folder=True,
+        parts_reference="../parts",
+    )
+] + history.docs

bluer_sbc/README/designs/swallow/history.py

@@ -0,0 +1,34 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.swallow.consts import swallow_assets2
+from bluer_sbc.README.designs.swallow import image_template, latest_version
+from bluer_sbc.README.designs.swallow.parts import parts
+
+docs = [
+    design_doc(
+        "swallow/v1",
+        ImageItems(
+            {
+                f"{swallow_assets2}/20250609_164433.jpg": "",
+                f"{swallow_assets2}/20250614_114954.jpg": "",
+                f"{swallow_assets2}/20250615_192339.jpg": "",
+            }
+        ),
+        parts,
+    )
+] + [
+    design_doc(
+        f"swallow/v{version}",
+        ImageItems(
+            {
+                image_template(version).format(
+                    f"{index+1:02}.jpg",
+                ): ""
+                for index in range(6)
+            }
+        ),
+        parts,
+    )
+    for version in range(2, latest_version)
+]

bluer_sbc/README/designs/swallow/parts.py

@@ -0,0 +1,16 @@
+parts = {
+    "BTS7960": "2 x",
+    "connector": "2 females",
+    "white-terminal": "8 x",
+    "nuts-bolts-spacers": "M3: ({})".format(
+        " + ".join(
+            [
+                "4 x nut",
+                "8 x 25 mm spacer",
+                "4 x 30 mm spacer",
+            ]
+        )
+    ),
+    "solid-cable-1-15": "20 cm x (red + black/blue)",
+    "PCB-single-14x9_5": "",
+}

bluer_sbc/README/designs/swallow_head/__init__.py

@@ -0,0 +1,22 @@
+from bluer_objects import README
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.consts import assets2
+
+
+latest_version: int = 2
+
+
+def image_template(version: int) -> str:
+    return assets2 + f"swallow/design/head-v{version}/{{}}?raw=true"
+
+
+marquee = README.Items(
+    [
+        {
+            "name": "swallow head",
+            "marquee": image_template(latest_version).format("01.jpg"),
+            "url": "./bluer_sbc/docs/swallow-head",
+        }
+    ]
+)

bluer_sbc/README/designs/swallow_head/docs.py

@@ -0,0 +1,24 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.swallow_head import image_template
+from bluer_sbc.README.designs.swallow_head.parts import parts
+from bluer_sbc.README.designs.swallow_head import history
+from bluer_sbc.README.designs.swallow_head import latest_version
+
+items = ImageItems(
+    {
+        image_template(latest_version).format(f"{index+1:02}.jpg"): ""
+        for index in range(6)
+    }
+)
+
+docs = [
+    design_doc(
+        "swallow-head",
+        items,
+        parts,
+        own_folder=True,
+        parts_reference="../parts",
+    )
+] + history.docs

bluer_sbc/README/designs/swallow_head/history.py

@@ -0,0 +1,21 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.swallow_head import image_template, latest_version
+from bluer_sbc.README.designs.swallow_head.parts import parts
+
+docs = [
+    design_doc(
+        f"swallow-head/v{version}",
+        ImageItems(
+            {
+                image_template(version).format(
+                    f"{index+1:02}.jpg",
+                ): ""
+                for index in range(6)
+            }
+        ),
+        parts,
+    )
+    for version in range(1, latest_version)
+]

bluer_sbc/README/designs/{swallow_head.py → swallow_head/parts.py}

@@ -1,26 +1,3 @@
-from bluer_objects import README
-from bluer_objects.README.items import ImageItems
-
-from bluer_sbc.README.designs.consts import assets2
-from bluer_sbc.README.design import design_doc
-
-
-image_template = assets2 + "swallow/design/head-v1/{}?raw=true"
-
-marquee = README.Items(
-    [
-        {
-            "name": "swallow head",
-            "marquee": image_template.format("01.jpg"),
-            "url": "./bluer_sbc/docs/swallow-head.md",
-        }
-    ]
-)
-
-items = ImageItems(
-    {image_template.format(f"{index+1:02}.jpg"): "" for index in range(6)}
-)
-
 parts = {
     "sd-card-32-gb": "",
     "rpi": "",
@@ -28,11 +5,10 @@ parts = {
     "470-mF": "",
     "Polyfuse": "optional",
     "TVS-diode": "",
-    "resistor": "7 x 330-470 Ω + N x 2.2 kΩ + N x 3.3 kΩ",
+    "resistor": "7 x 330-470 Ω + 4 x 2.2 kΩ + 4 x 3.3 kΩ",
     "LED": "green + red + yellow + 4 x blue",
     "rpi-camera": "",
-    "PCB-single-14x9_5": "2 x",
-    "PCB-double-9x7": "2 x",
+    "PCB-single-14x9_5": "",
     "pushbutton": "",
     "ultrasonic-sensor": "4 x",
     "connector": "1 female",
@@ -42,8 +18,8 @@ parts = {
                 " + ".join(
                     [
                         "2 x bolt",
-                        "2 x 5 mm spacer",
                         "4 x nut",
+                        "2 x 5 mm spacer",
                     ]
                 )
             ),
@@ -51,8 +27,8 @@ parts = {
                 " + ".join(
                     [
                         "4 x bolt",
-                        "8 x 10 mm spacer",
                         "4 x nut",
+                        "8 x 10 mm spacer",
                     ]
                 )
             ),
@@ -60,30 +36,20 @@ parts = {
                 " + ".join(
                     [
                         "1 x bolt",
-                        "3 x 35 mm spacer",
-                        "3 x 25 mm spacer",
-                        "7 x 15 mm spacer",
-                        "4 x 5 mm spacer",
                         "5 x nut",
+                        "5 x 25 mm spacer",
+                        "8 x 15 mm spacer",
+                        "4 x 5 mm spacer",
                     ]
                 )
             ),
         ]
     ),
     "plexiglass": "14 cm x 9.5 cm",
-    "white-terminal": "2 x",
+    "green-terminal": "2 x",
     "dupont-cables": "1 x 30 cm + 1 x 10 cm",
     "16-awg-wire": "40 cm x (red + black/blue)",
     "solid-cable-1-15": "10 cm x (red + black/blue)",
     "strong-thread": "1 m",
-    "pin-headers": "1 x (female, 2 x 40) -> 2 x 20 + 2 x (male, 1 x 40) -> 4 x 6 + 4 x 2 + 2 x 20",
+    "pin-headers": "1 x (female, 2 x 40) -> 2 x 20 + 2 x (male, 1 x 40) -> 4 x 1 + 2 x 20 + 1 x (male, 2 x 40) -> 2 x 2 x 6",
 }
-
-
-docs = [
-    design_doc(
-        "swallow-head",
-        items,
-        parts,
-    )
-]

bluer_sbc/README/root.py

@@ -1,12 +1,14 @@
-from bluer_sbc.README.designs.cheshmak import marquee as cheshmak_marquee
+from bluer_sbc.README.designs.adapter_bus import marquee as adapter_bus_marquee
+from bluer_sbc.README.designs.anchor import marquee as anchor_marquee
+from bluer_sbc.README.designs.battery_bus import marquee as battery_bus_marquee
 from bluer_sbc.README.designs.blue_bracket import items as blue_bracket_items
-from bluer_sbc.README.designs.swallow import marquee as swallow_marquee
-from bluer_sbc.README.designs.swallow_head import marquee as swallow_head_marquee
-from bluer_sbc.README.designs.bryce import marquee as bryce_marquee
 from bluer_sbc.README.designs.nafha import marquee as nafha_marquee
+from bluer_sbc.README.designs.cheshmak import marquee as cheshmak_marquee
+from bluer_sbc.README.designs.pwm_generator import marquee as pwm_generator_marquee
+from bluer_sbc.README.designs.regulated_bus import marquee as regulated_bus_marquee
 from bluer_sbc.README.designs.shelter import marquee as shelter_marquee
-from bluer_sbc.README.designs.adapter_bus import marquee as adapter_bus_marquee
-from bluer_sbc.README.designs.battery_bus import marquee as battery_bus_marquee
+from bluer_sbc.README.designs.swallow import marquee as swallow_marquee
+from bluer_sbc.README.designs.swallow_head import marquee as swallow_head_marquee
 from bluer_sbc.README.designs.ultrasonic_sensor_tester import (
     marquee as ultrasonic_sensor_tester_marquee,
 )
@@ -17,10 +19,12 @@ docs = [
         "items": []
         + swallow_head_marquee
         + swallow_marquee
+        + anchor_marquee
+        + pwm_generator_marquee
+        + regulated_bus_marquee
         + battery_bus_marquee
         + adapter_bus_marquee
         + ultrasonic_sensor_tester_marquee
-        + bryce_marquee
         + cheshmak_marquee
         + nafha_marquee
         + shelter_marquee

bluer_sbc/__init__.py

@@ -4,7 +4,7 @@ ICON = "🌀"
 
 DESCRIPTION = f"{ICON} AI for single board computers and related designs."
 
-VERSION = "9.168.1"
+VERSION = "9.319.1"
 
 REPO_NAME = "bluer-sbc"
 

bluer_sbc/help/parts.py

@@ -15,7 +15,7 @@ def help_cd(
             "parts",
             "cd",
         ],
-        "cd to part images.",
+        "cd to part images folder.",
         mono=mono,
     )
 
@@ -43,7 +43,39 @@ def help_adjust(
     )
 
 
+def help_edit(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@sbc",
+            "parts",
+            "edit",
+        ],
+        "edit parts db.",
+        mono=mono,
+    )
+
+
+def help_open(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@sbc",
+            "parts",
+            "open",
+        ],
+        "open part images folder.",
+        mono=mono,
+    )
+
+
 help_functions = {
     "adjust": help_adjust,
     "cd": help_cd,
+    "edit": help_edit,
+    "open": help_open,
 }