From 8350d89f3eea33ead2981cb6a8e76ab7b36565d4 Mon Sep 17 00:00:00 2001 From: MDW <--unset> Date: Thu, 1 Jul 2021 23:55:40 +0200 Subject: [PATCH] Updated for kicost & interactivehtmlbom, also added scripts --- SuperPower-uC/lowcost/README.md | 6 + ...erPower-uC-KiCad--2021-07-01 22-15-06.html | 3682 +++++++++++++++++ SuperPower-uC/lowcost/SuperPower-uC-KiCad.sch | 560 +-- .../lowcost/SuperPower-uC-KiCad.xlsx | Bin 0 -> 19344 bytes SuperPower-uC/lowcost/battery_protection.sch | 440 +- SuperPower-uC/lowcost/charger.sch | 964 ++--- SuperPower-uC/lowcost/charger_io.sch | 1068 ++--- SuperPower-uC/lowcost/doBomHtml.sh | 78 + SuperPower-uC/lowcost/kicostbat.sh | 39 + SuperPower-uC/lowcost/mcu.sch | 1096 ++--- SuperPower-uC/lowcost/regulator.sch | 1314 +++--- SuperPower-uC/lowcost/rtc_cut_off.sch | 904 ++-- 12 files changed, 6978 insertions(+), 3173 deletions(-) create mode 100644 SuperPower-uC/lowcost/README.md create mode 100644 SuperPower-uC/lowcost/SuperPower-uC-KiCad--2021-07-01 22-15-06.html create mode 100644 SuperPower-uC/lowcost/SuperPower-uC-KiCad.xlsx create mode 100644 SuperPower-uC/lowcost/doBomHtml.sh create mode 100644 SuperPower-uC/lowcost/kicostbat.sh diff --git a/SuperPower-uC/lowcost/README.md b/SuperPower-uC/lowcost/README.md new file mode 100644 index 00000000..9f8e4b16 --- /dev/null +++ b/SuperPower-uC/lowcost/README.md @@ -0,0 +1,6 @@ +# Notes + +- xlsx BOM is lacking some pricing because LCSC is out of stock on those at the time of generating the BOM. +- `doBomHtml.sh` Requires `InteractiveHtmlBom` and generates HTML BOM +- `kicostbat.sh` requires `kicost` and generates BOM with pricing and facilities for ordering components. +- Original schematic was updates so that the `LCSC` fields are now `lcsc#` for compatibility with `kicost` diff --git a/SuperPower-uC/lowcost/SuperPower-uC-KiCad--2021-07-01 22-15-06.html b/SuperPower-uC/lowcost/SuperPower-uC-KiCad--2021-07-01 22-15-06.html new file mode 100644 index 00000000..a13404cc --- /dev/null +++ b/SuperPower-uC/lowcost/SuperPower-uC-KiCad--2021-07-01 22-15-06.html @@ -0,0 +1,3682 @@ + + + + + + + Interactive BOM for KiCAD + + + + + + +
+
+
+
+ +
+ + + +
+ +
+ + + + + + + +
+
+
+ + + +
+
+ + + +
+
+ + + +
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Board statsFrontBackTotal
Components~~~
Groups~~~
SMD pads~~~
TH pads~
+ + + + + + + +
Checkboxes
+
+
+
+ +
+
+
Save board image
+
+ + X + +
+ +
+ + +
+
+
+ Config and checkbox state +
+ + +
+
+
+
+
+
+ + + + + + + + + + + +
+ Title + + Revision +
+ Company + + Date +
+
+
+
+
+
+ + +
+ +
+
+
+ + + + + +
+
+
+
+
+ + + + +
+
+
+
+ + + + +
+
+
+
+
+ + + + diff --git a/SuperPower-uC/lowcost/SuperPower-uC-KiCad.sch b/SuperPower-uC/lowcost/SuperPower-uC-KiCad.sch index 49e5ed18..04364618 100644 --- a/SuperPower-uC/lowcost/SuperPower-uC-KiCad.sch +++ b/SuperPower-uC/lowcost/SuperPower-uC-KiCad.sch @@ -1,280 +1,280 @@ -EESchema Schematic File Version 4 -EELAYER 30 0 -EELAYER END -$Descr A4 11693 8268 -encoding utf-8 -Sheet 1 7 -Title "SuperPower-uC" -Date "2020-09-20" -Rev "0.1" -Comp "" -Comment1 "Licence: CERN-OHL-W" -Comment2 "" -Comment3 "" -Comment4 "" -$EndDescr -$Sheet -S 1300 2100 1250 1150 -U 5F639CFE -F0 "Battery Module" 50 -F1 "battery_protection.sch" 50 -F2 "VBAT" B R 2550 2550 50 -$EndSheet -$Sheet -S 3050 2100 1250 1150 -U 5F639F48 -F0 "Charging Module" 50 -F1 "charger.sch" 50 -F2 "SCL" I R 4300 2850 50 -F3 "SDA" I R 4300 2950 50 -F4 "INT" O R 4300 2700 50 -F5 "VCHARGE" I L 3050 3000 50 -F6 "CHARGE-DISABLE" I R 4300 3100 50 -F7 "VBAT" B L 3050 2550 50 -$EndSheet -$Sheet -S 4900 2100 1250 1150 -U 5F63A0E9 -F0 "Regulator Module" 50 -F1 "regulator.sch" 50 -F2 "3v3" O R 6150 2250 50 -F3 "5V" O R 6150 2400 50 -F4 "3v3_EN" I R 6150 2550 50 -F5 "5V_EN" I R 6150 2700 50 -F6 "3v3_MCU" O R 6150 2850 50 -F7 "INT" I R 6150 3000 50 -F8 "VBAT" I L 4900 2550 50 -$EndSheet -$Sheet -S 6850 2100 1250 1150 -U 5F63A193 -F0 "MCU Module" 50 -F1 "mcu.sch" 50 -F2 "3v3_MCU" I L 6850 2850 50 -F3 "SDA" B L 6850 3200 50 -F4 "SCL" I L 6850 3100 50 -F5 "TX" O R 8100 3050 50 -F6 "RX" I R 8100 3150 50 -F7 "RST" I R 8100 2850 50 -F8 "GPIO0" I R 8100 2950 50 -F9 "3v3" I L 6850 2250 50 -F10 "5V" I L 6850 2400 50 -F11 "Vin" O R 8100 2400 50 -$EndSheet -Wire Wire Line - 3050 4350 2950 4350 -Wire Wire Line - 2950 4350 2950 3000 -Wire Wire Line - 2950 3000 3050 3000 -Wire Wire Line - 2550 2550 2900 2550 -Wire Wire Line - 6850 2850 6550 2850 -Wire Wire Line - 4950 4100 4700 4100 -Wire Wire Line - 4700 4100 4700 3600 -Wire Wire Line - 4700 2550 4900 2550 -Text Notes 1400 2300 0 50 ~ 0 -Battery Holder -Text Notes 1400 2450 0 50 ~ 0 -Battery Protection -Text Notes 3450 2300 0 50 ~ 0 -Charger -Text Notes 3450 2400 0 50 ~ 0 -Fuel Gauge -Text Notes 5150 2300 0 50 ~ 0 -3v3_LDO -Text Notes 5150 2400 0 50 ~ 0 -3v3_LDO_MCU -Text Notes 5150 2500 0 50 ~ 0 -5V Buck/Boost -Text Notes 7400 2450 0 50 ~ 0 -MCU -Text Notes 5250 4350 0 50 ~ 0 -RTC -Text Notes 3600 4350 0 50 ~ 0 -USB-C -Text Notes 3600 4450 0 50 ~ 0 -Solar input -Text Notes 3600 4550 0 50 ~ 0 -Solder Pads -Text Notes 5250 4550 0 50 ~ 0 -Manual Wake -Wire Wire Line - 8100 3150 8350 3150 -Wire Wire Line - 8350 5400 4750 5400 -Wire Wire Line - 8350 3150 8350 5400 -Wire Wire Line - 8100 3050 8400 3050 -Wire Wire Line - 8400 3050 8400 5450 -Wire Wire Line - 8400 5450 4700 5450 -Text Notes 5250 4650 0 50 ~ 0 -Bypass Jumper -$Sheet -S 3050 4000 1250 1150 -U 5F63B107 -F0 "Charger I/O" 50 -F1 "charger_io.sch" 50 -F2 "VCHARGE" O L 3050 4350 50 -F3 "TX" O R 4300 4750 50 -F4 "RX" I R 4300 4850 50 -F5 "RST" O R 4300 5100 50 -F6 "GPIO0" O R 4300 5000 50 -F7 "Vin" I L 3050 5000 50 -$EndSheet -Text Notes 3450 2500 0 50 ~ 0 -Power on INT -Text Notes 3600 4650 0 50 ~ 0 -FTDI -Wire Wire Line - 4750 4750 4300 4750 -Wire Wire Line - 4750 4750 4750 5400 -Wire Wire Line - 4300 4850 4700 4850 -Wire Wire Line - 4700 4850 4700 5450 -Wire Wire Line - 8100 2950 8450 2950 -Wire Wire Line - 8450 2950 8450 5500 -Wire Wire Line - 8450 5500 4650 5500 -Wire Wire Line - 4650 5500 4650 5000 -Wire Wire Line - 4650 5000 4300 5000 -Wire Wire Line - 4300 5100 4600 5100 -Wire Wire Line - 4600 5100 4600 5550 -Wire Wire Line - 4600 5550 8500 5550 -Wire Wire Line - 8500 5550 8500 2850 -Wire Wire Line - 8500 2850 8100 2850 -Wire Wire Line - 4700 3600 2900 3600 -Wire Wire Line - 2900 3600 2900 2550 -Connection ~ 4700 3600 -Wire Wire Line - 4700 3600 4700 2550 -Connection ~ 2900 2550 -Wire Wire Line - 2900 2550 3050 2550 -Text Notes 5250 4450 0 50 ~ 0 -IO Expander -Text Notes 5250 4750 0 50 ~ 0 -I2C pullup -Wire Wire Line - 6500 4600 6500 2550 -Wire Wire Line - 6200 4600 6500 4600 -Wire Wire Line - 6150 2550 6500 2550 -Wire Wire Line - 6150 2700 6450 2700 -Wire Wire Line - 6450 2700 6450 4500 -Wire Wire Line - 6450 4500 6200 4500 -Wire Wire Line - 6850 2250 6150 2250 -Wire Wire Line - 6150 2400 6850 2400 -Wire Wire Line - 4300 3100 4500 3100 -Wire Wire Line - 4500 3100 4500 4650 -Wire Wire Line - 4500 4650 4800 4650 -Wire Wire Line - 4800 4650 4800 5000 -Wire Wire Line - 4800 5000 4950 5000 -$Sheet -S 4950 4000 1250 1150 -U 5F63A00B -F0 "RTC and Cut-Off Module" 50 -F1 "rtc_cut_off.sch" 50 -F2 "SCL" I R 6200 4100 50 -F3 "SDA" B R 6200 4200 50 -F4 "INT" O R 6200 4350 50 -F5 "VBAT" I L 4950 4100 50 -F6 "5V_EN" O R 6200 4500 50 -F7 "CHARGE-DISABLE" I L 4950 5000 50 -F8 "3v3V_EN" O R 6200 4600 50 -F9 "3v3_MCU" I R 6200 4700 50 -$EndSheet -Wire Wire Line - 8100 2400 8600 2400 -Wire Wire Line - 8600 2400 8600 5650 -Wire Wire Line - 8600 5650 2850 5650 -Wire Wire Line - 2850 5650 2850 5000 -Wire Wire Line - 2850 5000 3050 5000 -Wire Wire Line - 6200 4350 6400 4350 -Wire Wire Line - 6400 3000 6150 3000 -Wire Wire Line - 6400 3450 6400 3000 -Wire Wire Line - 6400 4350 6400 3450 -Connection ~ 6400 3450 -Wire Wire Line - 4650 3450 6400 3450 -Wire Wire Line - 4300 2700 4650 2700 -Wire Wire Line - 4650 2700 4650 3450 -Wire Wire Line - 4300 2850 4600 2850 -Wire Wire Line - 4300 2950 4550 2950 -Wire Wire Line - 4550 2950 4550 3550 -Wire Wire Line - 4600 2850 4600 3500 -Wire Wire Line - 6600 4100 6200 4100 -Wire Wire Line - 6650 4200 6200 4200 -Wire Wire Line - 6850 3100 6600 3100 -Wire Wire Line - 6850 3200 6650 3200 -Wire Wire Line - 6650 3200 6650 3550 -Wire Wire Line - 6650 3550 6650 4200 -Connection ~ 6650 3550 -Wire Wire Line - 4550 3550 6650 3550 -Wire Wire Line - 6600 3100 6600 3500 -Wire Wire Line - 6600 3500 6600 4100 -Connection ~ 6600 3500 -Wire Wire Line - 4600 3500 6600 3500 -Wire Wire Line - 6550 2850 6550 4700 -Wire Wire Line - 6550 4700 6200 4700 -Connection ~ 6550 2850 -Wire Wire Line - 6550 2850 6150 2850 -$EndSCHEMATC +EESchema Schematic File Version 4 +EELAYER 30 0 +EELAYER END +$Descr A4 11693 8268 +encoding utf-8 +Sheet 1 7 +Title "SuperPower-uC" +Date "2020-09-20" +Rev "0.1" +Comp "" +Comment1 "Licence: CERN-OHL-W" +Comment2 "" +Comment3 "" +Comment4 "" +$EndDescr +$Sheet +S 1300 2100 1250 1150 +U 5F639CFE +F0 "Battery Module" 50 +F1 "battery_protection.sch" 50 +F2 "VBAT" B R 2550 2550 50 +$EndSheet +$Sheet +S 3050 2100 1250 1150 +U 5F639F48 +F0 "Charging Module" 50 +F1 "charger.sch" 50 +F2 "SCL" I R 4300 2850 50 +F3 "SDA" I R 4300 2950 50 +F4 "INT" O R 4300 2700 50 +F5 "VCHARGE" I L 3050 3000 50 +F6 "CHARGE-DISABLE" I R 4300 3100 50 +F7 "VBAT" B L 3050 2550 50 +$EndSheet +$Sheet +S 4900 2100 1250 1150 +U 5F63A0E9 +F0 "Regulator Module" 50 +F1 "regulator.sch" 50 +F2 "3v3" O R 6150 2250 50 +F3 "5V" O R 6150 2400 50 +F4 "3v3_EN" I R 6150 2550 50 +F5 "5V_EN" I R 6150 2700 50 +F6 "3v3_MCU" O R 6150 2850 50 +F7 "INT" I R 6150 3000 50 +F8 "VBAT" I L 4900 2550 50 +$EndSheet +$Sheet +S 6850 2100 1250 1150 +U 5F63A193 +F0 "MCU Module" 50 +F1 "mcu.sch" 50 +F2 "3v3_MCU" I L 6850 2850 50 +F3 "SDA" B L 6850 3200 50 +F4 "SCL" I L 6850 3100 50 +F5 "TX" O R 8100 3050 50 +F6 "RX" I R 8100 3150 50 +F7 "RST" I R 8100 2850 50 +F8 "GPIO0" I R 8100 2950 50 +F9 "3v3" I L 6850 2250 50 +F10 "5V" I L 6850 2400 50 +F11 "Vin" O R 8100 2400 50 +$EndSheet +Wire Wire Line + 3050 4350 2950 4350 +Wire Wire Line + 2950 4350 2950 3000 +Wire Wire Line + 2950 3000 3050 3000 +Wire Wire Line + 2550 2550 2900 2550 +Wire Wire Line + 6850 2850 6550 2850 +Wire Wire Line + 4950 4100 4700 4100 +Wire Wire Line + 4700 4100 4700 3600 +Wire Wire Line + 4700 2550 4900 2550 +Text Notes 1400 2300 0 50 ~ 0 +Battery Holder +Text Notes 1400 2450 0 50 ~ 0 +Battery Protection +Text Notes 3450 2300 0 50 ~ 0 +Charger +Text Notes 3450 2400 0 50 ~ 0 +Fuel Gauge +Text Notes 5150 2300 0 50 ~ 0 +3v3_LDO +Text Notes 5150 2400 0 50 ~ 0 +3v3_LDO_MCU +Text Notes 5150 2500 0 50 ~ 0 +5V Buck/Boost +Text Notes 7400 2450 0 50 ~ 0 +MCU +Text Notes 5250 4350 0 50 ~ 0 +RTC +Text Notes 3600 4350 0 50 ~ 0 +USB-C +Text Notes 3600 4450 0 50 ~ 0 +Solar input +Text Notes 3600 4550 0 50 ~ 0 +Solder Pads +Text Notes 5250 4550 0 50 ~ 0 +Manual Wake +Wire Wire Line + 8100 3150 8350 3150 +Wire Wire Line + 8350 5400 4750 5400 +Wire Wire Line + 8350 3150 8350 5400 +Wire Wire Line + 8100 3050 8400 3050 +Wire Wire Line + 8400 3050 8400 5450 +Wire Wire Line + 8400 5450 4700 5450 +Text Notes 5250 4650 0 50 ~ 0 +Bypass Jumper +$Sheet +S 3050 4000 1250 1150 +U 5F63B107 +F0 "Charger I/O" 50 +F1 "charger_io.sch" 50 +F2 "VCHARGE" O L 3050 4350 50 +F3 "TX" O R 4300 4750 50 +F4 "RX" I R 4300 4850 50 +F5 "RST" O R 4300 5100 50 +F6 "GPIO0" O R 4300 5000 50 +F7 "Vin" I L 3050 5000 50 +$EndSheet +Text Notes 3450 2500 0 50 ~ 0 +Power on INT +Text Notes 3600 4650 0 50 ~ 0 +FTDI +Wire Wire Line + 4750 4750 4300 4750 +Wire Wire Line + 4750 4750 4750 5400 +Wire Wire Line + 4300 4850 4700 4850 +Wire Wire Line + 4700 4850 4700 5450 +Wire Wire Line + 8100 2950 8450 2950 +Wire Wire Line + 8450 2950 8450 5500 +Wire Wire Line + 8450 5500 4650 5500 +Wire Wire Line + 4650 5500 4650 5000 +Wire Wire Line + 4650 5000 4300 5000 +Wire Wire Line + 4300 5100 4600 5100 +Wire Wire Line + 4600 5100 4600 5550 +Wire Wire Line + 4600 5550 8500 5550 +Wire Wire Line + 8500 5550 8500 2850 +Wire Wire Line + 8500 2850 8100 2850 +Wire Wire Line + 4700 3600 2900 3600 +Wire Wire Line + 2900 3600 2900 2550 +Connection ~ 4700 3600 +Wire Wire Line + 4700 3600 4700 2550 +Connection ~ 2900 2550 +Wire Wire Line + 2900 2550 3050 2550 +Text Notes 5250 4450 0 50 ~ 0 +IO Expander +Text Notes 5250 4750 0 50 ~ 0 +I2C pullup +Wire Wire Line + 6500 4600 6500 2550 +Wire Wire Line + 6200 4600 6500 4600 +Wire Wire Line + 6150 2550 6500 2550 +Wire Wire Line + 6150 2700 6450 2700 +Wire Wire Line + 6450 2700 6450 4500 +Wire Wire Line + 6450 4500 6200 4500 +Wire Wire Line + 6850 2250 6150 2250 +Wire Wire Line + 6150 2400 6850 2400 +Wire Wire Line + 4300 3100 4500 3100 +Wire Wire Line + 4500 3100 4500 4650 +Wire Wire Line + 4500 4650 4800 4650 +Wire Wire Line + 4800 4650 4800 5000 +Wire Wire Line + 4800 5000 4950 5000 +$Sheet +S 4950 4000 1250 1150 +U 5F63A00B +F0 "RTC and Cut-Off Module" 50 +F1 "rtc_cut_off.sch" 50 +F2 "SCL" I R 6200 4100 50 +F3 "SDA" B R 6200 4200 50 +F4 "INT" O R 6200 4350 50 +F5 "VBAT" I L 4950 4100 50 +F6 "5V_EN" O R 6200 4500 50 +F7 "CHARGE-DISABLE" I L 4950 5000 50 +F8 "3v3V_EN" O R 6200 4600 50 +F9 "3v3_MCU" I R 6200 4700 50 +$EndSheet +Wire Wire Line + 8100 2400 8600 2400 +Wire Wire Line + 8600 2400 8600 5650 +Wire Wire Line + 8600 5650 2850 5650 +Wire Wire Line + 2850 5650 2850 5000 +Wire Wire Line + 2850 5000 3050 5000 +Wire Wire Line + 6200 4350 6400 4350 +Wire Wire Line + 6400 3000 6150 3000 +Wire Wire Line + 6400 3450 6400 3000 +Wire Wire Line + 6400 4350 6400 3450 +Connection ~ 6400 3450 +Wire Wire Line + 4650 3450 6400 3450 +Wire Wire Line + 4300 2700 4650 2700 +Wire Wire Line + 4650 2700 4650 3450 +Wire Wire Line + 4300 2850 4600 2850 +Wire Wire Line + 4300 2950 4550 2950 +Wire Wire Line + 4550 2950 4550 3550 +Wire Wire Line + 4600 2850 4600 3500 +Wire Wire Line + 6600 4100 6200 4100 +Wire Wire Line + 6650 4200 6200 4200 +Wire Wire Line + 6850 3100 6600 3100 +Wire Wire Line + 6850 3200 6650 3200 +Wire Wire Line + 6650 3200 6650 3550 +Wire Wire Line + 6650 3550 6650 4200 +Connection ~ 6650 3550 +Wire Wire Line + 4550 3550 6650 3550 +Wire Wire Line + 6600 3100 6600 3500 +Wire Wire Line + 6600 3500 6600 4100 +Connection ~ 6600 3500 +Wire Wire Line + 4600 3500 6600 3500 +Wire Wire Line + 6550 2850 6550 4700 +Wire Wire Line + 6550 4700 6200 4700 +Connection ~ 6550 2850 +Wire Wire Line + 6550 2850 6150 2850 +$EndSCHEMATC diff --git a/SuperPower-uC/lowcost/SuperPower-uC-KiCad.xlsx b/SuperPower-uC/lowcost/SuperPower-uC-KiCad.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..054b716fb1d1c3f0e887c888eaff445b670ef8f3 GIT binary patch literal 19344 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