shepherd-core 2023.12.1__py3-none-any.whl → 2024.4.1__py3-none-any.whl

shepherd_core/data_models/content/virtual_source_fixture.yaml

@@ -1,229 +0,0 @@
-# info:
-# - compendium of all parameters & description
-# - base for neutral fallback values if provided yml is sparse
-# - -> it is encouraged to omit redundant parameters
----
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1000
-    name: neutral
-    description: Direct feed-through of energy environment with no converter (allows on-off-patters)
-    # General Config
-    enable_boost: false # if false -> v_intermediate = v_input, output-switch-hysteresis is still usable
-    enable_buck: false # if false -> v_output = v_intermediate
-
-    interval_startup_delay_drain_ms: 0
-
-    harvester:
-      name: mppt_opt # harvester only active if input is "ivcurves"
-
-    V_input_max_mV: 10000
-    I_input_max_mA: 4200
-    V_input_drop_mV: 0.0  # simulate input-diode
-    R_input_mOhm: 0.0  # resistance only active with disabled boost, range [1 mOhm; 1MOhm]
-
-    C_intermediate_uF: 0.0  # primary storage-Cap
-    V_intermediate_init_mV: 3000 # allow a proper / fast startup
-    I_intermediate_leak_nA: 0.0
-
-    V_intermediate_enable_threshold_mV: 1 # -> target gets connected (hysteresis-combo with next value)
-    V_intermediate_disable_threshold_mV: 0 # -> target gets disconnected
-    interval_check_thresholds_ms: 0.0  # some BQs check every 64 ms if output should be disconnected
-
-    V_pwr_good_enable_threshold_mV: 2800 # target is informed by pwr-good on output-pin (hysteresis) -> for intermediate voltage
-    V_pwr_good_disable_threshold_mV: 2200
-    immediate_pwr_good_signal: true  # 1: activate instant schmitt-trigger, 0: stay in interval for checking thresholds
-
-    C_output_uF: 1.0   # final (always last) stage to compensate undetectable current spikes when enabling power for target
-
-    # Extra
-    V_output_log_gpio_threshold_mV: 1400  # min voltage needed to enable recording changes in gpio-bank
-
-    # Boost Converter
-    V_input_boost_threshold_mV: 0.0 # min input-voltage for the boost converter to work
-    V_intermediate_max_mV: 10000 # -> boost converter shuts off
-
-    LUT_input_efficiency: [
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ], # rows are current -> here a[V=0][:]
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-      [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ],
-    ] # input-array[12][12] depending on array[inp_voltage][log(inp_current)], influence of cap-voltage is not implemented
-    LUT_input_V_min_log2_uV: 0 # 2^7 = 128 uV -> array[0] is for inputs < 128 uV
-    LUT_input_I_min_log2_nA: 0 # 2^8 = 256 nA -> array[0] is for inputs < 256 nA
-
-    # Buck-converter
-    V_output_mV: 2400
-    V_buck_drop_mV: 0.0  # simulate LDO min voltage differential or output-diode
-
-    LUT_output_efficiency: [ 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00, 1.00 ] # array[12] depending on output_current
-    LUT_output_I_min_log2_nA: 0  # 2^8 = 256 nA -> array[0] is for inputs < 256 nA, see notes on LUT_input for explanation
-
-    owner: Ingmar
-    group: NES Lab
-    visible2group: true
-    visible2all: true
-    created: 2022-12-12 12:12:12
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1010
-    name: direct
-    inherit_from: neutral
-    # Note: current input has no influence
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1011
-    name: diode+capacitor
-    description: Simple Converter based on diode and buffer capacitor
-    inherit_from: neutral
-    V_input_drop_mV: 300  # simulate input-diode
-    C_intermediate_uF: 10  # primary storage-Cap
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1012
-    name: dio_cap # simpler naming
-    inherit_from: diode+capacitor
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1013
-    name: diode+resistor+capacitor
-    description: Simple Converter based on diode, current limiting resistor and buffer capacitor
-    inherit_from: diode+capacitor
-    R_input_mOhm: 10000
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1014
-    name: dio_res_cap # simpler naming
-    inherit_from: diode+resistor+capacitor
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1020
-    name: BQ25504
-    description: TI BQ25504 with integrated boost-converter
-    inherit_from: neutral # to complete undefined vars
-    enable_boost: true # if false -> v_intermediate = v_input, output-switch-hysteresis is still usable
-
-    harvester:
-      name: mppt_bq_solar # harvester only active if input is "ivcurves"
-
-    V_input_max_mV: 3000
-    I_input_max_mA: 100
-
-    C_intermediate_uF: 22.0  # primary storage-Cap
-    V_intermediate_init_mV: 3000 # allow a proper / fast startup
-    I_intermediate_leak_nA: 330
-
-    V_intermediate_enable_threshold_mV: 2600 # -> target gets connected (hysteresis-combo with next value)
-    V_intermediate_disable_threshold_mV: 2300 # -> target gets disconnected
-    interval_check_thresholds_ms: 64.0  # some BQs check every 64 ms if output should be disconnected
-
-    V_pwr_good_enable_threshold_mV: 2800 # target is informed by pwr-good on output-pin (hysteresis) -> for intermediate voltage
-    V_pwr_good_disable_threshold_mV: 2400
-    immediate_pwr_good_signal: false  # 1: activate instant schmitt-trigger, 0: stay in interval for checking thresholds
-
-    # Boost Converter
-    V_input_boost_threshold_mV: 130 # min input-voltage for the boost converter to work
-    V_intermediate_max_mV: 3600 # -> boost converter shuts off
-
-    LUT_input_efficiency: [
-      # <8uA  8uA   16uA  32uA  64uA  128uA 256uA 512uA 1mA   2mA   4mA   >8mA
-      [ 0.01, 0.01, 0.02, 0.05, 0.10, 0.15, 0.15, 0.20, 0.25, 0.30, 0.30, 0.35 ], # < 128 mV
-      [ 0.10, 0.20, 0.30, 0.40, 0.50, 0.55, 0.56, 0.57, 0.58, 0.59, 0.60, 0.61 ], # > 128 mV, ~200
-      [ 0.20, 0.40, 0.50, 0.60, 0.65, 0.66, 0.67, 0.68, 0.69, 0.70, 0.71, 0.72 ], # > 256 mV, ~320
-      [ 0.35, 0.55, 0.65, 0.71, 0.73, 0.74, 0.75, 0.75, 0.76, 0.77, 0.77, 0.78 ], # > 384 mV, ~450
-      [ 0.45, 0.65, 0.70, 0.73, 0.75, 0.77, 0.78, 0.79, 0.80, 0.81, 0.81, 0.82 ], # > 512 mV, ~570
-      [ 0.50, 0.70, 0.74, 0.76, 0.78, 0.79, 0.80, 0.81, 0.82, 0.83, 0.83, 0.84 ], # > 640 mV
-      [ 0.52, 0.73, 0.76, 0.78, 0.80, 0.81, 0.82, 0.83, 0.84, 0.85, 0.85, 0.86 ], # > 768 mV
-      [ 0.53, 0.75, 0.77, 0.79, 0.81, 0.82, 0.83, 0.84, 0.85, 0.86, 0.86, 0.87 ], # > 896 mV
-      [ 0.55, 0.77, 0.78, 0.80, 0.82, 0.83, 0.85, 0.86, 0.87, 0.87, 0.87, 0.88 ], # > 1024 mV
-      [ 0.56, 0.78, 0.79, 0.81, 0.83, 0.85, 0.87, 0.88, 0.88, 0.88, 0.88, 0.89 ], # > 1152 mV
-      [ 0.58, 0.79, 0.80, 0.82, 0.84, 0.86, 0.88, 0.89, 0.89, 0.89, 0.89, 0.90 ], # > 1280 mV
-      [ 0.60, 0.80, 0.81, 0.83, 0.85, 0.87, 0.89, 0.90, 0.90, 0.90, 0.90, 0.90 ], # > 1408 mV
-    ] # input-array[12][12] depending on array[inp_voltage][log(inp_current)], influence of cap-voltage is not implemented
-    LUT_input_V_min_log2_uV: 17 # example: 2^7 = 128 uV -> array[0] is for inputs < 128 uV
-    LUT_input_I_min_log2_nA: 13 # example: 2^8 = 256 nA -> array[0] is for inputs < 256 nA
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1021
-    name: BQ25504s # Version with Schmitt-Trigger
-    description: TI BQ25504 with Schmitt-Trigger for a faster power-good-signal
-    inherit_from: BQ25504
-    immediate_pwr_good_signal: true
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1022
-    name: BQ25504-Schmitt
-    inherit_from: BQ25504s
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1030
-    name: BQ25570
-    description: TI BQ25570 with integrated boost- & buck-converter
-    inherit_from: BQ25504 # inherit Input-LUT that is similar enough
-    enable_boost: true # if false -> v_intermediate = v_input, output-switch-hysteresis is still usable
-    enable_buck: true # if false -> v_output = v_intermediate
-
-    V_input_max_mV: 5100
-    I_input_max_mA: 100
-
-    C_intermediate_uF: 33.0  # primary storage-Cap
-    V_intermediate_init_mV: 3400 # allow a proper / fast startup
-    I_intermediate_leak_nA: 0.0
-
-    V_intermediate_enable_threshold_mV: 3000 # -> target gets connected (hysteresis-combo with next value)
-    V_intermediate_disable_threshold_mV: 2400 # -> target gets disconnected
-    interval_check_thresholds_ms: 64.0  # some BQs check every 64 ms if output should be disconnected
-
-    V_pwr_good_enable_threshold_mV: 3000 # target is informed by pwr-good on output-pin (hysteresis) -> for intermediate voltage
-    V_pwr_good_disable_threshold_mV: 2500
-    immediate_pwr_good_signal: false  # 1: activate instant schmitt-trigger, 0: stay in interval for checking thresholds
-
-    C_output_uF: 1.0   # final (always last) stage to compensate undetectable current spikes when enabling power for target
-
-    # Boost Converter
-    V_input_boost_threshold_mV: 100.0 # min input-voltage for the boost converter to work
-    V_intermediate_max_mV: 5500 # -> boost converter shuts off
-
-    # Buck Converter
-    V_output_mV: 2200
-    V_buck_drop_mV: 200.0  # simulate LDO min voltage differential or output-diode
-
-    #                        <1u   1u    2u    4u    8u    16u   32u   64u   128u  256u  512u  >1m
-    LUT_output_efficiency: [ 0.40, 0.50, 0.60, 0.73, 0.82, 0.86, 0.88, 0.90, 0.91, 0.92, 0.93, 0.92] # array[12] depending on output_current
-    LUT_output_I_min_log2_nA: 10  # example: 2^8 = 256 nA -> array[0] is for inputs < 256 nA, see notes on LUT_input for explanation
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1031
-    name: BQ25570s
-    description: TI BQ25570 with Schmitt-Trigger for a faster power-good-signal
-    inherit_from: BQ25570
-    immediate_pwr_good_signal: true
-
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1032
-    name: BQ25570-Schmitt
-    inherit_from: BQ25570s
-- datatype: VirtualSourceConfig
-  parameters:
-    id: 1033
-    name: default
-    inherit_from: BQ25570s

