blob: ee83222c16f7391ad945041825b45c71ed9bcb0e [file] [log] [blame]
yu.dongc33b3072024-08-21 23:14:49 -07001/*****************************************************************************
2* Copyright Statement:
3* --------------------
4* This software is protected by Copyright and the information contained
5* herein is confidential. The software may not be copied and the information
6* contained herein may not be used or disclosed except with the written
7* permission of MediaTek Inc. (C) 2012
8*
9* BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
10* THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
11* RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
12* AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
13* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
14* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
15* NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
16* SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
17* SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
18* THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
19* NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
20* SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
21*
22* BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
23* LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
24* AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
25* OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
26* MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
27*
28* THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
29* WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
30* LAWS PRINCIPLES. ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
31* RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
32* THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
33*
34*****************************************************************************/
35
36/*******************************************************************************
37 * Filename:
38 * ---------
39 * binnum.h
40 *
41 * Project:
42 * --------
43 * MOLY
44 *
45 * Description:
46 * ------------
47 *
48 *
49 * Author:
50 * -------
51 * -------
52 *
53 *
54 * ==========================================================================
55 * $Log$
56 ****************************************************************************/
57/**
58 * @file binnum.h
59 * @brief binary number utilities
60 * @author Howard Chen
61 *
62 */
63#ifndef BINNUM_DEF
64#define BINNUM_DEF
65
66#define BU_LOG2(_v) (((_v)==64)? 6: \
67 ((_v)==32)? 5: \
68 ((_v)==16)? 4: \
69 ((_v)==8)? 3: \
70 ((_v)==4)? 2: \
71 ((_v)==2)? 1: \
72 ((_v)==0)? 0: -1)
73
74#define BU_T_MSK(_n) ((1<<(_n))-1)
75#define BU_F_MSK(_ms,_ls) (BU_T_MSK((_ms)-(_ls)+1)<<(_ls))
76#define BU_B_MSK(_n) (1 << (_n))
77#define BU_WID(_ms,_ls) ((_ms)-(_ls)+1)
78
79#define BU_ALN(_i, _n) ((_i) & ~BU_T_MSK(_n))
80
81#define BU_RUP(_i, _n) BU_ALN((_i)+BU_T_MSK(_n), _n)
82
83/**
84 * @brief trucate <_i> to <_n> bits
85 */
86#define BU_TRU(_i, _n) ((_i) & BU_T_MSK(_n))
87
88/**
89 * @brief get (<_ms>:<_ls>) field
90 */
91#define BU_G_FLD(_i,_ms,_ls) (((_i)<<(31-(_ms))) >> (31- (_ms) + (_ls)))
92
93/**
94 * @brief or (<_ms>:<_ls>) field
95 */
96#define BU_O_FLD(_i,_ms,_ls,_v) ((_i)|((BU_TRU(_v,BU_WID(_ms,_ls))<<(_ls))))
97
98/**
99 * @brief clean (<_ms>:<_ls>) field
100 */
101#define BU_C_FLD(_i,_ms,_ls) ((_i) & ~BU_F_MSK(_ms,_ls))
102
103/**
104 * @brief replace (<_ms>:<_ls>) field with <_v>
105 */
106#define BU_R_FLD(_i,_ms,_ls,_v) ((((_i)&~BU_F_MSK(_ms,_ls)))|((BU_TRU(_v,BU_WID(_ms,_ls))<<(_ls))))
107/**
108 * @brief get <_n> bit
109 */
110#define BU_G_BIT(_i,_n) BU_G_FLD(_i, _n, _n)
111
112/**
113 * @brief or <_n> bit with 0x1
114 */
115#define BU_O_BIT(_i,_n) ((_i) |(1 << (_n)))
116
117/**
118 * @brief clean <_n> bit
119 */
120#define BU_C_BIT(_i,_n) ((_i) & ~BU_B_MSK(_n))
121
122/**
123 * @brief replace <_n> bit with <_v>
124 */
125#define BU_R_BIT(_i,_n,_v) (((_i)&~BU_B_MSK(_n))|(((_v)&0x1)<<(_n)))
126
127#endif