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

bluer_sbc/.abcli/sbc/parts/edit.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts_edit() {
+    bluer_ai_code $abcli_path_git/bluer-sbc/bluer_sbc/parts/db.py
+}

bluer_sbc/.abcli/sbc/parts/open.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts_open() {
+    open $abcli_path_git/assets2/bluer-sbc/parts
+}

bluer_sbc/.abcli/sbc/parts.sh

@@ -1,7 +1,7 @@
 #! /usr/bin/env bash
 
 function bluer_sbc_parts() {
-    local task=$1
+    local task=${1:-open}
 
     local function_name=bluer_sbc_parts_$task
     if [[ $(type -t $function_name) == "function" ]]; then

bluer_sbc/.abcli/seed/rpi_64_bit.sh

@@ -0,0 +1,36 @@
+#! /usr/bin/env bash
+
+# internal function to bluer_ai_seed.
+# seed is NOT local
+function bluer_ai_seed_rpi_64_bit() {
+    bluer_ai_seed add_kaggle
+
+    bluer_ai_seed add_ssh_key sudo
+
+    seed="${seed}sudo apt-get --yes --force-yes install git$delim_section"
+
+    bluer_ai_seed add_repo
+
+    bluer_ai_seed add_bluer_ai_env_ssp
+
+    local ssp="--break-system-packages"
+
+    seed="${seed}sudo apt update$delim"
+    seed="${seed}sudo apt install -y python3-pip mpv vlc-bin$delim"
+    seed="${seed}pip3 install $ssp -e .$delim_section"
+
+    bluer_ai_seed add_repo repo=bluer-objects
+    seed="${seed}pip3 install $ssp -e .$delim_section"
+    seed="${seed}$(bluer_ai_seed add_file $abcli_path_git/bluer-objects/.env \$HOME/git/bluer-objects/.env)$delim_section"
+
+    bluer_ai_seed add_repo repo=bluer-sbc
+    seed="${seed}pip3 install $ssp -e .$delim_section"
+
+    seed="${seed}pip3 install $ssp opencv-python$delim"
+    seed="${seed}sudo apt install -y python3-picamera2$delim"
+    seed="${seed}pip3 install --force-reinstall --no-cache-dir simplejpeg$delim"
+    seed="${seed}pip3 install $ssp evdev$delim_section"
+
+    seed="${seed}cd; cd git; cd bluer-ai$delim"
+    seed="${seed}source ./bluer_ai/.abcli/bluer_ai.sh$delim_section"
+}

bluer_sbc/.abcli/tests/help.sh

@@ -28,6 +28,8 @@ function test_bluer_sbc_help() {
         "@sbc parts" \
         "@sbc parts adjust" \
         "@sbc parts cd" \
+        "@sbc parts edit" \
+        "@sbc parts open" \
         \
         "@sbc pypi" \
         "@sbc pypi browse" \

bluer_sbc/README/design.py

@@ -1,36 +1,52 @@
-from typing import List, Dict
+from typing import Dict, List, Any
 
 from bluer_objects import markdown
 
 from bluer_sbc.parts.db import db_of_parts
 
 
-def design(
-    items: List[str],
+def design_doc(
+    design_name: str,
+    items: List[str] = [],
     dict_of_parts: Dict = {},
-    macros: Dict = {},
-) -> Dict:
-    output = {
+    macros: Dict[str, Dict] = {},
+    own_folder: bool = False,
+    parts_reference: str = "./parts",
+    cols: int = 3,
+) -> Dict[str, Any]:
+    macros_ = {}
+    if dict_of_parts:
+        macros_ = design_doc_parts(
+            dict_of_parts,
+            parts_reference,
+        )
+
+    macros_.update(macros)
+
+    return {
+        "path": "../docs/{}{}".format(design_name, "" if own_folder else ".md"),
+        "cols": cols,
         "items": items,
+        "macros": macros_,
     }
 
-    if dict_of_parts:
-        output["macros"] = {
-            "parts_images:::": markdown.generate_table(
-                db_of_parts.as_images(
-                    dict_of_parts,
-                    reference="./parts",
-                ),
-                cols=10,
-                log=False,
-            ),
-            "parts_list:::": db_of_parts.as_list(
+
+def design_doc_parts(
+    dict_of_parts: Dict,
+    parts_reference: str = "./parts",
+) -> Dict[str, Dict]:
+    return {
+        "parts_images:::": markdown.generate_table(
+            db_of_parts.as_images(
                 dict_of_parts,
-                reference="./parts",
-                log=False,
+                reference=parts_reference,
             ),
-        }
-
-        output["macros"].update(macros)
-
-    return output
+            cols=10,
+            log=False,
+        ),
+        "parts_list:::": db_of_parts.as_list(
+            dict_of_parts,
+            reference=parts_reference,
+            log=False,
+        ),
+    }

bluer_sbc/README/designs/__init__.py

@@ -1,56 +1,30 @@
-from bluer_sbc.README.design import design
-from bluer_sbc.README.designs.cheshmak import items as cheshmak_items
-from bluer_sbc.README.designs.battery_bus import items as battery_bus_items
-from bluer_sbc.README.designs.swallow import items as swallow_items
-from bluer_sbc.README.designs.swallow_head import items as swallow_head_items
-from bluer_sbc.README.designs.bryce import items as bryce_items
-from bluer_sbc.README.designs.nafha import items as nafha_items
-from bluer_sbc.README.designs.shelter import items as shelter_items
-from bluer_sbc.README.designs.x import items as x_items
-from bluer_sbc.README.designs.ultrasonic_sensor_tester import (
-    items as ultrasonic_sensor_tester_items,
+from bluer_sbc.README.designs import (
+    adapter_bus,
+    nafha,
+    pwm_generator,
+    regulated_bus,
+    shelter,
+    template,
+    ultrasonic_sensor_tester,
 )
+from bluer_sbc.README.designs.anchor import docs as anchor
+from bluer_sbc.README.designs.battery_bus import docs as battery_bus
+from bluer_sbc.README.designs.cheshmak import docs as cheshmak
+from bluer_sbc.README.designs.swallow import docs as swallow
+from bluer_sbc.README.designs.swallow_head import docs as swallow_head
 
-from bluer_sbc.designs.battery_bus.parts import dict_of_parts as battery_bus_parts
-from bluer_sbc.designs.swallow.parts import dict_of_parts as swallow_parts
-from bluer_sbc.designs.swallow_head.parts import dict_of_parts as swallow_head_parts
 
-docs = [
-    {
-        "items": design_info["items"],
-        "path": f"../docs/{design_name}.md",
-        "macros": design_info.get("macros", {}),
-    }
-    for design_name, design_info in {
-        "battery-bus": design(
-            battery_bus_items,
-            battery_bus_parts,
-        ),
-        "bryce": design(
-            bryce_items,
-        ),
-        "cheshmak": design(
-            cheshmak_items,
-        ),
-        "nafha": design(
-            nafha_items,
-        ),
-        "shelter": design(
-            shelter_items,
-        ),
-        "swallow-head": design(
-            swallow_head_items,
-            swallow_head_parts,
-        ),
-        "swallow": design(
-            swallow_items,
-            swallow_parts,
-        ),
-        "ultrasonic-sensor-tester": design(
-            ultrasonic_sensor_tester_items,
-        ),
-        "x": design(
-            x_items,
-        ),
-    }.items()
-]
+docs = (
+    adapter_bus.docs
+    + anchor.docs
+    + battery_bus.docs
+    + cheshmak.docs
+    + nafha.docs
+    + pwm_generator.docs
+    + regulated_bus.docs
+    + shelter.docs
+    + swallow_head.docs
+    + swallow.docs
+    + ultrasonic_sensor_tester.docs
+    + template.docs
+)

bluer_sbc/README/designs/adapter_bus.py

@@ -0,0 +1,59 @@
+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="adapter-bus",
+    volume=2,
+)
+
+marquee = README.Items(
+    [
+        {
+            "name": "adapter bus",
+            "marquee": f"{assets2}/20251017_222911.jpg",
+            "url": "./bluer_sbc/docs/adapter-bus.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {
+        designs_url(
+            "adapter-bus/wiring.png?raw=true",
+        ): designs_url(
+            "adapter-bus/wiring.svg",
+        ),
+        **{
+            f"{assets2}/{timestamp}.jpg": ""
+            for timestamp in [
+                "20251017_222911",
+                "20251017_222929",
+                "20251017_222938",
+                "20251017_222943",
+                "20251017_222949",
+                "20251017_223017",
+                "20251017_223034",
+                "20251018_213244",
+            ]
+        },
+    }
+)
+
+parts = {
+    "dc-power-plug": "",
+    "dsn-vc288": "",
+    "dc-power-jack": "",
+}
+
+
+docs = [
+    design_doc(
+        "adapter-bus",
+        items,
+        parts,
+    )
+]

bluer_sbc/README/designs/anchor/__init__.py

@@ -0,0 +1,15 @@
+from bluer_objects import README
+
+from bluer_sbc.README.designs.consts import assets2
+
+image_template = assets2 + "anchor/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "anchor",
+            "marquee": image_template.format("20251204_144037.jpg"),
+            "url": "./bluer_sbc/docs/anchor",
+        }
+    ]
+)

bluer_sbc/README/designs/anchor/body/docs.py

@@ -0,0 +1,20 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.anchor import image_template
+
+docs = [
+    {
+        "path": "../docs/anchor/body",
+        "items": ImageItems(
+            {
+                image_template.format("20251204_144010.jpg"): "",
+                image_template.format("20251204_144014.jpg"): "",
+                image_template.format("20251204_144017.jpg"): "",
+                image_template.format("20251204_144021.jpg"): "",
+                image_template.format("20251204_144024.jpg"): "",
+                image_template.format("20251204_144031.jpg"): "",
+                image_template.format("20251204_144037.jpg"): "",
+            }
+        ),
+    }
+]

bluer_sbc/README/designs/anchor/docs.py

@@ -0,0 +1,16 @@
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.anchor import parts
+from bluer_sbc.README.designs.anchor.body import docs as body
+from bluer_sbc.README.designs.anchor.items import items
+
+docs = (
+    [
+        design_doc(
+            "anchor",
+            items,
+            own_folder=True,
+        )
+    ]
+    + body.docs
+    + parts.docs
+)

bluer_sbc/README/designs/anchor/items.py

@@ -0,0 +1,10 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.anchor import image_template
+
+items = ImageItems(
+    {
+        image_template.format("03.png"): "",
+        image_template.format("20251204_144037.jpg"): "",
+    }
+)

bluer_sbc/README/designs/anchor/parts.py

@@ -0,0 +1,54 @@
+from bluer_sbc.README.design import design_doc_parts
+
+parts = {
+    "sd-card-32-gb": "",
+    "rpi": "",
+    "XL4015": "",
+    "470-mF": "",
+    "Polyfuse": "optional",
+    "TVS-diode": "",
+    "resistor": "7 x 330-470 Ω + 4 x 2.2 kΩ + 4 x 3.3 kΩ",
+    "LED": "green + red + yellow + 4 x blue",
+    "PCB-single-14x9_5": "",
+    "pushbutton": "",
+    "connector": "1 female",
+    "nuts-bolts-spacers": " + ".join(
+        [
+            "M2.5: ({})".format(
+                " + ".join(
+                    [
+                        "4 x bolt",
+                        "4 x nut",
+                        "8 x 10 mm spacer",
+                    ]
+                )
+            ),
+            "M3: ({})".format(
+                " + ".join(
+                    [
+                        "1 x bolt",
+                        "5 x nut",
+                        "4 x 5 mm spacer",
+                        "5 x 15 mm spacer",
+                        "4 x 25 mm spacer",
+                    ]
+                )
+            ),
+        ]
+    ),
+    "plexiglass": "14 cm x 9.5 cm",
+    "green-terminal": "2 x",
+    "16-awg-wire": "40 cm x (red + black/blue)",
+    "solid-cable-1-15": "10 cm x (red + black/blue)",
+    "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 = [
+    {
+        "path": "../docs/anchor/parts.md",
+        "macros": design_doc_parts(
+            dict_of_parts=parts,
+            parts_reference="../parts",
+        ),
+    }
+]

bluer_sbc/README/designs/battery_bus/__init__.py

@@ -0,0 +1,15 @@
+from bluer_objects import README
+
+from bluer_sbc.README.designs.consts import assets2
+
+image_template = assets2 + "battery-bus/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "battery bus",
+            "marquee": image_template.format("20251007_221902.jpg"),
+            "url": "./bluer_sbc/docs/battery_bus",
+        }
+    ]
+)

