bluer-sbc 8.3.1__py3-none-any.whl

bluer_sbc/.abcli/abcli.sh

@@ -0,0 +1,12 @@
+#! /usr/bin/env bash
+
+bluer_ai_source_caller_suffix_path /tests
+
+bluer_ai_env_dot_load \
+    caller,filename=config.env,suffix=/..
+
+bluer_ai_env_dot_load \
+    caller,plugin=bluer_sbc,suffix=/../..
+
+[[ "$abcli_is_github_workflow" == true ]] &&
+    export BLUER_SBC_SESSION_IMAGER_ENABLED=0

bluer_sbc/.abcli/actions.sh

@@ -0,0 +1,11 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_action_git_before_push() {
+    bluer_sbc build_README
+    [[ $? -ne 0 ]] && return 1
+
+    [[ "$(abcli_git get_branch)" != "main" ]] &&
+        return 0
+
+    bluer_sbc pypi build
+}

bluer_sbc/.abcli/adafruit_rgb_matrix.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_adafruit_rgb_matrix() {
+    local task=$1
+
+    if [ "$task" == "validate" ]; then
+        pushd $abcli_path_git/Raspberry-Pi-Installer-Scripts/rpi-rgb-led-matrix/examples-api-use >/dev/null
+        sudo ./demo -D0
+        popd >/dev/null
+        return
+    fi
+
+    abcli_log_error "@sbc: adafruit_rgb_matrix: $task: command not found."
+}

bluer_sbc/.abcli/alias.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+alias @sbc=bluer_sbc
+
+alias grove=bluer_sbc_grove

bluer_sbc/.abcli/blue_sbc.sh

@@ -0,0 +1,11 @@
+#! /usr/bin/env bash
+
+function bluer_sbc() {
+    local task=$1
+
+    abcli_generic_task \
+        plugin=bluer_sbc,task=$task \
+        "${@:2}"
+}
+
+abcli_log $(bluer_sbc version --show_icon 1)

bluer_sbc/.abcli/camera.sh

@@ -0,0 +1,20 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_camera() {
+    local task=$1
+
+    if [[ "|capture|preview|" == *"|$task|"* ]]; then
+        local options=$2
+        local capture_video=$(abcli_option_int "$options" video 0)
+        [[ "$capture_video" == 1 ]] &&
+            task=capture_video
+
+        python3 -m bluer_sbc.imager.camera \
+            $task \
+            "${@:3}"
+
+        return
+    fi
+
+    python3 -m bluer_sbc.imager.camera "$@"
+}

bluer_sbc/.abcli/grove.sh

@@ -0,0 +1,43 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_grove() {
+    local task=$1
+
+    if [ "$task" == "info" ]; then
+        # https://learn.adafruit.com/scanning-i2c-addresses/raspberry-pi
+        i2cdetect -y 1
+        return
+    fi
+
+    if [ "$task" == "validate" ]; then
+        local what=$(abcli_clarify_input $2 button)
+
+        local args=""
+        local filepath="grove.py/grove"
+        if [ "$what" == "adc" ]; then
+            local filename="adc"
+        elif [ "$what" == "button" ]; then
+            filename="grove_button"
+            args="24"
+        elif [ "$what" == "oled_128x64" ]; then
+            filepath="Seeed_Python_SSD1315/examples"
+            filename="image"
+        else
+            abcli_log_error "@sbc: grove: $task: $what: hardware not found."
+            return
+        fi
+
+        filename=$(abcli_clarify_input $3 $filename)
+
+        local grove_path=$abcli_path_git/$filepath
+
+        abcli_log "validating grove $what: $grove_path/$filename.py $args"
+        pushd $grove_path >/dev/null
+        python3 $filename.py $args
+        popd >/dev/null
+
+        return
+    fi
+
+    abcli_log_error "@sbc: grove: $task: command not found."
+}

bluer_sbc/.abcli/hat.sh

@@ -0,0 +1,22 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_hat() {
+    local task=$1
+
+    if [[ "|input|validate|" == *"|$task|"* ]]; then
+        python3 -m bluer_sbc.hardware.hat \
+            $task \
+            "${@:2}"
+        return
+    fi
+
+    if [ "$task" == "output" ]; then
+        python3 -m bluer_sbc.hardware.hat \
+            output \
+            --outputs "$2" \
+            "${@:3}"
+        return
+    fi
+
+    python3 -m bluer_sbc.hardware.hat "$@"
+}

