power.h File Reference

#include <list>
#include "vpr_types.h"
#include "PowerSpicedComponent.h"

Include dependency graph for power.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	s_solution_inf
struct	s_transistor_size_inf
struct	s_transistor_inf
struct	s_power_nmos_mux_inf
struct	s_power_nmos_leakage_inf
struct	s_power_tech
struct	s_power_buffer_size_inf
struct	s_power_mux_volt_inf
struct	s_power_mux_volt_pair
struct	s_power_buffer_strength_inf
struct	s_power_buffer_sc_levr_inf
struct	s_power_nmos_leakage_pair
struct	s_power_output
struct	s_log
struct	s_power_mux_info
struct	s_power_commonly_used
struct	s_rr_node_power
struct	s_mux_arch
struct	s_mux_node

Macros
#define	MAX_LOGS   10000
#define	CLOCK_PROB   0.5
#define	CLOCK_DENS   2

Typedefs
typedef struct s_power_output	t_power_output
typedef struct s_log	t_log
typedef struct s_power_commonly_used	t_power_commonly_used
typedef struct s_power_mux_volt_inf	t_power_mux_volt_inf
typedef struct s_power_mux_volt_pair	t_power_mux_volt_pair
typedef struct s_power_nmos_leakages	t_power_nmos_leakages
typedef struct s_power_nmos_leakage_pair	t_power_nmos_leakage_pair
typedef struct s_power_buffer_sc_levr_inf	t_power_buffer_sc_levr_inf
typedef struct s_power_tech	t_power_tech
typedef struct s_transistor_inf	t_transistor_inf
typedef struct s_transistor_size_inf	t_transistor_size_inf
typedef struct s_rr_node_power	t_rr_node_power
typedef struct s_power_buffer_size_inf	t_power_buffer_size_inf
typedef struct s_power_buffer_strength_inf	t_power_buffer_strength_inf
typedef struct s_mux_node	t_mux_node
typedef struct s_mux_arch	t_mux_arch
typedef struct s_solution_inf	t_solution_inf
typedef struct s_power_nmos_mux_inf	t_power_nmos_mux_inf
typedef struct s_power_nmos_leakage_inf	t_power_nmos_leakage_inf
typedef struct s_power_mux_info	t_power_mux_info

Enumerations
enum	e_power_ret_code { POWER_RET_CODE_SUCCESS = 0, POWER_RET_CODE_ERRORS, POWER_RET_CODE_WARNINGS }
enum	e_power_log_type { POWER_LOG_ERROR, POWER_LOG_WARNING, POWER_LOG_NUM_TYPES }
enum	e_tx_type { NMOS, PMOS }

Functions
boolean	power_init (char *power_out_filepath, char *cmos_tech_behavior_filepath, t_arch *arch, t_det_routing_arch *routing_arch)
boolean	power_uninit (void)
e_power_ret_code	power_total (float *run_time_s, t_vpr_setup vpr_setup, t_arch *arch, t_det_routing_arch *routing_arch)

Variables
t_solution_inf	g_solution_inf
t_power_output *	g_power_output
t_power_commonly_used *	g_power_commonly_used
t_power_tech *	g_power_tech
t_power_arch *	g_power_arch

Macro Definition Documentation

#define CLOCK_DENS   2

Definition at line 37 of file power.h.

#define CLOCK_PROB   0.5

Definition at line 36 of file power.h.

#define MAX_LOGS   10000

This is the top-level file for power estimation in VTR

Definition at line 33 of file power.h.

Typedef Documentation

typedef struct s_log t_log

Definition at line 61 of file power.h.

typedef struct s_mux_arch t_mux_arch

Definition at line 75 of file power.h.

typedef struct s_mux_node t_mux_node

Definition at line 74 of file power.h.

typedef struct s_power_buffer_sc_levr_inf t_power_buffer_sc_levr_inf

Definition at line 67 of file power.h.

typedef struct s_power_buffer_size_inf t_power_buffer_size_inf

Definition at line 72 of file power.h.

typedef struct s_power_buffer_strength_inf t_power_buffer_strength_inf

Definition at line 73 of file power.h.

typedef struct s_power_commonly_used t_power_commonly_used

Definition at line 62 of file power.h.

typedef struct s_power_mux_info t_power_mux_info

Definition at line 79 of file power.h.

typedef struct s_power_mux_volt_inf t_power_mux_volt_inf

Definition at line 63 of file power.h.