shepherd_core/data_models/testbed/cape_fixture.yaml

@@ -1,94 +0,0 @@
----
-
-# more human-readable test-protocol @
-# https://github.com/orgua/shepherd_v2_planning/blob/main/doc_testbed/Cape_pre-deployment-tests.xlsx
-- datatype: cape
-  parameters:
-    id: 1270051
-    name: cape51
-    version: v2.4b
-    description: full version with Hrv & Emu, modded gpio,emu,hrv
-    created: 2022-10-07
-    calibrated: 2023-09-21
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270052
-    name: cape52
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270053
-    name: cape53
-    description: full version with Hrv & Emu, partially modded
-    comment: 1st Lab Prototype, burned VReg -> currently defective
-    active: false
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270054
-    name: cape54
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270055
-    name: cape55
-    comment: Target-Port B, C-Meas failed on first Cal
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270056
-    name: cape56
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270057
-    name: cape57
-    comment: 2nd Lab Prototype, has stackable headers
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270058
-    name: cape58
-    comment: has shields on emu & hrv-circuits -> no effect on RF-Performance
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270059
-    name: cape59
-    comment: only 220u/440uF on 5V
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270060
-    name: cape60
-    comment: 3rd Lab Prototype
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270061
-    name: cape61
-    comment: only 220u/440uF on 5V
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270062
-    name: cape62
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270063
-    name: cape63
-    comment: only 220u/440uF on 5V
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270064
-    name: cape64
-    comment: only 220u/440uF on 5V, had 6x74LVC2T45GT flippend (U11,12,23,24,27,28) - hot air repair
-- datatype: cape
-  parameters:
-    inherit_from: cape51
-    id: 1270065
-    name: cape65
-    comment: only 220u/440uF on 5V