bluer_sbc/.abcli/install/adafruit_rgb_matrix.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function abcli_install_adafruit_rgb_matrix() {
+    pushd $abcli_path_git >/dev/null
+    git clone https://github.com/adafruit/Raspberry-Pi-Installer-Scripts.git
+    cd Raspberry-Pi-Installer-Scripts
+    sudo bash ./rgb-matrix.sh
+    popd >/dev/null
+
+    sudo setcap 'cap_sys_nice=eip' /usr/bin/python3.7
+}
+
+if [ "$BLUER_SBC_HARDWARE_KIND" == "adafruit_rgb_matrix" ]; then
+    abcli_install_module adafruit_rgb_matrix 106
+fi

bluer_sbc/.abcli/install/grove.sh

@@ -0,0 +1,29 @@
+#! /usr/bin/env bash
+
+function abcli_install_grove() {
+    pushd $abcli_path_git >/dev/null
+
+    # https://wiki.seeedstudio.com/Grove_Base_Kit_for_Raspberry_Pi/
+    curl -L https://github.com/Seeed-Studio/grove.py/raw/master/install.sh \
+        --output grove_install.sh
+    sudo bash ./grove_install.sh
+
+    git clone https://github.com/kamangir/grove.py
+    cd grove.py
+    sudo pip3 install -e .
+
+    # https://wiki.seeedstudio.com/Grove-OLED-Yellow%26Blue-Display-0.96-%28SSD1315%29_V1.0/
+    sudo apt-get install -y python-smbus
+    sudo apt-get install -y i2c-tools
+    sudo pip3 install Adafruit-BBIO
+    sudo pip3 install Adafruit-SSD1306
+
+    cd ..
+    git clone https://github.com/IcingTomato/Seeed_Python_SSD1315.git
+
+    popd >/dev/null
+}
+
+if [ "$BLUER_SBC_HARDWARE_KIND" == "grove" ]; then
+    abcli_install_module grove 106
+fi

bluer_sbc/.abcli/install/lepton.sh

