Master population table implementation that uses binary search. More...

#include "population_table.h"
#include <neuron/synapse_row.h>
#include <debug.h>
#include <stdbool.h>

Functions
static void	print_master_population_table (void)
	Prints the master pop table.

static void	print_bitfields (uint32_t mp_i, filter_info_t *filters)
	Print bitfields for debugging.

bool	population_table_load_bitfields (filter_region_t *filter_region)
	Initialise the bitfield filtering system.

static bool	population_table_position_in_the_master_pop_array (spike_t spike, uint32_t *position)
	Get the position in the master population table.

bool	population_table_setup (address_t table_address, uint32_t row_max_n_words, uint32_t master_pop_table_length, master_population_table_entry master_pop_table, address_list_entry address_list)
	Set up and return the table for outside use.

API functions
bool	population_table_initialise (address_t table_address, address_t synapse_rows_address, uint32_t *row_max_n_words)
	Set up the table.

bool	population_table_get_first_address (spike_t spike, pop_table_lookup_result_t *result)
	Get the first row data for the given input spike.

bool	population_table_get_next_address (spike_t spike, pop_table_lookup_result_t result)
	Get the next row data for a previously given spike. If no spike has been given, return False.

Variables
static master_population_table_entry *	master_population_table
	The master population table. This is sorted.

static uint32_t	master_population_table_length
	The length of master_population_table.

static address_list_entry *	address_list
	The array of information that points into the synaptic matrix.

static uint32_t	synaptic_rows_base_address
	Base address for the synaptic matrix's indirect rows.

static spike_t	last_spike = 0
	The last spike received.

static uint32_t	last_colour = 0
	The last colour received.

static uint32_t	last_colour_mask = 0
	The last colour mask used.

static uint32_t	last_neuron_id = 0
	The last neuron id for the key.

static uint16_t	next_item = 0
	the index for the next item in the address_list

uint16_t	items_to_go = 0
	The number of addresses from the same spike left to process.

static bit_field_t *	connectivity_bit_field = NULL
	The bitfield map.

uint32_t	ghost_pop_table_searches = 0
	the number of times a DMA resulted in 0 entries

uint32_t	invalid_master_pop_hits = 0
	the number of times packet isnt in the master pop table at all!

uint32_t	failed_bit_field_reads = 0
	The number of bit fields which were not able to be read in due to DTCM limits.

uint32_t	bit_field_filtered_packets = 0
	The number of packets dropped because the bitfield filter says they don't hit anything.

Detailed Description

Master population table implementation that uses binary search.

Function Documentation

static void print_master_population_table ( void )

inlinestatic

Prints the master pop table.

For debugging

inlinestatic

Print bitfields for debugging.

Parameters

[in]	mp_i	The master population table entry index
[in]	filters	The bitfields to print

bool population_table_load_bitfields ( filter_region_t * filter_region )

Initialise the bitfield filtering system.

Parameters

[in] filter_region Where the bitfield configuration is

static bool population_table_position_in_the_master_pop_array	(	spike_t	spike,
		uint32_t *	position
	)

inlinestatic

Get the position in the master population table.

Parameters

[in]	spike	The spike received
[out]	position	The position found (only if returns true)

bool population_table_setup	(	address_t	table_address,
		uint32_t *	row_max_n_words,
		uint32_t *	master_pop_table_length,
		master_population_table_entry **	master_pop_table,
		address_list_entry **	address_list
	)

Set up and return the table for outside use.

Parameters

[in]	table_address	The address of the start of the table data
[out]	row_max_n_words	Updated with the maximum length of any row in the table in words
[out]	master_pop_table_length	Updated with the length of the table
[out]	master_pop_table	Updated with the table entries
[out]	address_list	Updated with the address list

bool population_table_initialise	(	address_t	table_address,
		address_t	synapse_rows_address,
		uint32_t *	row_max_n_words
	)

Set up the table.

Parameters

[in]	table_address	The address of the start of the table data
[in]	synapse_rows_address	The address of the start of the synapse data
[out]	row_max_n_words	Updated with the maximum length of any row in the table in words