shepherd_core/data_models/testbed/gpio_fixture.yaml

@@ -1,166 +0,0 @@
---- # add with >>> python manage.py loaddata <fixturename>
-# cape v2.4
-- datatype: gpio
-  parameters:
-    id: 1000
-    name: GPIO0
-    # description:
-    # comment:
-    direction: IO
-    dir_switch: DIR1
-    reg_pru: r31_00
-    pin_pru: P8_45
-    reg_sys: 26
-    pin_sys: P8_14
-- datatype: gpio
-  parameters:
-    id: 1001
-    name: GPIO1
-    direction: IO
-    dir_switch: DIR1
-    reg_pru: r31_01
-    pin_pru: P8_46
-    reg_sys: 27
-    pin_sys: P8_17
-- datatype: gpio
-  parameters:
-    id: 1002
-    name: GPIO2
-    direction: IO
-    dir_switch: DIR1
-    reg_pru: r31_02
-    pin_pru: P8_43
-    reg_sys: 46
-    pin_sys: P8_16
-- datatype: gpio
-  parameters:
-    id: 1003
-    name: GPIO3
-    direction: IO
-    dir_switch: DIR1
-    reg_pru: r31_03
-    pin_pru: P8_44
-    reg_sys: 47
-    pin_sys: P8_15
-- datatype: gpio
-  parameters:
-    id: 1004
-    name: GPIO4
-    direction: IN
-    reg_pru: r31_04
-    pin_pru: P8_41
-    reg_sys: 61
-    pin_sys: P8_26
-- datatype: gpio
-  parameters:
-    id: 1005
-    name: GPIO5
-    direction: IN
-    reg_pru: r31_05
-    pin_pru: P8_42
-    reg_sys: 80
-    pin_sys: P8_36
-- datatype: gpio
-  parameters:
-    id: 1006
-    name: GPIO6
-    direction: IN
-    reg_pru: r31_06
-    pin_pru: P8_39
-    reg_sys: 81
-    pin_sys: P8_34
-- datatype: gpio
-  parameters:
-    id: 1007
-    name: GPIO7
-    description: alias UART_RX
-    direction: IN
-    reg_pru: r31_07
-    pin_pru: P8_40
-    reg_sys: 14
-    pin_sys: P9_26
-- datatype: gpio
-  parameters:
-    id: 1008
-    name: GPIO8
-    description: alias UART_TX
-    direction: IO
-    dir_switch: DIR2
-    reg_pru: r31_08
-    pin_pru: P8_27
-    reg_sys: 15
-    pin_sys: P9_24
-- datatype: gpio
-  parameters:
-    id: 1009
-    name: BAT_OK
-    description: signal from vSource (PRU) to target
-    direction: OUT
-    reg_pru: r30_09
-    pin_pru: P8_29
-- datatype: gpio
-  parameters:
-    id: 2000
-    name: PRG1_CLK
-    description: alias JTAG_TCK
-    direction: OUT
-    reg_sys: 5
-    pin_sys: P9_17
-- datatype: gpio
-  parameters:
-    id: 2001
-    name: PRG1_IO
-    description: alias JTAG_TDI
-    direction: IO
-    dir_switch: PDIR1
-    reg_sys: 4
-    pin_sys: P9_18
-- datatype: gpio
-  parameters:
-    id: 2010
-    name: PRG2_CLK
-    description: alias JTAG_TDO
-    direction: OUT
-    reg_sys: 8
-    pin_sys: P8_35
-- datatype: gpio
-  parameters:
-    id: 2011
-    name: PRG2_IO
-    description: alias JTAG_TMS
-    direction: IO
-    dir_switch: PDIR2
-    reg_sys: 9
-    pin_sys: P8_33
-- datatype: gpio
-  parameters:
-    id: 3000
-    name: DIR1
-    description: changes direction of GPIO[0:3]
-    direction: OUT
-    reg_sys: 78
-    pin_sys: P8_37
-- datatype: gpio
-  parameters:
-    id: 3001
-    name: DIR2
-    description: changes direction of GPIO8
-    direction: OUT
-    reg_sys: 79
-    pin_sys: P8_38
-- datatype: gpio
-  parameters:
-    id: 3002
-    name: PDIR1
-    description: changes direction PRG1_IO
-    direction: OUT
-    reg_sys: 10
-    pin_sys: P8_31
-- datatype: gpio
-  parameters:
-    id: 3003
-    name: PDIR2
-    description: changes direction PRG2_IO
-    direction: OUT
-    reg_sys: 11
-    pin_sys: P8_32

shepherd_core/data_models/testbed/mcu_fixture.yaml

@@ -1,19 +0,0 @@
---- # add with >>> python manage.py loaddata <fixturename>
-- datatype: mcu
-  parameters:
-    id: 1001
-    name: nRF52
-    description: Panasonic PAN1780, ENW-89854A1KF, Bluetooth 5 Low Energy Module
-    platform: nRF52
-    core: nRF52840
-    prog_protocol: SWD
-    fw_name_default: nrf52_demo_rf
-- datatype: mcu
-  parameters:
-    id: 1002
-    name: MSP430FR
-    description: 16MHz Ultra-Low-Pwr MCU with 128 KB FRAM
-    platform: MSP430
-    core: MSP430FR5962
-    prog_protocol: SBW
-    fw_name_default: msp430_deep_sleep