Introduction

Here is the list of APIs used for BiSSC encoder communication protocol

Functions
int32_t	bissc_command_process (struct bissc_priv *priv)
	Send the BiSSC command and wait till firmware acknowledges. More...

void	bissc_command_send (struct bissc_priv *priv)
	Trigger sending the BiSSC command in PRU. More...

int32_t	bissc_command_wait (struct bissc_priv *priv)
	Wait till PRU finishes BiSSC transaction. More...

int32_t	bissc_get_pos (struct bissc_priv *priv)
	Get single cycle BiSS-C position data. More...

void	bissc_config_clock (struct bissc_priv priv, struct bissc_clk_cfg clk_cfg)
	Configure EnDat clock. More...

void	bissc_config_channel (struct bissc_priv *priv, int32_t mask, int32_t totalch)
	Select channel to be used by BiSSC master. More...

void	bissc_config_load_share (struct bissc_priv *priv, int32_t mask)
	Configure the channels to be used by BiSSC master. More...

void	bissc_enable_load_share_mode (struct bissc_priv *priv)
	Enable load share mode for BiSSC master. More...

void	bissc_config_primary_core_mask (struct bissc_priv *priv, uint8_t mask)
	Configure the primary core for load share mode. More...

int32_t	bissc_wait_for_fw_initialization (struct bissc_priv *priv, uint32_t timeout, uint8_t mask)
	Wait for BiSSC master firmware to initialize. More...

void	bissc_hw_init (struct bissc_priv *priv)
	Initialize BiSSC hardware interface. More...

struct bissc_priv *	bissc_init (PRUICSS_Handle gPruIcssXHandle, int32_t slice, uint32_t frequency, uint32_t core_clk_freq, uint32_t uart_clk_freq)
	Initialize BiSSC firmware interface address and get the pointer to struct bissc_priv instance. More...

void	bissc_update_max_proc_delay (struct bissc_priv *priv)
	Update max processing time and bit index to poll in fifo data. More...

int32_t	bissc_wait_measure_proc_delay (struct bissc_priv *priv, uint32_t timeout)
	Wait for BiSSC master firmware to measure processing time. More...

void	bissc_set_default_initialization (struct bissc_priv *priv, uint64_t icssgclk)
	Set default configuration parameters for BiSSC Master firmware. More...

void	bissc_update_data_len (struct bissc_priv *priv, uint32_t single_turn_len[], uint32_t multi_turn_len[], int32_t num_pru)
	Update data length with encoder bit width for BiSSC Master firmware. More...

int32_t	bissc_set_ctrl_cmd_and_process (struct bissc_priv *priv, uint32_t ctrl_cmd[])
	Set control command and process the ctrl communication read/write. More...

void	bissc_config_endat_mode (struct bissc_priv *priv)
	Configure the master for EnDat mode. More...

void	bissc_config_clr_cfg0 (struct bissc_priv *priv)
	Clear the channel specific frame size cfg registers. More...

void	bissc_get_enc_proc_delay (struct bissc_priv *priv)
	Get measured processing delay of individual channel. More...

int32_t	bissc_calc_clock (struct bissc_priv priv, struct bissc_clk_cfg clk_cfg)
	Calculate Rx and Tx divisors for given frequency. More...

Function Documentation

◆ bissc_command_process()

int32_t bissc_command_process ( struct bissc_priv * priv )

Send the BiSSC command and wait till firmware acknowledges.

Parameters

[in] priv cookie returned by bissc_init

Return values

SystemP_SUCCESS for success, SystemP_FAILURE for failure

◆ bissc_command_send()

void bissc_command_send ( struct bissc_priv * priv )

Trigger sending the BiSSC command in PRU.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_command_wait()

int32_t bissc_command_wait ( struct bissc_priv * priv )

Wait till PRU finishes BiSSC transaction.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_get_pos()

int32_t bissc_get_pos ( struct bissc_priv * priv )

Get single cycle BiSS-C position data.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_config_clock()

void bissc_config_clock	(	struct bissc_priv *	priv,
		struct bissc_clk_cfg *	clk_cfg
	)

Configure EnDat clock.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	clk_cfg	pointer to structure containing clock configuration data

◆ bissc_config_channel()

void bissc_config_channel	(	struct bissc_priv *	priv,
		int32_t	mask,
		int32_t	totalch
	)

Select channel to be used by BiSSC master.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	mask	channel mask
[in]	totalch	total number of channels in use

◆ bissc_config_load_share()

void bissc_config_load_share	(	struct bissc_priv *	priv,
		int32_t	mask
	)

Configure the channels to be used by BiSSC master.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	mask	channel mask

◆ bissc_enable_load_share_mode()

void bissc_enable_load_share_mode ( struct bissc_priv * priv )

