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

bluer_sbc/.abcli/actions.sh

@@ -4,6 +4,9 @@ function bluer_sbc_action_git_before_push() {
     bluer_sbc build_README
     [[ $? -ne 0 ]] && return 1
 
+    bluer_sbc parts adjust ~grid
+    [[ $? -ne 0 ]] && return 1
+
     [[ "$(bluer_ai_git get_branch)" != "main" ]] &&
         return 0
 

bluer_sbc/.abcli/alias.sh

@@ -2,8 +2,8 @@
 
 alias @camera=bluer_sbc_camera
 
-alias grove=bluer_sbc_grove
+alias @designs=bluer-designs
 
-alias @rpi=bluer_sbc_rpi
+alias grove=bluer_sbc_grove
 
 alias @sbc=bluer_sbc

bluer_sbc/.abcli/{blue_sbc.sh → bluer_sbc.sh}

@@ -9,3 +9,5 @@ function bluer_sbc() {
 }
 
 bluer_ai_log $(bluer_sbc version --show_icon 1)
+
+bluer_ai_source_caller_suffix_path /sbc

bluer_sbc/.abcli/rpi.sh

@@ -9,7 +9,7 @@ function bluer_sbc_rpi() {
         return
     fi
 
-    bluer_ai_log_error "@rpi: $task: command not found."
+    bluer_ai_log_error "@sbc rpi: $task: command not found."
     return 1
 }
 

bluer_sbc/.abcli/sbc/parts/adjust.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts_adjust() {
+    local options=$1
+    local do_dryrun=$(bluer_ai_option_int "$options" dryrun 0)
+    local generate_grid=$(bluer_ai_option_int "$options" grid 1)
+
+    bluer_ai_eval - \
+        python3 -m bluer_sbc.parts \
+        adjust \
+        --dryrun $do_dryrun \
+        --generate_grid $generate_grid \
+        "${@:2}"
+}

bluer_sbc/.abcli/sbc/parts/cd.sh

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

bluer_sbc/.abcli/sbc/parts.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts() {
+    local task=$1
+
+    local function_name=bluer_sbc_parts_$task
+    if [[ $(type -t $function_name) == "function" ]]; then
+        $function_name "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_sbc.parts "$@"
+}
+
+bluer_ai_source_caller_suffix_path /parts

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$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

@@ -5,9 +5,6 @@ function test_bluer_sbc_help() {
 
     local module
     for module in \
-        "@rpi" \
-        "@rpi fake_display" \
-        \
         "@sbc" \
         \
         "@sbc adafruit_rgb_matrix" \
@@ -28,6 +25,10 @@ function test_bluer_sbc_help() {
         "@sbc lepton capture" \
         "@sbc lepton preview" \
         \
+        "@sbc parts" \
+        "@sbc parts adjust" \
+        "@sbc parts cd" \
+        \
         "@sbc pypi" \
         "@sbc pypi browse" \
         "@sbc pypi build" \
@@ -35,6 +36,9 @@ function test_bluer_sbc_help() {
         \
         "@sbc pytest" \
         \
+        "@sbc rpi" \
+        "@sbc rpi fake_display" \
+        \
         "@sbc scroll_phat_hd" \
         "@sbc scroll_phat_hd validate" \
         \

bluer_sbc/.abcli/tests/parts_adjust.sh

@@ -0,0 +1,13 @@
+#! /usr/bin/env bash
+
+function test_bluer_sbc_parts_adjust() {
+    local options=$1
+
+    [[ "$abcli_is_github_workflow" == true ]] &&
+        return 0
+
+    bluer_ai_eval ,$options \
+        bluer_sbc_parts_adjust \
+        - \
+        --verbose 1
+}

bluer_sbc/README/aliases.py

@@ -0,0 +1,11 @@
+docs = [
+    {
+        "path": f"../docs/aliases/{item}.md",
+    }
+    for item in [
+        "camera",
+        "hardware",
+        "rpi",
+        "sbc",
+    ]
+]

bluer_sbc/README/build.py

@@ -0,0 +1,29 @@
+import os
+
+from bluer_options.help.functions import get_help
+from bluer_objects import file, README
+
+from bluer_sbc import NAME, VERSION, ICON, REPO_NAME
+from bluer_sbc.help.functions import help_functions
+from bluer_sbc.README import aliases, designs, parts, root
+
+
+def build():
+    return all(
+        README.build(
+            items=readme.get("items", []),
+            cols=readme.get("cols", 3),
+            path=os.path.join(file.path(__file__), readme["path"]),
+            ICON=ICON,
+            NAME=NAME,
+            VERSION=VERSION,
+            REPO_NAME=REPO_NAME,
+            help_function=lambda tokens: get_help(
+                tokens,
+                help_functions,
+                mono=True,
+            ),
+            macros=readme.get("macros", {}),
+        )
+        for readme in root.docs + parts.docs + designs.docs + aliases.docs
+    )

bluer_sbc/README/design.py

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

bluer_sbc/README/designs/__init__.py

@@ -0,0 +1,26 @@
+from bluer_sbc.README.designs import (
+    cheshmak,
+    battery_bus,
+    adapter_bus,
+    swallow,
+    swallow_head,
+    bryce,
+    nafha,
+    shelter,
+    template,
+    ultrasonic_sensor_tester,
+)
+
+
+docs = (
+    battery_bus.docs
+    + adapter_bus.docs
+    + bryce.docs
+    + cheshmak.docs
+    + nafha.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 = {
+    "charging-port": "",
+    "dsn-vc288": "",
+    "charger-socket": "",
+}
+
+
+docs = [
+    design_doc(
+        "adapter-bus",
+        items,
+        parts,
+    )
+]

bluer_sbc/README/designs/battery_bus.py

@@ -0,0 +1,52 @@
+from bluer_objects import README
+from bluer_objects.README.items import ImageItems
+from bluer_objects.README.consts import assets_url
+from bluer_objects.README.consts import designs_url
+
+from bluer_sbc.README.design import design_doc
+
+assets2 = assets_url(
+    suffix="battery-bus",
+    volume=2,
+)
+
+marquee = README.Items(
+    [
+        {
+            "name": "battery bus",
+            "marquee": f"{assets2}/20251007_221902.jpg",
+            "url": "./bluer_sbc/docs/battery-bus.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {
+        f"{assets2}/concept.png": "",
+        designs_url(
+            "battery-bus/electrical/wiring.png?raw=true",
+        ): designs_url(
+            "battery-bus/electrical/wiring.svg",
+        ),
+        f"{assets2}/20251007_221902.jpg": "",
+        f"{assets2}/20251007_220642.jpg": "",
+        f"{assets2}/20251007_220520.jpg": "",
+        f"{assets2}/20251007_220601.jpg": "",
+    }
+)
+
+parts = {
+    "SLA-Battery": "",
+    "on-off-switch": "",
+    "charging-port": "",
+    "dsn-vc288": "",
+}
+
+
+docs = [
+    design_doc(
+        "battery-bus",
+        items,
+        parts,
+    )
+]

bluer_sbc/README/designs/bryce.py

@@ -0,0 +1,28 @@
+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 + "bryce/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "bryce",
+            "marquee": image_template.format("08.jpg"),
+            "url": "./bluer_sbc/docs/bryce.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {image_template.format(f"{index+1:02}.jpg"): "" for index in range(9)}
+)
+
+docs = [
+    design_doc(
+        "bryce",
+        items,
+    )
+]

bluer_sbc/README/designs/cheshmak.py

@@ -0,0 +1,29 @@
+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 + "cheshmak/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "cheshmak",
+            "marquee": image_template.format("01.png"),
+            "url": "./bluer_sbc/docs/cheshmak.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {image_template.format(f"{index+1:02}.png"): "" for index in range(1)}
+)
+
+
+docs = [
+    design_doc(
+        "cheshmak",
+        items,
+    )
+]

bluer_sbc/README/designs/nafha.py

@@ -0,0 +1,57 @@
+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 + "nafha/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "nafha",
+            "marquee": image_template.format("01.png"),
+            "url": "./bluer_sbc/docs/nafha",
+        }
+    ]
+)
+
+items = ImageItems(
+    {
+        image_template.format(f"{filename}"): ""
+        for filename in [f"{index+1:02}.png" for index in range(4)]
+        + [
+            "20251028_123428.jpg",
+            "20251028_123438.jpg",
+            "20251103_215221.jpg",
+            "20251103_215248.jpg",
+            "20251103_215253.jpg",
+            "20251103_215257.jpg",
+            "20251103_215301.jpg",
+            "20251103_215319.jpg",
+        ]
+    },
+)
+
+parts = {
+    "dsn-vc288": "",
+    "charging-port": "",
+    "pwm-manual-dc-motor-controller": "",
+    "heater-element": "12 V, 4.5 Ω, 32 w",
+}
+
+docs = [
+    design_doc(
+        "nafha",
+        items,
+        parts,
+        own_folder=True,
+        parts_reference="../parts",
+    ),
+    {
+        "path": "../docs/nafha/parts-v1.md",
+    },
+    {
+        "path": "../docs/nafha/parts-v2.md",
+    },
+]

bluer_sbc/README/designs/shelter.py

@@ -0,0 +1,63 @@
+from bluer_objects import README
+from bluer_objects.README.items import ImageItems
+from bluer_objects.README.consts import assets_url
+
+from bluer_sbc.README.design import design_doc
+
+
+assets2 = assets_url(
+    suffix="shelter",
+    volume=2,
+)
+
+image_template = assets2 + "/{}?raw=true"
+
+
+marquee = README.Items(
+    [
+        {
+            "name": "shelter",
+            "marquee": f"{assets2}/20251104_000755.jpg",
+            "url": "./bluer_sbc/docs/shelter",
+        }
+    ]
+)
+
+items = ImageItems(
+    {image_template.format(f"{index+1:02}.png"): "" for index in range(4)}
+) + ImageItems(
+    {
+        f"{assets2}/20251005_180841.jpg": "",
+        f"{assets2}/20251006_181432.jpg": "",
+        f"{assets2}/20251006_181509.jpg": "",
+        f"{assets2}/20251006_181554.jpg": "",
+        f"{assets2}/20251028_113245.jpg": "",
+        f"{assets2}/20251103_182323.jpg": "",
+        f"{assets2}/20251104_000755.jpg": "",
+        f"{assets2}/20251109_000501.jpg": "",
+        f"{assets2}/20251109_000641.jpg": "",
+        f"{assets2}/20251109_002124.jpg": "",
+        f"{assets2}/20251109_002639.jpg": "",
+    }
+)
+
+parts = {
+    "220VAC-dimmer": "",
+    "resistance-heating-wire": "1.59 kΩ",
+    "ceramic-terminal": "",
+    "mountable-digital-thermometer": "",
+}
+
+
+docs = [
+    design_doc(
+        "shelter",
+        items,
+        parts,
+        own_folder=True,
+        parts_reference="../parts",
+    ),
+    {
+        "path": "../docs/shelter/parts-v1.md",
+    },
+]

bluer_sbc/README/designs/swallow.py

@@ -0,0 +1,46 @@
+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/v5/{}?raw=true"
+
+marquee = README.Items(
+    [
+        {
+            "name": "swallow",
+            "marquee": image_template.format("01.jpg"),
+            "url": "./bluer_sbc/docs/swallow.md",
+        }
+    ]
+)
+
+items = ImageItems(
+    {image_template.format(f"{index+1:02}.jpg"): "" for index in range(6)}
+)
+
+parts = {
+    "BTS7960": "2 x",
+    "connector": "2 females",
+    "white-terminal": "8 x",
+    "nuts-bolts-spacers": "M3: ({})".format(
+        " + ".join(
+            [
+                "8 x 25 mm spacer",
+                "4 x 30 mm spacer",
+                "4 x nut",
+            ]
+        )
+    ),
+    "solid-cable-1-15": "20 cm x (red + black/blue)",
+}
+
+docs = [
+    design_doc(
+        "swallow",
+        items,
+        parts,
+    )
+]