"""
MSP430-FR2355 datasheet
Data extracted from https://www.ti.com/lit/ds/symlink/msp430fr2355.pdf
"""

#'I_to_consider': 'min', # Current consumption of the ADC to consider (min, max, avg)
datasheet = {
    'family': 'MSP430FR',                # MCU Family
    'registers': 16,                     # Number of general-purpose registers
    'reserved_registers': 4,             # Number of reserved registers (e.g. stack pointer, program counter)
    'register_size': 16,                 # Number of bits for each register
    'memory_cell_size': 16,              # Number of bits for each memory cell
    'volatile_memory_size': '4K',        # Memory size in bytes
    'non_volatile_memory_size': '32K',   # Memory size in bytes
    'has_nvm': True,
    'has_adc': True,
    'LPM': {                    # Low power modes
        'LPM3': {
            'V': '2.2',         # Measurement Voltage of I
            'I': '1.43u',       # Current draw in low-power mode
            'V_min': '1.75',    # Minimum voltage to sustain low-power mode (V_svs)
            't_wakeup': '10u',  # Wakeup time
        },
        'LPM4': {
            'V': '2',          # Measurement Voltage of I
            'I': '0.82u',      # Current draw in low-power mode
            'V_min': '1.75',   # Minimum voltage to sustain low-power mode (V_svs)
            't_wakeup': '10u', # Wakeup time
        },
    },
    'ADC': {
        'T_off_on': '100n',     # Time to wait for switching the ADC on
        'T_sampling': '0.52u',     # Time to get a sample
        'I_min': '280u',        # Minimum current draw of the ADC when it is active
        'I_max': '280u',        # Maximum current draw of the ADC when it is active
        'N_init': '3',          # Number of instructions to init the ADC
        # set ADC mode(single); set ADC op_type(read); set ADC on
        'N_off': '1',           # Number of instructions to stop the ADC
        # set ADC mode(off)
        'N_transfer_ops': '1',  # Number of instructions to retrieve data from the ADC
        # var_data <- REG_ADC
        'V_min': '2.0',         # Minimum operating voltage for the ADC module
        'V': '3.0',             # Voltage of datasheet measures
    },
    'default_frequency': '1MHz',
    'frequencies': {
        '1MHz': {
            'frequency': '1M',        # Clock frequency
            'V_min': '1.8',           # Minimum operating voltage
            'V_max': '3.6',           # Maximum operating voltage
            'V': '3.0',               # Voltage of datasheet measures
            'n_waits': '0',           # Wait states of FRAM accesses
            'I_am_fram_uni': '368u',  # Current draw when program and data resides in FRAM (same value as 0.66 cache hit)
            'I_am_fram': {            # List of current draw / cache hit when program resides in FRAM and data in SRAM
                '0.00': {'I': '555u', 'hit': '0.00'},
                '1.0': {'I': '272u', 'hit': '1.0'},
            },
            'I_am_ram': '285u',       # Current draw when program and data resides in SRAM
            'I_am_ram_only': '255u',  # Current draw when program and data resides in SRAM (FRAM off)
        },
        '8MHz': {
            'frequency': '8M',        # Clock frequency
            'V_min': '1.8',           # Minimum operating voltage
            'V_max': '3.6',           # Maximum operating voltage
            'V': '3.0',               # Voltage of datasheet measures
            'n_waits': '0',           # Wait states of FRAM accesses
            'I_am_fram_uni': '1526u',  # Current draw when program and data resides in FRAM
            'I_am_fram': {            # List of current draw / cache hit when program resides in FRAM and data in SRAM
                '0.00': {'I': '3084u', 'hit': '0.00'},
                '1.0': {'I': '724u', 'hit': '1.0'},
            },
            'I_am_ram': '917u',       # Current draw when program and data resides in SRAM
            'I_am_ram_only': '887u',  # Current draw when program and data resides in SRAM (FRAM off)
        },
        '16MHz': {
            'frequency': '16M',        # Clock frequency
            'V_min': '1.8',           # Minimum operating voltage
            'V_max': '3.6',           # Maximum operating voltage
            'V': '3.0',               # Voltage of datasheet measures
            'n_waits': '1',           # Wait states of FRAM accesses
            'I_am_fram_uni': '1981u',  # Current draw when program and data resides in FRAM
            'I_am_fram': {            # List of current draw / cache hit when program resides in FRAM and data in SRAM
                '0.00': {'I': '3411u', 'hit': '0.00'},
                '1.0': {'I': '1245u', 'hit': '1.0'},
            },
            'I_am_ram': '1627u',       # Current draw when program and data resides in SRAM
            'I_am_ram_only': '1597u',  # Current draw when program and data resides in SRAM (FRAM off)
        },
        '24MHz': {
            'frequency': '24M',  # Clock frequency
            'V_min': '1.8',  # Minimum operating voltage
            'V_max': '3.6',  # Maximum operating voltage
            'V': '3.0',  # Voltage of datasheet measures
            'n_waits': '2',  # Wait states of FRAM accesses
            'I_am_fram_uni': '2424u',  # Current draw when program and data resides in FRAM
            'I_am_fram': {  # List of current draw / cache hit when program resides in FRAM and data in SRAM
                '0.00': {'I': '3692u', 'hit': '0.00'},
                '1.0': {'I': '1772u', 'hit': '1.0'},
            },
            'I_am_ram': '2355u',  # Current draw when program and data resides in SRAM
            'I_am_ram_only': '2325u',  # Current draw when program and data resides in SRAM (FRAM off)
        },
    },
}