bluer_sbc/README/designs/battery_bus/body/docs.py

@@ -0,0 +1,20 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.battery_bus import image_template
+from bluer_sbc.README.designs.battery_bus.body import li_ion, sla
+
+docs = (
+    [
+        {
+            "path": "../docs/battery_bus/body",
+            "items": ImageItems(
+                {
+                    image_template.format("20251007_221902.jpg"): "./sla.md",
+                    image_template.format("li-ion/20251204_144045.jpg"): "./li-ion.md",
+                }
+            ),
+        },
+    ]
+    + li_ion.docs
+    + sla.docs
+)

bluer_sbc/README/designs/battery_bus/body/li_ion.py

@@ -0,0 +1,20 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.battery_bus import image_template
+
+docs = [
+    {
+        "path": "../docs/battery_bus/body/li-ion.md",
+        "items": ImageItems(
+            {
+                image_template.format("li-ion/20251204_143912.jpg"): "",
+                image_template.format("li-ion/20251204_143924.jpg"): "",
+                image_template.format("li-ion/20251204_143931.jpg"): "",
+                image_template.format("li-ion/20251204_143944.jpg"): "",
+                image_template.format("li-ion/20251204_143949.jpg"): "",
+                image_template.format("li-ion/20251204_143958.jpg"): "",
+                image_template.format("li-ion/20251204_144045.jpg"): "",
+            }
+        ),
+    }
+]

