blob: 29e3497e082fee4085214f02e08d63abe10705ae [file] [log] [blame]
/******************************************************************************
* @file bsp.h
*
* @brief for TLSR chips
*
* @author public@telink-semi.com;
* @date Sep. 30, 2010
*
* @attention
*
* Copyright (C) 2019-2020 Telink Semiconductor (Shanghai) Co., Ltd.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*****************************************************************************/
#ifndef BSP_H_
#define BSP_H_
#include "compiler.h"
/**
* define BIT operations
*/
#define BIT(n) ( 1<<(n) )
#define BIT_MASK_LEN(len) (BIT(len)-1)
#define BIT_RNG(s, e) (BIT_MASK_LEN((e)-(s)+1) << (s))
#define BM_CLR_MASK_V(x, mask) ( (x) & ~(mask) )
#define BM_SET(x, mask) ( (x) |= (mask) )
#define BM_CLR(x, mask) ( (x) &= ~(mask) )
#define BM_IS_SET(x, mask) ( (x) & (mask) )
#define BM_IS_CLR(x, mask) ( (~x) & (mask) )
#define BM_FLIP(x, mask) ( (x) ^= (mask) )
/**
* define Reg operations
*/
// Return the bit index of the lowest 1 in y. ex: 0b00110111000 --> 3
#define BIT_LOW_BIT(y) (((y) & BIT(0))?0:(((y) & BIT(1))?1:(((y) & BIT(2))?2:(((y) & BIT(3))?3: \
(((y) & BIT(4))?4:(((y) & BIT(5))?5:(((y) & BIT(6))?6:(((y) & BIT(7))?7: \
(((y) & BIT(8))?8:(((y) & BIT(9))?9:(((y) & BIT(10))?10:(((y) & BIT(11))?11: \
(((y) & BIT(12))?12:(((y) & BIT(13))?13:(((y) & BIT(14))?14:(((y) & BIT(15))?15: \
(((y) & BIT(16))?16:(((y) & BIT(17))?17:(((y) & BIT(18))?18:(((y) & BIT(19))?19: \
(((y) & BIT(20))?20:(((y) & BIT(21))?21:(((y) & BIT(22))?22:(((y) & BIT(23))?23: \
(((y) & BIT(24))?24:(((y) & BIT(25))?25:(((y) & BIT(26))?26:(((y) & BIT(27))?27: \
(((y) & BIT(28))?28:(((y) & BIT(29))?29:(((y) & BIT(30))?30:(((y) & BIT(31))?31:32 \
))))))))))))))))))))))))))))))))
// Return the bit index of the highest 1 in (y). ex: 0b00110111000 --> 8
#define BIT_HIGH_BIT(y) (((y) & BIT(31))?31:(((y) & BIT(30))?30:(((y) & BIT(29))?29:(((y) & BIT(28))?28: \
(((y) & BIT(27))?27:(((y) & BIT(26))?26:(((y) & BIT(25))?25:(((y) & BIT(24))?24: \
(((y) & BIT(23))?23:(((y) & BIT(22))?22:(((y) & BIT(21))?21:(((y) & BIT(20))?20: \
(((y) & BIT(19))?19:(((y) & BIT(18))?18:(((y) & BIT(17))?17:(((y) & BIT(16))?16: \
(((y) & BIT(15))?15:(((y) & BIT(14))?14:(((y) & BIT(13))?13:(((y) & BIT(12))?12: \
(((y) & BIT(11))?11:(((y) & BIT(10))?10:(((y) & BIT(9))?9:(((y) & BIT(8))?8: \
(((y) & BIT(7))?7:(((y) & BIT(6))?6:(((y) & BIT(5))?5:(((y) & BIT(4))?4: \
(((y) & BIT(3))?3:(((y) & BIT(2))?2:(((y) & BIT(1))?1:(((y) & BIT(0))?0:32 \
))))))))))))))))))))))))))))))))
#define COUNT_ARGS_IMPL2(_1, _2, _3, _4, _5, _6, _7, _8 , _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, N, ...) N
#define COUNT_ARGS_IMPL(args) COUNT_ARGS_IMPL2 args
#define COUNT_ARGS(...) COUNT_ARGS_IMPL((__VA_ARGS__, 20, 19, 18, 17, 16, 15, 14, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0))
#define MACRO_CHOOSE_HELPER2(base, count) base##count
#define MACRO_CHOOSE_HELPER1(base, count) MACRO_CHOOSE_HELPER2(base, count)
#define MACRO_CHOOSE_HELPER(base, count) MACRO_CHOOSE_HELPER1(base, count)
#define MACRO_GLUE(x, y) x y
#define VARARG(base, ...) MACRO_GLUE(MACRO_CHOOSE_HELPER(base, COUNT_ARGS(__VA_ARGS__)),(__VA_ARGS__))
#define MV(m, v) (((v) << BIT_LOW_BIT(m)) & (m))
// warning MASK_VALn are internal used macro, please use MASK_VAL instead
#define MASK_VAL2(m, v) (MV(m,v))
#define MASK_VAL4(m1,v1,m2,v2) (MV(m1,v1)|MV(m2,v2))
#define MASK_VAL6(m1,v1,m2,v2,m3,v3) (MV(m1,v1)|MV(m2,v2)|MV(m3,v3))
#define MASK_VAL8(m1,v1,m2,v2,m3,v3,m4,v4) (MV(m1,v1)|MV(m2,v2)|MV(m3,v3)|MV(m4,v4))
#define MASK_VAL10(m1,v1,m2,v2,m3,v3,m4,v4,m5,v5) (MV(m1,v1)|MV(m2,v2)|MV(m3,v3)|MV(m4,v4)|MV(m5,v5))
#define MASK_VAL12(m1,v1,m2,v2,m3,v3,m4,v4,m5,v5,m6,v6) (MV(m1,v1)|MV(m2,v2)|MV(m3,v3)|MV(m4,v4)|MV(m5,v5)|MV(m6,v6))
#define MASK_VAL14(m1,v1,m2,v2,m3,v3,m4,v4,m5,v5,m6,v6,m7,v7) (MV(m1,v1)|MV(m2,v2)|MV(m3,v3)|MV(m4,v4)|MV(m5,v5)|MV(m6,v6)|MV(m7,v7))
#define MASK_VAL16(m1,v1,m2,v2,m3,v3,m4,v4,m5,v5,m6,v6,m7,v7,m8,v8) (MV(m1,v1)|MV(m2,v2)|MV(m3,v3)|MV(m4,v4)|MV(m5,v5)|MV(m6,v6)|MV(m7,v7)|MV(m8,v8))
#define MASK_VAL(...) VARARG(MASK_VAL, __VA_ARGS__)
/**
* Reg operations
*/
#define REG_BASE_ADDR 0x800000
#define REG_ADDR8(a) (*(volatile unsigned char*) (REG_BASE_ADDR + (a)))
#define REG_ADDR16(a) (*(volatile unsigned short*)(REG_BASE_ADDR + (a)))
#define REG_ADDR32(a) (*(volatile unsigned long*) (REG_BASE_ADDR + (a)))
#define write_reg8(addr,v) (*(volatile unsigned char*) (REG_BASE_ADDR + (addr)) = (unsigned char)(v))
#define write_reg16(addr,v) (*(volatile unsigned short*) (REG_BASE_ADDR + (addr)) = (unsigned short)(v))
#define write_reg32(addr,v) (*(volatile unsigned long*) (REG_BASE_ADDR + (addr)) = (v))
#define read_reg8(addr) (*(volatile unsigned char*) (REG_BASE_ADDR + (addr)))
#define read_reg16(addr) (*(volatile unsigned short*)(REG_BASE_ADDR + (addr)))
#define read_reg32(addr) (*(volatile unsigned long*) (REG_BASE_ADDR + (addr)))
#define WRITE_REG8 write_reg8
#define WRITE_REG16 write_reg16
#define WRITE_REG32 write_reg32
#define READ_REG8 read_reg8
#define READ_REG16 read_reg16
#define READ_REG32 read_reg32
#define TCMD_UNDER_BOTH 0xc0
#define TCMD_UNDER_RD 0x80
#define TCMD_UNDER_WR 0x40
#define TCMD_MASK 0x3f
#define TCMD_WRITE 0x3
#define TCMD_WAIT 0x7
#define TCMD_WAREG 0x8
/**
* command table for special registers
*/
typedef struct TBLCMDSET {
unsigned short ADR;
unsigned char DAT;
unsigned char CMD;
} TBLCMDSET;
/**
* @brief This function performs a series of operations of writing digital or analog registers
* according to a command table
* @param[in] pt - pointer to a command table containing several writing commands
* @param[in] size - number of commands in the table
* @return number of commands are carried out
*/
extern int LoadTblCmdSet(const TBLCMDSET * pt, int size);
/**
* @brief This function writes a byte data to analog register
* @param[in] addr - the address of the analog register needs to write
* @param[in] value - the data will be written to the analog register
* @param[in] e - the end address of value
* @param[in] s - the start address of the value
* @return none
*/
extern void sub_wr_ana(unsigned int addr, unsigned char value, unsigned char e, unsigned char s);
/**
* @brief This function writes a byte data to a specified analog register
* @param[in] addr - the address of the analog register needs to write
* @param[in] value - the data will be written to the analog register
* @param[in] e - the end address of value
* @param[in] s - the start address of the value
* @return none
*/
extern void sub_wr(unsigned int addr, unsigned char value, unsigned char e, unsigned char s);
#endif /* BSP_H_ */