typedef struct s_power_mux_volt_pair t_power_mux_volt_pair

Definition at line 64 of file power.h.

typedef struct s_power_nmos_leakage_inf t_power_nmos_leakage_inf

Definition at line 78 of file power.h.

typedef struct s_power_nmos_leakage_pair t_power_nmos_leakage_pair

Definition at line 66 of file power.h.

typedef struct s_power_nmos_leakages t_power_nmos_leakages

Definition at line 65 of file power.h.

typedef struct s_power_nmos_mux_inf t_power_nmos_mux_inf

Definition at line 77 of file power.h.

typedef struct s_power_output t_power_output

Definition at line 60 of file power.h.

typedef struct s_power_tech t_power_tech

Definition at line 68 of file power.h.

typedef struct s_rr_node_power t_rr_node_power

Definition at line 71 of file power.h.

typedef struct s_solution_inf t_solution_inf

Definition at line 76 of file power.h.

typedef struct s_transistor_inf t_transistor_inf

Definition at line 69 of file power.h.

typedef struct s_transistor_size_inf t_transistor_size_inf

Definition at line 70 of file power.h.

Enumeration Type Documentation

enum e_power_log_type

Enumerator
POWER_LOG_ERROR
POWER_LOG_WARNING
POWER_LOG_NUM_TYPES

Definition at line 47 of file power.h.

             {
    POWER_LOG_ERROR, POWER_LOG_WARNING, POWER_LOG_NUM_TYPES
} e_power_log_type;

enum e_power_ret_code

Enumerator
POWER_RET_CODE_SUCCESS
POWER_RET_CODE_ERRORS
POWER_RET_CODE_WARNINGS

Definition at line 42 of file power.h.

             {
    POWER_RET_CODE_SUCCESS = 0, POWER_RET_CODE_ERRORS, POWER_RET_CODE_WARNINGS
} e_power_ret_code;

enum e_tx_type

Enumerator
NMOS
PMOS

Definition at line 88 of file power.h.

             {
    NMOS, PMOS
} e_tx_type;

Function Documentation

boolean power_init	(	char *	power_out_filepath,
		char *	cmos_tech_behavior_filepath,
		t_arch *	arch,
		t_det_routing_arch *	routing_arch
	)

Initialization for all power-related functions

Definition at line 1270 of file power.c.

                                           {
    boolean error = FALSE;

    /* Set global power architecture & options */
    g_power_arch = arch->power;
    g_power_commonly_used = new t_power_commonly_used;
    g_power_tech = (t_power_tech*) my_malloc(sizeof(t_power_tech));
    g_power_output = (t_power_output*) my_malloc(sizeof(t_power_output));

    /* Set up Logs */
    g_power_output->num_logs = POWER_LOG_NUM_TYPES;
    g_power_output->logs = (t_log*) my_calloc(g_power_output->num_logs,
            sizeof(t_log));
    g_power_output->logs[POWER_LOG_ERROR].name = my_strdup("Errors");
    g_power_output->logs[POWER_LOG_WARNING].name = my_strdup("Warnings");

    /* Initialize output file */
    if (!error) {
        g_power_output->out = NULL;
        g_power_output->out = my_fopen(power_out_filepath, "w", 0);
        if (!g_power_output->out) {
            error = TRUE;
        }
    }

    /* Load technology properties */
    power_tech_init(cmos_tech_behavior_filepath);

    /* Low-Level Initialization */
    power_lowlevel_init();

    /* Initialize sub-modules */
    power_components_init();

    /* Perform callibration */
    power_callibrate();

    /* Initialize routing information */
    power_routing_init(routing_arch);

// Allocates power structures for each pb pin
    power_pb_pins_init();

    /* Size all components */
    power_sizing_init(arch);

    //power_print_spice_comparison();

    return error;
}

Here is the call graph for this function:

Here is the caller graph for this function:

e_power_ret_code power_total	(	float *	run_time_s,
		t_vpr_setup	vpr_setup,
		t_arch *	arch,
		t_det_routing_arch *	routing_arch
	)