bluer_sbc/README/designs/battery_bus/body/sla.py

@@ -0,0 +1,17 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.battery_bus import image_template
+
+docs = [
+    {
+        "path": "../docs/battery_bus/body/sla.md",
+        "items": ImageItems(
+            {
+                image_template.format("20251007_221902.jpg"): "",
+                image_template.format("20251007_220642.jpg"): "",
+                image_template.format("20251007_220520.jpg"): "",
+                image_template.format("20251007_220601.jpg"): "",
+            }
+        ),
+    }
+]

bluer_sbc/README/designs/battery_bus/docs.py

@@ -0,0 +1,17 @@
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.battery_bus import parts
+from bluer_sbc.README.designs.battery_bus.items import items
+from bluer_sbc.README.designs.battery_bus.body import docs as body
+
+docs = (
+    [
+        design_doc(
+            "battery_bus",
+            items,
+            own_folder=True,
+            cols=2,
+        )
+    ]
+    + body.docs
+    + parts.docs
+)

bluer_sbc/README/designs/battery_bus/items.py

@@ -0,0 +1,17 @@
+from bluer_objects.README.items import ImageItems
+from bluer_objects.README.consts import designs_url
+
+from bluer_sbc.README.designs.battery_bus import image_template
+
+items = ImageItems(
+    {
+        image_template.format("concept.png"): "",
+        designs_url(
+            "battery-bus/electrical/wiring.png?raw=true",
+        ): designs_url(
+            "battery-bus/electrical/wiring.svg",
+        ),
+        image_template.format("20251007_221902.jpg"): "./body/sla.md",
+        image_template.format("li-ion/20251204_144045.jpg"): "./body/li-ion.md",
+    }
+)

