213 lines
		
	
	
		
			6.3 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			213 lines
		
	
	
		
			6.3 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
| /****************************************************************************
 | |
| 
 | |
| Copyright(c) 2019 by Aerospace C.Power (Chongqing) Microelectronics. ALL RIGHTS RESERVED.
 | |
| 
 | |
| This Information is proprietary to Aerospace C.Power (Chongqing) Microelectronics and MAY NOT
 | |
| be copied by any method or incorporated into another program without
 | |
| the express written consent of Aerospace C.Power. This Information or any portion
 | |
| thereof remains the property of Aerospace C.Power. The Information contained herein
 | |
| is believed to be accurate and Aerospace C.Power assumes no responsibility or
 | |
| liability for its use in any way and conveys no license or title under
 | |
| any patent or copyright and makes no representation or warranty that this
 | |
| Information is free from patent or copyright infringement.
 | |
| 
 | |
| ***************************************************************************/
 | |
| #ifndef __PHY_PHASE_H
 | |
| #define __PHY_PHASE_H
 | |
| 
 | |
| #include "iot_config.h"
 | |
| #include "os_types.h"
 | |
| #include "phy_bb.h"
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| extern "C" {
 | |
| #endif
 | |
| 
 | |
| typedef enum {
 | |
|     PHY_PHASE_OVR_ALL = 0,
 | |
|     PHY_PHASE_OVR_A = 1,
 | |
|     PHY_PHASE_OVR_B = 2,
 | |
|     PHY_PHASE_OVR_C = 3
 | |
| } PHY_PHASE_OVR_ID;
 | |
| 
 | |
| typedef enum {
 | |
|     PHY_TXRX_OVR_IDLE,
 | |
|     PHY_TXRX_OVR_RX,
 | |
|     PHY_TXRX_OVR_TX,
 | |
|     PHY_TXRX_OVR_TXRX
 | |
| } PHY_TXRX_OVR_ID;
 | |
| 
 | |
| #if K48_CCO_MULTI_CHANNEL_SELECT_ENABLE
 | |
| #define TX_EN_CMB_A (3 << 0)
 | |
| #define RX_EN_CMB_A (3 << 0)
 | |
| #define TX_EN_CMB_B (3 << 2)
 | |
| #define RX_EN_CMB_B (3 << 2)
 | |
| #define TX_EN_CMB_C (3 << 4)
 | |
| #define RX_EN_CMB_C (3 << 4)
 | |
| #else
 | |
| #define TX_EN_CMB_A (1 << 0)
 | |
| #define RX_EN_CMB_A (1 << 1)
 | |
| #define TX_EN_CMB_B (1 << 2)
 | |
| #define RX_EN_CMB_B (1 << 3)
 | |
| #define TX_EN_CMB_C (1 << 4)
 | |
| #define RX_EN_CMB_C (1 << 5)
 | |
| #endif
 | |
| 
 | |
| /**
 | |
|  *@brief phy_phase_ovr_set.
 | |
|  *
 | |
|  * force phase select with A/B/C/ALL,
 | |
|  *
 | |
|  *@param phase              [A,B,C,ALL]
 | |
|  *@param en                 [true/false]
 | |
|  *@param mode               [0:idle,1:rx,2:tx,3:txrx]
 | |
|  *@exception                [none.]
 | |
|  *@return                   [none.]
 | |
|  */
 | |
| void phy_phase_ovr_set(PHY_PHASE_OVR_ID phase, bool_t en, PHY_TXRX_OVR_ID mode);
 | |
| 
 | |
| /**
 | |
|  *@brief phy_set_phase_overwrite() - set the tx&rx descriptor(0~3) map to
 | |
|  *                                   hw phase(phase A/B/C/ALL)
 | |
|  *
 | |
|  * set user protocol phase value map to kunlun chip's actual phase.
 | |
|  * for example:
 | |
|  * smart grid phase A = 1, then set desc1_to_hw_phae = HW_DESC_PHASE_A,
 | |
|  * since then, set descriptor's tx_phase/rx_phase = PLC_PHASE_A(1), kunlun chip
 | |
|  * will (tx&rx) work in phase A.
 | |
|  * if is_enable != false, desc0_to_hw_phase/desc1_to_hw_phase/desc2_to_hw_phase/
 | |
|  * desc3_to_hw_phase must be set to HW_DESC_PHASE_ALL/HW_DESC_PHASE_A/
 | |
|  * HW_DESC_PHASE_B/ HW_DESC_PHASE_C one of the values.
 | |
|  *
 | |
|  *@param is_enable:         is enable phase overwrite.
 | |
|  *                          true - enable, false - disable
 | |
|  *@param desc0_to_hw_phase: tx&rx descriptor value 0 map to hw phase, this value
 | |
|  *                          must be HW_DESC_PHASE_ALL/HW_DESC_PHASE_A/
 | |
|  *                          HW_DESC_PHASE_B/HW_DESC_PHASE_C
 | |
|  *@param desc1_to_hw_phase: tx&rx descriptor value 1 map to hw phase, same as
 | |
|  *                          desc0_to_hw_phase.
 | |
|  *@param desc2_to_hw_phase: tx&rx descriptor value 2 map to hw phase, same as
 | |
|  *                          desc0_to_hw_phase.
 | |
|  *@param desc3_to_hw_phase: tx&rx descriptor value 3 map to hw phase, same as
 | |
|  *                          desc0_to_hw_phase.
 | |
|  *@return                   none
 | |
|  */
 | |
| void phy_set_phase_overwrite(bool_t is_enable,
 | |
|     uint8_t desc0_to_hw_phase, uint8_t desc1_to_hw_phase,
 | |
|     uint8_t desc2_to_hw_phase, uint8_t desc3_to_hw_phase);
 | |
| 
 | |
| /**
 | |
|  *@brief register_get_rx_phase_cb   phy get mac rx phase cb.
 | |
|  *@exception                [none.]
 | |
|  *@return                   [none.]
 | |
| */
 | |
| void register_get_rx_phase_cb(mac_get_rx_phase_cb_t cb);
 | |
| 
 | |
| /**
 | |
|  *@brief phy_get_mac_rx_phase    get phy callback value, rx phase.
 | |
|  *@exception                [none.]
 | |
|  *@return                   [rx phase.]
 | |
| */
 | |
| uint32_t phy_get_mac_rx_phase();
 | |
| 
 | |
| /**
 | |
|  *@brief phy_force_0_access_require
 | |
|  *                            require the privilage to access force 0 register.
 | |
|  *
 | |
|  *@param void               [void]
 | |
|  *@exception                [none.]
 | |
|  *@return                   [none.]
 | |
| */
 | |
| void phy_force_0_access_require();
 | |
| 
 | |
| /**
 | |
|  *@brief phy_force_0_access_release
 | |
|  *                           release the privilage to access force 0 register.
 | |
|  *
 | |
|  *@param void               [void]
 | |
|  *@exception                [none.]
 | |
|  *@return                   [none.]
 | |
| */
 | |
| void phy_force_0_access_release();
 | |
| 
 | |
| /**
 | |
|  *@brief phy_force_0_access_require_from_isr
 | |
|  *                   require the privilage to access force 0 register from ISR.
 | |
|  *
 | |
|  *@param void               [void]
 | |
|  *@exception                [none.]
 | |
|  *@return uint32_t          [require the privilage success or not]
 | |
| */
 | |
| void phy_force_0_access_require_from_isr();
 | |
| 
 | |
| /**
 | |
|  *@brief phy_force_0_access_release_from_isr
 | |
|  *                   release the privilage to access force 0 register from ISR.
 | |
|  *
 | |
|  *@param void               [void]
 | |
|  *@exception                [none.]
 | |
|  *@return uint32_t          [release the privilage success or not]
 | |
| */
 | |
| void phy_force_0_access_release_from_isr();
 | |
| 
 | |
| /**
 | |
|  *@brief phy_rx_phase_force_set
 | |
|  *  force phy rx phase from mac.
 | |
|  *
 | |
|  *@param enable             [true or false]
 | |
|  *@param hw_phase           [ALL/A/B/C]
 | |
|  *@exception                [none.]
 | |
|  *@return                   [none.]
 | |
| */
 | |
| void phy_rx_phase_force_set(bool_t enable, uint8_t hw_phase);
 | |
| 
 | |
| /**
 | |
|  *@brief phy_rx_phase_force_set_on_dump
 | |
|  *  force phy rx phase from mac on dump mode.
 | |
|  *
 | |
|  *@param enable             [true or false]
 | |
|  *@param hw_phase           [ALL/A/B/C]
 | |
|  *@exception                [none.]
 | |
|  *@return                   [none.]
 | |
| */
 | |
| void phy_rx_phase_force_set_on_dump(bool_t enable, uint8_t hw_phase);
 | |
| 
 | |
| /**
 | |
|  *@brief phy_get_rx_force_phase_val   get rx force phase.
 | |
|  *
 | |
|  *@return                   [force phase]
 | |
| */
 | |
| uint32_t phy_get_rx_force_phase_val();
 | |
| 
 | |
| /**
 | |
|  *@brief phy_get_rx_phase_force_en  get rx force phase enable/disable.
 | |
|  *
 | |
|  *@return                   [0]
 | |
| */
 | |
| uint32_t phy_get_rx_phase_force_en();
 | |
| 
 | |
| /**
 | |
| * @brief phy_get_hw_phy_rx_phase_sel() - get phy rx phase select
 | |
| *
 | |
| * @param        none
 | |
| *
 | |
| * @return       phy rx phase num
 | |
| */
 | |
| uint32_t phy_get_hw_phy_rx_phase_sel(void);
 | |
| 
 | |
| /**
 | |
|  * @brief               enable/disable force phy tx
 | |
|  *
 | |
|  * @param is_enable:    0 - disable force phy tx
 | |
|  *                      1 - enable force phy tx
 | |
|  *
 | |
|  * @return              none
 | |
|  */
 | |
| void phy_set_tx_force_enable(uint8_t is_enable);
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| }
 | |
| #endif
 | |
| 
 | |
| #endif
 |