Definition at line 1695 of file power.c.

                                                          {
    t_power_usage total_power;
    t_power_usage sub_power_usage;
    clock_t t_start;
    clock_t t_end;
    t_power_usage clb_power_usage;

    t_start = clock();

    power_zero_usage(&total_power);

    if (routing_arch->directionality == BI_DIRECTIONAL) {
        power_log_msg(POWER_LOG_ERROR,
                "Cannot calculate routing power for bi-directional architectures");
        return POWER_RET_CODE_ERRORS;
    }

    /* Calculate Power */
    /* Routing */
    power_usage_routing(&sub_power_usage, routing_arch, arch->Segments);
    power_add_usage(&total_power, &sub_power_usage);
    power_component_add_usage(&sub_power_usage, POWER_COMPONENT_ROUTING);

    /* Clock  */
    power_usage_clock(&sub_power_usage, arch->clocks);
    power_add_usage(&total_power, &sub_power_usage);
    power_component_add_usage(&sub_power_usage, POWER_COMPONENT_CLOCK);

    /* CLBs */
    power_usage_blocks(&clb_power_usage);
    power_add_usage(&total_power, &clb_power_usage);
    power_component_add_usage(&clb_power_usage, POWER_COMPONENT_PB);

    power_component_add_usage(&total_power, POWER_COMPONENT_TOTAL);

    power_print_title(g_power_output->out, "Summary");
    power_print_summary(g_power_output->out, vpr_setup);

    /* Print Error & Warning Logs */
    output_logs(g_power_output->out, g_power_output->logs,
            g_power_output->num_logs);

    //power_print_title(g_power_output->out, "Statistics");
    //power_print_stats(g_power_output->out);

    power_print_title(g_power_output->out, "Power Breakdown");
    power_print_breakdown_summary(g_power_output->out);

    power_print_title(g_power_output->out, "Power Breakdown by PB");
    power_print_breakdown_pb(g_power_output->out);

    //power_print_title(g_power_output->out, "Spice Comparison");
    //power_print_spice_comparison();

    t_end = clock();

    *run_time_s = (float) (t_end - t_start) / CLOCKS_PER_SEC;

    /* Return code */
    if (g_power_output->logs[POWER_LOG_ERROR].num_messages) {
        return POWER_RET_CODE_ERRORS;
    } else if (g_power_output->logs[POWER_LOG_WARNING].num_messages) {
        return POWER_RET_CODE_WARNINGS;
    } else {
        return POWER_RET_CODE_SUCCESS;
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

boolean power_uninit

(

void

)

Uninitialize power module

Definition at line 1326 of file power.c.

                           {
    int mux_size;
    int log_idx;
    int rr_node_idx;
    int msg_idx;
    boolean error = FALSE;

    for (rr_node_idx = 0; rr_node_idx < num_rr_nodes; rr_node_idx++) {
        t_rr_node * node = &rr_node[rr_node_idx];
        t_rr_node_power * node_power = &rr_node_power[rr_node_idx];

        switch (node->type) {
        case CHANX:
        case CHANY:
        case IPIN:
            if (node->fan_in) {
                free(node_power->in_dens);
                free(node_power->in_prob);
            }
            break;
        default:
            /* Do nothing */
            break;
        }
    }
    free(rr_node_power);

    /* Free mux architectures */
    for (std::map<float, t_power_mux_info*>::iterator it =
            g_power_commonly_used->mux_info.begin();
            it != g_power_commonly_used->mux_info.end(); it++) {
        t_power_mux_info * mux_info = it->second;
        for (mux_size = 1; mux_size <= mux_info->mux_arch_max_size;
                mux_size++) {
            dealloc_mux_graph(mux_info->mux_arch[mux_size].mux_graph_head);
        }
        delete mux_info;
    }
    free(g_power_commonly_used);

    if (g_power_output->out) {
        fclose(g_power_output->out);
    }

    /* Free logs */
    for (log_idx = 0; log_idx < g_power_output->num_logs; log_idx++) {
        for (msg_idx = 0; msg_idx < g_power_output->logs[log_idx].num_messages;
                msg_idx++) {
            free(g_power_output->logs[log_idx].messages[msg_idx]);
        }
        free(g_power_output->logs[log_idx].messages);
        free(g_power_output->logs[log_idx].name);
    }
    free(g_power_output->logs);
    free(g_power_output);

    return error;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

t_power_arch* g_power_arch

Definition at line 68 of file power.c.

t_power_commonly_used* g_power_commonly_used

Definition at line 66 of file power.c.

t_power_output* g_power_output

Definition at line 65 of file power.c.

t_power_tech* g_power_tech

Definition at line 67 of file power.c.

t_solution_inf g_solution_inf

Definition at line 64 of file power.c.