bluer_sbc/README/designs/battery_bus/parts.py

@@ -0,0 +1,19 @@
+from bluer_sbc.README.design import design_doc_parts
+
+parts = {
+    "SLA-Battery": "e.g. 12 V, 7.2 Ah",
+    "Li-Ion-Battery": "e.g. 3 x 26650, 5000 mAh 5C, 3.7 V/4.2V",
+    "dc-switch": "12V DC 10 A",
+    "dc-power-plug": "",
+    "dsn-vc288": "",
+}
+
+docs = [
+    {
+        "path": "../docs/battery_bus/parts.md",
+        "macros": design_doc_parts(
+            dict_of_parts=parts,
+            parts_reference="../parts",
+        ),
+    }
+]

bluer_sbc/README/designs/cheshmak/__init__.py

@@ -0,0 +1,14 @@
+from bluer_objects import README
+from bluer_sbc.README.designs.consts import assets2
+
+image_template = assets2 + "cheshmak/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "cheshmak",
+            "marquee": image_template.format("20251203_190131.jpg"),
+            "url": "./bluer_sbc/docs/cheshmak",
+        }
+    ]
+)

bluer_sbc/README/designs/cheshmak/body/docs.py

@@ -0,0 +1,23 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.cheshmak import image_template
+from bluer_sbc.README.designs.cheshmak.body import v1
+
+docs = [
+    {
+        "path": "../docs/cheshmak/body",
+        "items": ImageItems(
+            {
+                image_template.format("20251203_184658.jpg"): "",
+                image_template.format("20251203_184702.jpg"): "",
+                image_template.format("20251203_184706.jpg"): "",
+                image_template.format("20251203_184712.jpg"): "",
+                image_template.format("20251203_184717.jpg"): "",
+                image_template.format("20251203_184723.jpg"): "",
+                image_template.format("20251203_190023.jpg"): "",
+                image_template.format("20251203_190131.jpg"): "",
+                image_template.format("20251203_190344.jpg"): "",
+            }
+        ),
+    }
+] + v1.docs