@@ -0,0 +1,33 @@
+#! /usr/bin/env bash
+
+function abcli_install_lepton() {
+    sudo apt-get update --allow-releaseinfo-change
+
+    cd ~
+    sudo apt-get --yes --force-yes install bison flex aptitude qt4-qmake libqt4-dev
+    sudo aptitude --yes --force-yes install libssl-dev
+
+    # To clone linux for raspberry pi
+    git clone --depth=1 https://github.com/raspberrypi/linux
+
+    # To setup kernel
+    cd ~/linux
+    KERNEL=kernel7
+    make bcm2709_defconfig
+    sudo sed -i '$akernel=kernel7.img' /boot/config.txt
+
+    # To build and install kernel modules
+    make -j4 zImage modules dtbs
+    sudo make modules_install
+    sudo cp arch/arm/boot/dts/*.dtb /boot/
+    sudo cp arch/arm/boot/dts/overlays/*.dtb* /boot/overlays/
+    sudo cp arch/arm/boot/dts/overlays/README /boot/overlays/
+    sudo cp arch/arm/boot/zImage /boot/$KERNEL.img
+
+    sudo apt --yes --force-yes install python-opencv
+    sudo pip install pylepton
+}
+
+if [ "$BLUER_SBC_SESSION_IMAGER" == "lepton" ]; then
+    abcli_install_module lepton 102
+fi

bluer_sbc/.abcli/install/rpi.sh

@@ -0,0 +1,65 @@
+#! /usr/bin/env bash
+
+function abcli_install_rpi() {
+    pushd $abcli_path_git > /dev/null
+
+    # https://docs.donkeycar.com/guide/robot_sbc/setup_raspberry_pi/
+    sudo apt-get update
+    sudo apt-get -y upgrade
+
+    sudo apt-get --yes --force-yes install build-essential python3 python3-dev python3-pip \
+        python3-virtualenv python3-numpy python3-picamera python3-pandas python3-rpi.gpio \
+        i2c-tools avahi-utils joystick libopenjp2-7-dev libtiff5-dev gfortran libatlas-base-dev \
+        libopenblas-dev libhdf5-serial-dev libgeos-dev git ntp
+
+    sudo apt-get --yes --force-yes install libilmbase-dev libopenexr-dev libgstreamer1.0-dev \
+        libjasper-dev libwebp-dev libatlas-base-dev libavcodec-dev libavformat-dev libswscale-dev \
+        libqtgui4 libqt4-test
+
+    # https://rtcbot.readthedocs.io/en/latest/installing.html
+    sudo apt-get --yes --force-yes install python3-numpy python3-cffi python3-aiohttp \
+        libavformat-dev libavcodec-dev libavdevice-dev libavutil-dev \
+        libswscale-dev libswresample-dev libavfilter-dev libopus-dev \
+        libvpx-dev pkg-config libsrtp2-dev python3-opencv pulseaudio
+
+    cd
+    python3 -m virtualenv -p python3 env --system-site-packages
+    echo "source env/bin/activate" >> ~/.bashrc
+    source env/bin/activate
+
+    cd git
+    git clone https://github.com/autorope/donkeycar
+    cd donkeycar
+    git checkout master
+    pip3 install -e .[pi]
+
+    pip3 install numpy --upgrade
+
+    cd
+    curl -sc /tmp/cookie "https://drive.google.com/uc?export=download&id=1DCfoSwlsdX9X4E3pLClE1z0fvw8tFESP" > /dev/null
+    CODE="$(awk '/_warning_/ {print $NF}' /tmp/cookie)"
+    curl -Lb /tmp/cookie "https://drive.google.com/uc?export=download&confirm=${CODE}&id=1DCfoSwlsdX9X4E3pLClE1z0fvw8tFESP" -o tensorflow-2.2.0-cp37-cp37m-linux_armv7l.whl
+    pip3 install tensorflow-2.2.0-cp37-cp37m-linux_armv7l.whl
+
+    sudo apt --yes --force-yes install python3-opencv
+
+    pip3 install PyMySQL==0.10.1
+    pip3 install tqdm
+    pip3 install boto3
+    pip3 install dill
+    pip3 install imutils
+
+    # https://rtcbot.readthedocs.io/en/latest/installing.html
+    # pip install rtcbot
+
+    pip3 install awscli --upgrade
+    if [[ $PATH != *"/home/pi/.local/bin"* ]]; then
+        export PATH=/home/pi/.local/bin:$PATH
+    fi
+
+    popd > /dev/null
+}
+
+if [ "$abcli_is_rpi" == true ] ; then
+    abcli_install_module rpi 109
+fi

bluer_sbc/.abcli/install/scroll_phat_hd.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function abcli_install_scroll_phat_hd() {
+    pushd $abcli_path_home/git >/dev/null
+    git clone https://github.com/pimoroni/scroll-phat-hd
+    popd >/dev/null
+
+    # https://github.com/pimoroni/scroll-phat-hd
+    sudo apt-get install python3-scrollphathd
+}
+
+if [ "$BLUER_SBC_HARDWARE_KIND" == "scroll_phat_hd" ]; then
+    abcli_install_module scroll_phat_hd 102
+fi

bluer_sbc/.abcli/install/sparkfun_top_phat.sh

@@ -0,0 +1,33 @@
+#! /usr/bin/env bash
+
+function abcli_install_sparkfun_top_phat() {
+    # https://learn.sparkfun.com/tutorials/sparkfun-top-phat-hookup-guide/button-controller
+    sudo pip3 install sparkfun-qwiic
+
+    # https://learn.sparkfun.com/tutorials/sparkfun-top-phat-hookup-guide/ws2812b-leds
+    sudo pip3 install adafruit-circuitpython-neopixel
+
+    # https://github.com/rpi-ws281x/rpi-ws281x-python
+    # https://github.com/jgarff/rpi_ws281x
+    # https://stackoverflow.com/a/53045690/17619982
+    sudo pip3 install rpi_ws281x
+
+    pushd $abcli_path_home/git >/dev/null
+    git clone https://github.com/sparkfun/Top_pHAT_Button_Py
+    popd >/dev/null
+
+    # https://learn.sparkfun.com/tutorials/sparkfun-top-phat-hookup-guide/24-tft-display-linux-54-update
+    pushd $abcli_path_home >/dev/null
+    curl -L https://cdn.sparkfun.com/assets/learn_tutorials/1/1/7/0/sfe-topphat-overlay.dts \
+        --output ./sfe-topphat-overlay.dts
+    dtc -@ -I dts -O dtb -o rpi-display.dtbo sfe-topphat-overlay.dts
+    sudo cp rpi-display.dtbo /boot/overlays
+    popd >/dev/null
+}
+
+if [ "$BLUER_SBC_HARDWARE_KIND" == "sparkfun-top-phat" ]; then
+    abcli_install_module sparkfun_top_phat 104
+
+    # https://learn.sparkfun.com/tutorials/sparkfun-top-phat-hookup-guide/24-tft-display-archived
+    con2fbmap 1 1
+fi

bluer_sbc/.abcli/install/template.sh

@@ -0,0 +1,9 @@
+#! /usr/bin/env bash
+
+function abcli_install_bluer_sbc_template() {
+    abcli_log "wip"
+}
+
+if [ "$BLUER_SBC_HARDWARE_KIND" == "bluer_sbc_template" ]; then
+    abcli_install_module bluer_sbc_template 101
+fi

bluer_sbc/.abcli/install/unicorn_16x16.sh

@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+function abcli_install_unicorn_16x16() {
+    pushd $abcli_path_git >/dev/null
+    git clone https://github.com/pimoroni/unicorn-hat-hd
+    popd >/dev/null
+
+    # https://github.com/pimoroni/unicorn-hat-hd
+    sudo raspi-config nonint do_spi 0
+    sudo apt-get --yes --force-yes install python3-pip python3-dev python3-spidev
+    sudo pip3 install unicornhathd
+}
+
+if [ "$BLUER_SBC_HARDWARE_KIND" == "unicorn_16x16" ]; then
+    abcli_install_module unicorn_16x16 101
+fi

bluer_sbc/.abcli/lepton.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_lepton() {
+    local task=$1
+
+    if [[ "|capture|preview|" == *"|$task|"* ]]; then
+        python3 -m bluer_sbc.imager.lepton \
+            $task \
+            --output_path $abcli_object_path \
+            "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_sbc.imager.lepton "$@"
+}

bluer_sbc/.abcli/scroll_phat_hd.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_scroll_phat_hd() {
+    local task=$1
+
+    if [ "$task" == "validate" ]; then
+        pushd $abcli_path_git/scroll-phat-hd/examples >/dev/null
+        python3 plasma.py
+        popd >/dev/null
+        return
+    fi
+
+    abcli_log_error "@sbc: scroll_phat_hd: $task: command not found."
+}

bluer_sbc/.abcli/session.sh

@@ -0,0 +1,39 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_session() {
+    local task=${1:-start}
+
+    if [ "$task" == "start" ]; then
+        local options=$2
+        local do_dryrun=$(abcli_option_int "$options" dryrun 0)
+        local run_sudo=$(abcli_option_int "$options" sudo 0)
+        local do_upload=$(abcli_option_int "$options" upload 1)
+
+        abcli_log "@sbc: session @ $abcli_object_name started ..."
+
+        abcli_mlflow_tags_set \
+            $abcli_object_name \
+            session,host=$abcli_hostname,$BLUER_SBC_SESSION_OBJECT_TAGS
+
+        local sudo_prefix=""
+        # https://stackoverflow.com/a/8633575/17619982
+        [[ "$run_sudo" == 1 ]] &&
+            sudo_prefix="sudo -E "
+
+        abcli_eval dryrun=$do_dryrun \
+            $sudo_prefix \
+            python3 -m bluer_sbc.session \
+            start \
+            "${@:3}"
+        local status="$?"
+
+        [[ "$do_upload" == 1 ]] &&
+            abcli_upload - $abcli_object_name
+
+        abcli_log "@sbc: session ended."
+
+        return $status
+    fi
+
+    python3 -m bluer_sbc.session "$@"
+}

bluer_sbc/.abcli/sparkfun_top_phat.sh

@@ -0,0 +1,27 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_sparkfun_top_phat() {
+    local task=$1
+
+    if [ "$task" == "validate" ]; then
+        local what=${2:-button}
+
+        if [ "$what" == button ]; then
+            pushd $abcli_path_git/Top_pHAT_Button_Py/examples >/dev/null
+            python3 top_phat_button_ex2.py
+            popd >/dev/null
+            return
+        fi
+
+        if [ "$what" == leds ]; then
+            sudo python3 -m bluer_sbc.hardware.sparkfun_top_phat \
+                validate_leds
+            return
+        fi
+
+        sudo python3 -m bluer_sbc.hardware.sparkfun_top_phat "$@"
+        return
+    fi
+
+    sudo python3 -m bluer_sbc.hardware.sparkfun_top_phat "$@"
+}

bluer_sbc/.abcli/tests/README.sh

@@ -0,0 +1,8 @@
+#! /usr/bin/env bash
+
+function test_bluer_sbc_README() {
+    local options=$1
+
+    abcli_eval ,$options \
+        bluer_sbc build_README
+}

bluer_sbc/.abcli/tests/camera.sh

@@ -0,0 +1,47 @@
+#! /usr/bin/env bash
+
+function test_bluer_sbc_camera_capture() {
+    [[ "$BLUER_SBC_SESSION_IMAGER_ENABLED" == 0 ]] &&
+        return 0
+
+    local options=$1
+
+    abcli_select \
+        test_bluer_sbc_camera_capture-$(abcli_string_timestamp_short)
+
+    abcli_eval ,$options \
+        bluer_sbc_camera \
+        capture \
+        image
+}
+
+function test_bluer_sbc_camera_capture_video() {
+    [[ "$BLUER_SBC_SESSION_IMAGER_ENABLED" == 0 ]] ||
+        [[ "$abcli_is_rpi" = false ]] &&
+        return 0
+
+    local options=$1
+
+    abcli_select \
+        test_bluer_sbc_camera_capture_video-$(abcli_string_timestamp_short)
+
+    abcli_eval ,$options \
+        bluer_sbc_camera \
+        capture \
+        video \
+        --length 3 \
+        --preview 1
+}
+
+function test_bluer_sbc_camera_preview() {
+    [[ "$BLUER_SBC_SESSION_IMAGER_ENABLED" == 0 ]] &&
+        return 0
+
+    local options=$1
+
+    abcli_eval ,$options \
+        bluer_sbc_camera \
+        preview \
+        - \
+        --length 3
+}

bluer_sbc/.abcli/tests/help.sh

@@ -0,0 +1,65 @@
+#! /usr/bin/env bash
+
+function test_bluer_sbc_help() {
+    local options=$1
+
+    local module
+    for module in \
+        "@sbc" \
+        \
+        "@sbc adafruit_rgb_matrix" \
+        "@sbc adafruit_rgb_matrix validate" \
+        \
+        "@sbc browse" \
+        \
+        "@sbc camera" \
+        "@sbc camera capture" \
+        "@sbc camera capture image" \
+        "@sbc camera capture video" \
+        "@sbc camera preview" \
+        \
+        "@sbc hat" \
+        "@sbc hat input" \
+        "@sbc hat output" \
+        "@sbc hat validate" \
+        \
+        "@sbc lepton" \
+        "@sbc lepton capture" \
+        "@sbc lepton preview" \
+        \
+        "@sbc pypi" \
+        "@sbc pypi browse" \
+        "@sbc pypi build" \
+        "@sbc pypi install" \
+        \
+        "@sbc pytest" \
+        \
+        "@sbc scroll_phat_hd" \
+        "@sbc scroll_phat_hd validate" \
+        \
+        "@sbc session" \
+        "@sbc session start" \
+        \
+        "@sbc sparkfun_top_phat" \
+        "@sbc sparkfun_top_phat validate" \
+        \
+        "@sbc test" \
+        "@sbc test list" \
+        \
+        "@sbc unicorn_16x16" \
+        "@sbc unicorn_16x16 validate" \
+        \
+        "grove info" \
+        "grove validate" \
+        "grove validate oled_128x64" \
+        \
+        "bluer_sbc"; do
+        abcli_eval ,$options \
+            abcli_help $module
+        [[ $? -ne 0 ]] && return 1
+
+        abcli_hr
+    done
+
+    return 0
+}

bluer_sbc/.abcli/tests/version.sh

@@ -0,0 +1,8 @@
+#! /usr/bin/env bash
+
+function test_bluer_sbc_version() {
+    local options=$1
+
+    abcli_eval ,$options \
+        "bluer_sbc version ${@:2}"
+}

bluer_sbc/.abcli/unicorn_16x16.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_unicorn_16x16() {
+    local task=$1
+
+    if [ "$task" == "validate" ]; then
+        pushd $abcli_path_git/unicorn-hat-hd/examples >/dev/null
+        python3 rainbow.py
+        popd >/dev/null
+        return
+    fi
+
+    abcli_log_error "@sbc: unicorn_16x16: $task: command not found."
+}

bluer_sbc/README.py

@@ -0,0 +1,51 @@
+import os
+from typing import List
+
+from bluer_objects import file, README
+
+from bluer_sbc import NAME, VERSION, ICON, REPO_NAME
+
+
+image_prefix = "https://github.com/kamangir/blue-bracket/raw/main/images/"
+design_prefix = "https://github.com/kamangir/blue-bracket/blob/main/designs/"
+
+
+def items() -> List[str]:
+    return [
+        "[![image]({}{})]({}{}.md)".format(
+            image_prefix,
+            item["image"],
+            design_prefix,
+            item["name"],
+        )
+        for item in [
+            {
+                "image": "blue3-1.jpg",
+                "name": "blue3",
+            },
+            {
+                "image": "chenar-grove-1.jpg",
+                "name": "chenar-grove",
+            },
+            {
+                "image": "cube-1.jpg",
+                "name": "cube",
+            },
+            {
+                "image": "eye_nano-1.jpg",
+                "name": "eye_nano",
+            },
+        ]
+    ]
+
+
+def build():
+    return README.build(
+        items=items(),
+        cols=4,
+        path=os.path.join(file.path(__file__), ".."),
+        ICON=ICON,
+        NAME=NAME,
+        VERSION=VERSION,
+        REPO_NAME=REPO_NAME,
+    )