elphel: os/linux-2.6-tag--devboard-R2_10-4/arch/cris/arch-v32/drivers/elphel/gamma

Go to the source code of this file.


Functions
void	init_gammas (void)
	Initialize gamma tables data structures.
int	is_gamma_current (unsigned short hash16, unsigned short scale, int index)
	verifies that index is current (points to specified hash and scale)
int	is_gamma_valid (unsigned short hash16, unsigned short scale, int index)
	verifies that index is current and points to a valid table with specified hash and scale
int	unlock_gamma_node (int color)
	Unlock gamma table for the specified color NOTE: Not needed anymore.
unsigned long *	get_gamma_fpga (int color)
	Find a gamma table in FPGA format to be programmed (table should already be locked for this color).
int	gamma_new_node (void)
	Get a new node for gamma tables Find least recently used node (balancing between non-scaled and scaled), remove it from current chains and return pointers in the returned node are not initialized, "valid" bit is cleared NOTE: interrupts should be disabled ***.
void	gamma_encode_fpga (unsigned short gamma_in, unsigned long gamma_out)
	Hardware-dependent encoding of the FPGA "gamma" table.
void	gamma_calc_scaled (unsigned short scale, unsigned short gamma_in, unsigned short gamma_out)
	Hardware-dependent encoding of the FPGA "gamma" table. Converts unsigned short array of 257 16-bit values (only 10 msb-s are used) to 256 unsigned long words to be written to FPGA.
void	gamma_calc_reverse (unsigned short gamma_in, unsigned char gamma_out)
	scale gamma table by (scale>>GAMMA_SCALE_SHIFT), saturate to 0..0xffff
int	set_gamma_table (unsigned short hash16, unsigned short scale, unsigned short *gamma_proto, unsigned char mode, int color)
	calculate gamma table (and requested derivatives), insert new node if needed.
unsigned long	get_locked_hash32 (int color)
	Looks for the hash32 last programmed to the FPGA for the particular color.

Function Documentation

void gamma_calc_reverse	(	unsigned short *	gamma_in,
		unsigned char *	gamma_out
	)

scale gamma table by (scale>>GAMMA_SCALE_SHIFT), saturate to 0..0xffff

Parameters:

	gamma_in	direct gamma table (16 bit)
	gamma_out	reversed gamma table (8 bit)

running value to be compared against direct gamma

current value of reverse gamma table

current indedx of reverse gamma table

Definition at line 444 of file gamma_tables.c.

References MDF11, printk, and x.

Referenced by set_gamma_table().

void gamma_calc_scaled	(	unsigned short	scale,
		unsigned short *	gamma_in,
		unsigned short *	gamma_out
	)

Hardware-dependent encoding of the FPGA "gamma" table. Converts unsigned short array of 257 16-bit values (only 10 msb-s are used) to 256 unsigned long words to be written to FPGA.

Parameters:

	scale	scale to apply (1.0 ~ GAMMA_SCLALE_1=0x400)
	gamma_in	input (non-scaled) gamma table (16 bit)
	gamma_out	output (scaled) gamma table (16 bit)

rounding, not truncating

Definition at line 424 of file gamma_tables.c.

References d, GAMMA_SCALE_SHIFT, MDF11, and printk.

Referenced by set_gamma_table().

void gamma_encode_fpga	(	unsigned short *	gamma_in,
		unsigned long *	gamma_out
	)

Hardware-dependent encoding of the FPGA "gamma" table.

Parameters:

	gamma_in	pointer to array of 257 16-bit values (only 10 msb-s are currently used)
	gamma_out	pointer to an array of 256 unsigned long words to be written to FPGA

Definition at line 402 of file gamma_tables.c.

References MDF11, and printk.

Referenced by set_gamma_table().

int gamma_new_node ( void )

Get a new node for gamma tables Find least recently used node (balancing between non-scaled and scaled), remove it from current chains and return pointers in the returned node are not initialized, "valid" bit is cleared NOTE: interrupts should be disabled ***.

Returns:: Node index or 0 if none (unlocked) nodes are found

no scaled for the oldest hash

sacrifice oldest hash

use oldest scaled

skip locked if any (should be unlikely to get any locked)