Enable load share mode for BiSSC master.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_config_primary_core_mask()

void bissc_config_primary_core_mask	(	struct bissc_priv *	priv,
		uint8_t	mask
	)

Configure the primary core for load share mode.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	mask	channel mask

◆ bissc_wait_for_fw_initialization()

int32_t bissc_wait_for_fw_initialization	(	struct bissc_priv *	priv,
		uint32_t	timeout,
		uint8_t	mask
	)

Wait for BiSSC master firmware to initialize.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	timeout	timeout to wait for initialization
[in]	mask	channel mask

Return values

SystemP_SUCCESS for success, SystemP_FAILURE for failure

◆ bissc_hw_init()

void bissc_hw_init ( struct bissc_priv * priv )

Initialize BiSSC hardware interface.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_init()

struct bissc_priv* bissc_init	(	PRUICSS_Handle	gPruIcssXHandle,
		int32_t	slice,
		uint32_t	frequency,
		uint32_t	core_clk_freq,
		uint32_t	uart_clk_freq
	)

Initialize BiSSC firmware interface address and get the pointer to struct bissc_priv instance.

Parameters

[in]	gPruIcssXHandle	BiSSC firmware interface address
[in]	slice	ICSS PRU SLICE
[in]	frequency	Input frequency
[in]	core_clk_freq	Core clock frequency
[in]	uart_clk_freq	Uart clock frequency

Return values

priv	pointer to struct bissc_priv instance

◆ bissc_update_max_proc_delay()

void bissc_update_max_proc_delay ( struct bissc_priv * priv )

Update max processing time and bit index to poll in fifo data.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_wait_measure_proc_delay()

int32_t bissc_wait_measure_proc_delay	(	struct bissc_priv *	priv,
		uint32_t	timeout
	)

Wait for BiSSC master firmware to measure processing time.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	timeout	timeout to wait for initialization

Return values

SystemP_SUCCESS for success, SystemP_FAILURE for failure

◆ bissc_set_default_initialization()

void bissc_set_default_initialization	(	struct bissc_priv *	priv,
		uint64_t	icssgclk
	)

Set default configuration parameters for BiSSC Master firmware.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	icssgclk	ICSSG core clock for firmware reference

◆ bissc_update_data_len()

void bissc_update_data_len	(	struct bissc_priv *	priv,
		uint32_t	single_turn_len[],
		uint32_t	multi_turn_len[],
		int32_t	num_pru
	)

Update data length with encoder bit width for BiSSC Master firmware.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	single_turn_len	Encoder's single turn resolution
[in]	multi_turn_len	Encoder's multi turn resolution
[in]	num_pru	number(index) of PRU in use

◆ bissc_set_ctrl_cmd_and_process()

int32_t bissc_set_ctrl_cmd_and_process	(	struct bissc_priv *	priv,
		uint32_t	ctrl_cmd[]
	)

Set control command and process the ctrl communication read/write.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	ctrl_cmd	Hex equivalent of control command

Return values

SystemP_SUCCESS for success, SystemP_FAILURE for failure

◆ bissc_config_endat_mode()

void bissc_config_endat_mode ( struct bissc_priv * priv )

Configure the master for EnDat mode.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_config_clr_cfg0()

void bissc_config_clr_cfg0 ( struct bissc_priv * priv )

Clear the channel specific frame size cfg registers.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_get_enc_proc_delay()

void bissc_get_enc_proc_delay ( struct bissc_priv * priv )

Get measured processing delay of individual channel.

Parameters

[in] priv cookie returned by bissc_init

◆ bissc_calc_clock()

int32_t bissc_calc_clock	(	struct bissc_priv *	priv,
		struct bissc_clk_cfg *	clk_cfg
	)

Calculate Rx and Tx divisors for given frequency.

Parameters

[in]	priv	cookie returned by bissc_init
[in]	clk_cfg	pointer to structure containing clock configuration data.

Introduction

Functions

Function Documentation

◆ bissc_command_process()

◆ bissc_command_send()

◆ bissc_command_wait()

◆ bissc_get_pos()

◆ bissc_config_clock()

◆ bissc_config_channel()

◆ bissc_config_load_share()

◆ bissc_enable_load_share_mode()

◆ bissc_config_primary_core_mask()

◆ bissc_wait_for_fw_initialization()

◆ bissc_hw_init()

◆ bissc_init()

◆ bissc_update_max_proc_delay()

◆ bissc_wait_measure_proc_delay()

◆ bissc_set_default_initialization()

◆ bissc_update_data_len()

◆ bissc_set_ctrl_cmd_and_process()

◆ bissc_config_endat_mode()

◆ bissc_config_clr_cfg0()

◆ bissc_get_enc_proc_delay()

◆ bissc_calc_clock()