bluer_sbc/README/designs/cheshmak/body/v1.py

@@ -0,0 +1,18 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.consts import assets2
+
+
+docs = [
+    {
+        "path": "../docs/cheshmak/body/v1.md",
+        "items": ImageItems(
+            {
+                **{
+                    (assets2 + "bryce/{}?raw=true").format(f"{index+1:02}.jpg"): ""
+                    for index in range(8)
+                }
+            }
+        ),
+    },
+]

bluer_sbc/README/designs/cheshmak/docs.py

@@ -0,0 +1,19 @@
+from bluer_sbc.README.design import design_doc
+from bluer_sbc.README.designs.cheshmak import operation, parts, validations
+from bluer_sbc.README.designs.cheshmak.items import items
+from bluer_sbc.README.designs.cheshmak.body import docs as body
+
+
+docs = (
+    [
+        design_doc(
+            "cheshmak",
+            items,
+            own_folder=True,
+        ),
+    ]
+    + body.docs
+    + operation.docs
+    + parts.docs
+    + validations.docs
+)

bluer_sbc/README/designs/cheshmak/items.py

@@ -0,0 +1,10 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_sbc.README.designs.cheshmak import image_template
+
+items = ImageItems(
+    {
+        image_template.format("01.png"): "",
+        image_template.format("20251203_190023.jpg"): "",
+    }
+)

bluer_sbc/README/designs/cheshmak/operation.py

@@ -0,0 +1,5 @@
+docs = [
+    {
+        "path": "../docs/cheshmak/operation.md",
+    },
+]