remove from "all" chain (should work for tmp_p being oldest or not

remove from "scaled chain"

Definition at line 377 of file gamma_tables.c.

References GAMMA_THRESH, gamma_stuct_t::newer_all, gamma_stuct_t::oldest_all, gamma_stuct_t::oldest_non_scaled, remove_from_all(), remove_from_nonscaled(), remove_from_scaled(), and gamma_stuct_t::valid.

Referenced by set_gamma_table().

unsigned long* get_gamma_fpga ( int color )

Find a gamma table in FPGA format to be programmed (table should already be locked for this color).

Parameters:

color

color index (0..3) of the table

Returns:: pointer to a gamma table (or NULL if table does not exist)

NOTE: Not needed anymore?

Definition at line 360 of file gamma_tables.c.

References gamma_stuct_t::fpga, gamma_stuct_t::locked_color, MDF11, and printk.

Referenced by pgm_gammaload().

unsigned long get_locked_hash32 ( int color )

Looks for the hash32 last programmed to the FPGA for the particular color.

Parameters:

color

Returns:: hash32 (combined gamma/black/scale) locked fro a specified color. If none - return 0

Definition at line 314 of file gamma_tables.c.

References gamma_stuct_t::hash32, and gamma_stuct_t::locked_color.

Referenced by pgm_gamma(), and pgm_gammaload().

void init_gammas ( void )

Initialize gamma tables data structures.

empty 2-d chain

all entries in a same

no parent.FIXME: Where is it used? -1 if never used

something else?

Definition at line 258 of file gamma_tables.c.

References flags, GAMMA_CACHE_NUMBER, gammas_p, local_irq_restore, local_irq_save, gamma_stuct_t::locked, MDF10, gamma_stuct_t::newer_all, gamma_stuct_t::newest_all, gamma_stuct_t::newest_non_scaled, gamma_stuct_t::non_scaled_length, gamma_stuct_t::older_all, gamma_stuct_t::oldest_all, gamma_stuct_t::oldest_non_scaled, printk, and gamma_stuct_t::valid.

Referenced by gammas_init(), and gammas_lseek().

int is_gamma_current	(	unsigned short	hash16,
		unsigned short	scale,
		int	index
	)

verifies that index is current (points to specified hash and scale)

Parameters:

	hash16	- 16-bit unique hash for gamma table
	scale	- 16-bit scale for gamma table (6.10, so GAMMA_SCLALE_10x400 is 1.0)
	index	- gamma table index

Returns:: 1 - table pointed by index is current, 0 - table is not current

Definition at line 293 of file gamma_tables.c.

Referenced by gammas_lseek(), and set_gamma_table().

int is_gamma_valid	(	unsigned short	hash16,
		unsigned short	scale,
		int	index
	)

verifies that index is current and points to a valid table with specified hash and scale

Parameters:

	hash16	- 16-bit unique hash for gamma table
	scale	- 16-bit scale for gamma table (6.10, so GAMMA_SCLALE_1=0x400 is 1.0)
	index	- gamma table index

Returns:: 1 - table pointed by index is current and valid, 0 - table is not current or not valid

Definition at line 304 of file gamma_tables.c.

int set_gamma_table	(	unsigned short	hash16,
		unsigned short	scale,
		unsigned short *	gamma_proto,
		unsigned char	mode,
		int	color
	)

calculate gamma table (and requested derivatives), insert new node if needed.

Parameters:

	hash16	16-bit unique (non-scaled) gamma table identifier. Can be 1-byte gamma and 1-byte black level shift TODO: make black level fine-grained?
	scale	gamma table scale (currently 0x400 ~ 1.0) GAMMA_SCLALE_1 = 0x400
	gamma_proto	16-bit gamma table prototype (or NULL)
	mode	bits specify calculation mode: 1 - if set, no interrupts will be enabled between steps, whole operation will be atomic 2 - calculate reverse gamma table 4 - calculate FPGA-format gamma table. 8 - Lock (FPGA) table for specified color
	color	color index (0..3) to lock table for (if mode bit 4 is set), otherwise color is ignored

Returns:: index for the specified table or 0 if none exists and prototype was not provided (gamma_proto==NULL)

NOTE: here

disable interrupts here

look for the matching hash

gammas[0].oldest_all=GAMMA_CACHE_NUMBER-1; gammas[0].newest_all=1;

NOTE: 253

NOTE: never

NOTE: 0xff

Got right hash?

no luck

NOTE: never

matching hash not found, new table is not provided - return 0;

Create new proto table

could not allocate node

failure: could not allocate node - return 0;

fill it:

points to itself - no scaled versions yet

let interrupts to take place, and disable again

check if it is still there (likely so, but allow it to fail).

failure: other code used this node - return 0; (try not_nice next time?)

copy the provided table (full 16 bits)

add it to the chain

matching hash found,make it newest (remove from the chain + add to the chain)

if 0 - it is already the newest

NOTE: 0xff

now looking for the correct scale.

wanted non-scaled, got it ///NOTE: returns here

FIXME: 0xff

FIXME: got stuck here

Got right scale?

no luck

create new scale

could not allocate node

failure: could not allocate node - return 0;

fill it

insert into 2-d

insert into 1-d (all)

let interrupts to take place, and disable again

check if it is still there (likely so, but allow it to fail).

failure: other code used this node - return 0; (try not_nice next time?)

scaled table already exists, make it first in 2 chains:

found right scale, make it newest in two chain (2d - hash/scale and 1-d - all scaled together, regardless of the hash 2-d chain

not already the newest of scales for the same hash

1-d chain

not already the newest from all scaled

is the scaled version already calculated?

calculate scaled version

is hardware-encoded array already calculated (do it if not)?

lock the node for the color

let interrupts to take place, and disable again

check if it is still there (likely so, but allow it to fail).

failure: other code used this node - return 0; (try not_nice next time?)

Definition at line 475 of file gamma_tables.c.

References D10, D1I, flags, fpga, gamma_calc_reverse(), gamma_calc_scaled(), gamma_encode_fpga(), GAMMA_FPGA_MASK, GAMMA_MODE_HARDWARE, GAMMA_MODE_LOCK, GAMMA_MODE_NEED_REVERSE, GAMMA_MODE_NOT_NICE, gamma_new_node(), GAMMA_VALID_MASK, GAMMA_VALID_REVERSE, gamma_stuct_t::hash16, insert_first_all(), insert_first_nonscaled(), insert_first_scaled(), is_gamma_current(), local_irq_restore, local_irq_save, lock_gamma_node(), MDF10, memcpy(), gamma_stuct_t::newest_non_scaled, gamma_stuct_t::newest_scaled, gamma_stuct_t::older_non_scaled, gamma_stuct_t::older_scaled, gamma_stuct_t::oldest_scaled, printk, remove_from_all(), remove_from_nonscaled(), remove_from_scaled(), gamma_stuct_t::scale, and gamma_stuct_t::valid.

Referenced by gammas_init(), pgm_gamma(), and pgm_gammaload().

os/linux-2.6-tag--devboard-R2_10-4/arch/cris/arch-v32/drivers/elphel/gamma_tables.h File Reference

Functions

Function Documentation