Merge V2.1 into main and tag as V2.1.0

.github/workflows/kibot-autodiscover.yml

@@ -0,0 +1,194 @@
+name: KiCad docs via KiBot (auto-discover)
+
+on:
+  push:
+    paths:
+      - "**/*.kicad_pro"
+      - "**/*.kicad_sch"
+      - "**/*.kicad_pcb"
+      - "config.kibot.yaml"
+      - ".github/workflows/kibot-autodiscover.yml"
+  pull_request:
+    paths:
+      - "**/*.kicad_pro"
+      - "**/*.kicad_sch"
+      - "**/*.kicad_pcb"
+      - "config.kibot.yaml"
+  workflow_dispatch:
+
+concurrency:
+  group: kibot-${{ github.ref }}
+  cancel-in-progress: true
+
+# needed for the final commit job
+permissions:
+  contents: write
+
+jobs:
+  discover:
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.mk.outputs.matrix }}
+    steps:
+      - uses: actions/checkout@v4
+        with: { lfs: true }
+
+      - id: mk
+        shell: bash
+        run: |
+          set -euo pipefail
+          shopt -s nullglob
+
+          # Find all .kicad_pro (prefer git to respect .gitignore)
+          if git ls-files '*.kicad_pro' >/dev/null 2>&1; then
+            mapfile -t PROJ < <(git ls-files '*.kicad_pro' | sort)
+          else
+            mapfile -d '' -t PROJ < <(find . -type f -name '*.kicad_pro' -print0 | sed -z 's|^\./||' | sort -z)
+          fi
+
+          echo "Found ${#PROJ[@]} KiCad projects:" >> "$GITHUB_STEP_SUMMARY"
+          for p in "${PROJ[@]}"; do echo "- $p" >> "$GITHUB_STEP_SUMMARY"; done
+
+          : > rows.jsonl
+          for p in "${PROJ[@]}"; do
+            dir="$(dirname "$p")"
+            base="$(basename "$p" .kicad_pro)"
+            sch="${dir}/${base}.kicad_sch"
+            pcb="${dir}/${base}.kicad_pcb"
+            [[ -f "$sch" ]] || sch="$(find "$dir" -maxdepth 1 -name '*.kicad_sch' | sort | head -n1 || true)"
+            [[ -f "$pcb" ]] || pcb="$(find "$dir" -maxdepth 1 -name '*.kicad_pcb' | sort | head -n1 || true)"
+            if [[ -f "${sch:-}" && -f "${pcb:-}" ]]; then
+              jq -n --arg project "$p" --arg schema "$sch" --arg board "$pcb" \
+                '{project:$project, schema:$schema, board:$board}' >> rows.jsonl
+            else
+              echo "⚠️ Skipping '$p' (missing SCH or PCB). sch='${sch:-none}', pcb='${pcb:-none}'" >> "$GITHUB_STEP_SUMMARY"
+            fi
+          done
+
+          matrix_json="$(jq -c -s '.' rows.jsonl)"
+          printf 'matrix=%s\n' "$matrix_json" >> "$GITHUB_OUTPUT"
+
+  build:
+    needs: discover
+    if: ${{ needs.discover.outputs.matrix != '[]' && needs.discover.outputs.matrix != '' }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJson(needs.discover.outputs.matrix) }}
+    steps:
+      - uses: actions/checkout@v4
+        with: { lfs: true }
+
+      - name: Run KiBot (KiCad 8)
+        uses: INTI-CMNB/KiBot@v2_k8
+        with:
+          config: config.kibot.yaml
+          dir: build/${{ matrix.project }}
+          schema: ${{ matrix.schema }}
+          board:  ${{ matrix.board }}
+
+      # Compute names/paths once for artifact
+      - name: Compute artifact paths
+        id: paths
+        shell: bash
+        run: |
+          set -euo pipefail
+          pname="$(basename '${{ matrix.project }}' .kicad_pro)"
+          # We upload the docs directory (so the <ProjectName>/ subfolder is preserved)
+          src_dir="build/${{ matrix.project }}/docs"
+          aname="kicad-exports-${pname}"
+          aname="${aname//\//_}"; aname="${aname// /_}"; aname="${aname//:/_}"
+          echo "pname=$pname"   >> "$GITHUB_OUTPUT"
+          echo "src_dir=$src_dir" >> "$GITHUB_OUTPUT"
+          echo "artifact=$aname"  >> "$GITHUB_OUTPUT"
+
+      # Safety net: upload each project's docs as an artifact
+      - name: Upload per-project artifact (always)
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ steps.paths.outputs.artifact }}
+          path: ${{ steps.paths.outputs.src_dir }}
+          if-no-files-found: warn
+          retention-days: 14
+
+  publish:
+    needs: build
+    if: ${{ github.event_name == 'push' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all project artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: kicad-exports-*
+          path: collected
+          merge-multiple: true
+
+      - name: Merge into repo docs/
+        shell: bash
+        run: |
+            set -euo pipefail
+            mkdir -p docs
+            if [ -d "collected/docs" ]; then
+            # case A: artifacts contained a docs/ root
+            rsync -a collected/docs/ docs/
+            elif [ -d "collected" ]; then
+            # case B (your current case): artifacts are <ProjectName>/...
+            rsync -a collected/ docs/
+            else
+            echo "Nothing to merge."
+            fi
+            echo "Merged into docs/. Contents:"
+            find docs -maxdepth 2 -type f | sort
+
+      - name: Build merged BOM (docs/_all_projects_bom.csv)
+        shell: python
+        run: |
+            import csv, glob, os
+            # Find per-project BOMs like: docs/<ProjectName>/<ProjectName>_bom.csv
+            bom_paths = sorted(glob.glob('docs/*/*_bom.csv'))
+            if not bom_paths:
+                print("No BOMs found; nothing to merge.")
+                raise SystemExit(0)
+
+            out_path = 'docs/all_projects_bom.csv'
+            # Desired column order (first column = project name)
+            cols = ['Project','Reference','Value','Qty','Note','Description','RSONLINE']
+
+            rows = []
+            for p in bom_paths:
+                project = os.path.basename(os.path.dirname(p))
+                with open(p, newline='', encoding='utf-8') as f:
+                    r = csv.DictReader(f)
+                    for row in r:
+                        row = dict(row)            # copy
+                        row['Project'] = project   # <-- first column value
+                        rows.append(row)
+
+            # Optional: stable sort for readability
+            rows.sort(key=lambda r: (r.get('Project',''), r.get('Reference','')))
+
+            with open(out_path, 'w', newline='', encoding='utf-8') as out:
+                w = csv.DictWriter(out, fieldnames=cols, extrasaction='ignore')
+                w.writeheader()
+                for row in rows:
+                    w.writerow(row)
+
+            print(f"Wrote {out_path} from {len(bom_paths)} BOM file(s).")
+
+      - name: Commit updated docs (single commit)
+        shell: bash
+        run: |
+          set -euo pipefail
+          git config user.name  "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add -A -f docs
+          if git diff --cached --quiet; then
+            echo "No changes to commit."
+          else
+            git commit -m "docs: update KiCad exports [skip ci]"
+            git push
+          fi

config.kibot.yaml

@@ -0,0 +1,63 @@
+kibot:
+  version: 1
+
+preflight:
+  check_zone_fills: false
+
+variants: []
+
+outputs:
+  # 1) Schematic PDF
+  - name: pdf_schematic
+    type: pdf_sch_print
+    dir: docs/%f
+    options:
+      monochrome: false
+      output: "%f_schematic.pdf"
+
+  # 2) CSV BoM (only the columns you want)
+  - name: bom_csv
+    type: bom
+    dir: docs/%f
+    options:
+      format: CSV
+      csv:
+        hide_pcb_info: true
+        hide_stats_info: true
+        separator: ","
+        string_delimiter: '"'
+      columns:
+        - { field: "References",         name: "Reference" }
+        - { field: "Value" }
+        - { field: "Quantity Per PCB",   name: "Qty" }
+        - { field: "Note" }
+        - { field: "Description" }
+        - { field: "RSONLINE" }
+      # IMPORTANT: stop KiBot “fixing” your Value text
+      parse_value: false         # <- don’t canonicalize 1k/1000 or strip 1%, 5%, etc.
+      normalize_values: false    # <- keep your exact units/prefixes
+      merge_blank_fields: false  # <- avoid merging groups just because a field is blank
+      # Optional: grouping rules (keep or adjust as you like)
+      group_fields: ["Value"]
+      ref_separator: " "
+      output: "%f_bom.csv"
+
+  # 4) PCB render - top
+  - name: pcbdraw_top
+    type: pcbdraw
+    dir: docs/%f
+    options:
+      format: png
+      dpi: 300
+      bottom: false
+      output: "%f_board_top.png"
+
+  # 5) PCB render - bottom
+  - name: pcbdraw_bottom
+    type: pcbdraw
+    dir: docs/%f
+    options:
+      format: png
+      dpi: 300
+      bottom: true
+      output: "%f_board_bottom.png"

docs/UKMARSBOT_LineSensorBasic/UKMARSBOT_LineSensorBasic_bom.csv

@@ -0,0 +1,14 @@
+Reference,Value,Qty,Note,Description,RSONLINE
+C1 C2,100uF,2,,Polarized capacitor,739-6799
+D5,Line,1,,,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+D4,Radius,1,,,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+D6,S/Finish,1,,,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+D1 D2 D7,TLCR5800,3,,,818-7540
+J1,Conn_01x16,1,https://uk.rs-online.com/web/p/pcb-sockets/6816820 Need to be cut down,"Generic connector, single row, 01x16, script generated (kicad-library-utils/schlib/autogen/connector/)",681-6820
+Q1 Q6,BC337-40,2,,,671-1119
+Q2 Q3 Q4 Q5,BPW85C,4,,,815-1263
+R4 R16,10K,2,,,707-7745
+R3 R5 R17,10R,3,,,707-8580
+R2 R15,390R,2,,,707-7634
+R1,50R,1,,Resistor,
+R7 R8 R9 R10 R11 R12 R14,680R,7,,,707-8211

docs/UKMARSBOT_RP2040Chassis/UKMARSBOT_RP2040Chassis_bom.csv

@@ -0,0 +1,12 @@
+Reference,Value,Qty,Note,Description,RSONLINE
+BT1,9v Battery,1,,PP3 9v Battery,
+C2,0.1uF,1,Maximum height is 10mm,Unpolarized capacitor,538-1433
+C1,0.22uF,1,Maximum height is 10mm,Unpolarized capacitor,194-0629
+C3 C4,"100uF, 16V",2,Maximum height is 10mm,,176-3779 
+D1,1N5401,1,Polarity protection diode,,628-9451
+J3 J4 J6 J7,Conn_01x06,4,"Might be easier and cheaper to just cut from bigger lengths 0.1"" pitch, polarised, any type",https://uk.rs-online.com/web/p/pcb-headers/6812994,681-2994
+J1 J2,Pololu Item #4772,2,"6 pin 0.1"" breakout 6 pin header, 0.1"", male","Single row, 01x06, JST-SH breakout",
+M1 M2,N20 MOTOR,2,Sidways or regular would work for starting out 50:1 gearbox is recommended commercial mounts need bushing for screws,https://shop.pimoroni.com/products/micro-metal-motor-encoder?variant=39888423321683,NA
+R1,47K,1,,Resistor,707-8369
+U1,DVR8833_DC_Controller,1,,DC Motor Controller https://amzn.eu/d/csv7cRr as an option,
+U2,LM7805_TO220,1,,"Positive 1A 35V Linear Regulator, Fixed Output 5V, TO-220",793-1346

docs/UKMARSBOT_RP2040Mezzanine/UKMARSBOT_RP2040Mezzanine_bom.csv

@@ -0,0 +1,6 @@
+Reference,Value,Qty,Note,Description,RSONLINE
+D1 D2,LED,2,,Light emitting diode,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+J1 J2 J3 J4 J5,Conn_01x16,5,Might be easier and cheaper to just cut from bigger lengths Cut from a bigger strip of 2.54 header,"Generic connector, single row, 01x16, script generated (kicad-library-utils/schlib/autogen/connector/) Generic connector, single row, 01x06, script generated (kicad-library-utils/schlib/autogen/connector/) Generic connector, single row, 01x04, script generated",681-3007 681-2994
+R1 R2,680R,2,,Resistor,707-8211
+SW1 SW2 SW3,TACT_SW,3,,TACT switch 6mm 4.5mm,479-1390P
+U1,Pico,1,,,

docs/UKMARSBOT_RP2040Wall-Sensor-Basic/UKMARSBOT_RP2040Wall-Sensor-Basic_bom.csv

@@ -0,0 +1,14 @@
+Reference,Value,Qty,Note,Description,RSONLINE
+C1 C2,"100uF, 16v",2,,Unpolarized capacitor,739-6799
+D1 D2 D3,LED,3,,Light emitting diode,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+DLED1 DLED2 FLED1,TLCR5800,3,,Light emitting diode,818-7540
+FPD1 LDPD1 RDPD1,BPW85C,3,,Photodiode,815-1263
+J1,Conn_01x16,1,https://uk.rs-online.com/web/p/pcb-sockets/6816820 Can also be found on ebay slightly cheaper,"Generic connector, single row, 01x16, script generated (kicad-library-utils/schlib/autogen/connector/)",681-6820
+Q1 Q2,BC337-40,2,,"NPN transistor, emitter/base/collector",671-1119
+R4 R6,10K,2,,Resistor,707-7745
+R7 R8 R9,10R,3,,Resistor,707-8580
+R15,1k8,1,,Resistor,707-8675
+R11 R13,2k2,2,,Resistor,707-8255
+R2,33R,1,,Resistor,707-8805
+R1 R3,390R,2,,Resistor,707-7634
+R10 R12 R14,680R,3,,Resistor,707-8211

docs/all_projects_bom.csv

@@ -0,0 +1,43 @@
+Project,Reference,Value,Qty,Note,Description,RSONLINE
+UKMARSBOT_LineSensorBasic,C1 C2,100uF,2,,Polarized capacitor,739-6799
+UKMARSBOT_LineSensorBasic,D1 D2 D7,TLCR5800,3,,,818-7540
+UKMARSBOT_LineSensorBasic,D4,Radius,1,,,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+UKMARSBOT_LineSensorBasic,D5,Line,1,,,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+UKMARSBOT_LineSensorBasic,D6,S/Finish,1,,,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+UKMARSBOT_LineSensorBasic,J1,Conn_01x16,1,https://uk.rs-online.com/web/p/pcb-sockets/6816820 Need to be cut down,"Generic connector, single row, 01x16, script generated (kicad-library-utils/schlib/autogen/connector/)",681-6820
+UKMARSBOT_LineSensorBasic,Q1 Q6,BC337-40,2,,,671-1119
+UKMARSBOT_LineSensorBasic,Q2 Q3 Q4 Q5,BPW85C,4,,,815-1263
+UKMARSBOT_LineSensorBasic,R1,50R,1,,Resistor,
+UKMARSBOT_LineSensorBasic,R2 R15,390R,2,,,707-7634
+UKMARSBOT_LineSensorBasic,R3 R5 R17,10R,3,,,707-8580
+UKMARSBOT_LineSensorBasic,R4 R16,10K,2,,,707-7745
+UKMARSBOT_LineSensorBasic,R7 R8 R9 R10 R11 R12 R14,680R,7,,,707-8211
+UKMARSBOT_RP2040Chassis,BT1,9v Battery,1,,PP3 9v Battery,
+UKMARSBOT_RP2040Chassis,C1,0.22uF,1,Maximum height is 10mm,Unpolarized capacitor,194-0629
+UKMARSBOT_RP2040Chassis,C2,0.1uF,1,Maximum height is 10mm,Unpolarized capacitor,538-1433
+UKMARSBOT_RP2040Chassis,C3 C4,"100uF, 16V",2,Maximum height is 10mm,,176-3779 
+UKMARSBOT_RP2040Chassis,D1,1N5401,1,Polarity protection diode,,628-9451
+UKMARSBOT_RP2040Chassis,J1 J2,Pololu Item #4772,2,"6 pin 0.1"" breakout 6 pin header, 0.1"", male","Single row, 01x06, JST-SH breakout",
+UKMARSBOT_RP2040Chassis,J3 J4 J6 J7,Conn_01x06,4,"Might be easier and cheaper to just cut from bigger lengths 0.1"" pitch, polarised, any type",https://uk.rs-online.com/web/p/pcb-headers/6812994,681-2994
+UKMARSBOT_RP2040Chassis,M1 M2,N20 MOTOR,2,Sidways or regular would work for starting out 50:1 gearbox is recommended commercial mounts need bushing for screws,https://shop.pimoroni.com/products/micro-metal-motor-encoder?variant=39888423321683,NA
+UKMARSBOT_RP2040Chassis,R1,47K,1,,Resistor,707-8369
+UKMARSBOT_RP2040Chassis,U1,DVR8833_DC_Controller,1,,DC Motor Controller https://amzn.eu/d/csv7cRr as an option,
+UKMARSBOT_RP2040Chassis,U2,LM7805_TO220,1,,"Positive 1A 35V Linear Regulator, Fixed Output 5V, TO-220",793-1346
+UKMARSBOT_RP2040Mezzanine,D1 D2,LED,2,,Light emitting diode,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+UKMARSBOT_RP2040Mezzanine,J1 J2 J3 J4 J5,Conn_01x16,5,Might be easier and cheaper to just cut from bigger lengths Cut from a bigger strip of 2.54 header,"Generic connector, single row, 01x16, script generated (kicad-library-utils/schlib/autogen/connector/) Generic connector, single row, 01x06, script generated (kicad-library-utils/schlib/autogen/connector/) Generic connector, single row, 01x04, script generated",681-3007 681-2994
+UKMARSBOT_RP2040Mezzanine,R1 R2,680R,2,,Resistor,707-8211
+UKMARSBOT_RP2040Mezzanine,SW1 SW2 SW3,TACT_SW,3,,TACT switch 6mm 4.5mm,479-1390P
+UKMARSBOT_RP2040Mezzanine,U1,Pico,1,,,
+UKMARSBOT_RP2040Wall-Sensor-Basic,C1 C2,"100uF, 16v",2,,Unpolarized capacitor,739-6799
+UKMARSBOT_RP2040Wall-Sensor-Basic,D1 D2 D3,LED,3,,Light emitting diode,"""228-6004 or  228-5562 or  713-3974 or  813-4845"""
+UKMARSBOT_RP2040Wall-Sensor-Basic,DLED1 DLED2 FLED1,TLCR5800,3,,Light emitting diode,818-7540
+UKMARSBOT_RP2040Wall-Sensor-Basic,FPD1 LDPD1 RDPD1,BPW85C,3,,Photodiode,815-1263
+UKMARSBOT_RP2040Wall-Sensor-Basic,J1,Conn_01x16,1,https://uk.rs-online.com/web/p/pcb-sockets/6816820 Can also be found on ebay slightly cheaper,"Generic connector, single row, 01x16, script generated (kicad-library-utils/schlib/autogen/connector/)",681-6820
+UKMARSBOT_RP2040Wall-Sensor-Basic,Q1 Q2,BC337-40,2,,"NPN transistor, emitter/base/collector",671-1119
+UKMARSBOT_RP2040Wall-Sensor-Basic,R1 R3,390R,2,,Resistor,707-7634
+UKMARSBOT_RP2040Wall-Sensor-Basic,R10 R12 R14,680R,3,,Resistor,707-8211
+UKMARSBOT_RP2040Wall-Sensor-Basic,R11 R13,2k2,2,,Resistor,707-8255
+UKMARSBOT_RP2040Wall-Sensor-Basic,R15,1k8,1,,Resistor,707-8675
+UKMARSBOT_RP2040Wall-Sensor-Basic,R2,33R,1,,Resistor,707-8805
+UKMARSBOT_RP2040Wall-Sensor-Basic,R4 R6,10K,2,,Resistor,707-7745
+UKMARSBOT_RP2040Wall-Sensor-Basic,R7 R8 R9,10R,3,,Resistor,707-8580