Kconfig 语法分析详解

最新推荐文章于 2024-08-10 07:09:13 发布
最新推荐文章于 2024-08-10 07:09:13 发布
阅读量7.2k 收藏 57
点赞数 18
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/c_hnie/article/details/109393488
版权

Kconfig 语法

Kconfig 简介

RT-Thread 借助 Kconfig 文件生成的配置文件 rtconfig.h 来配置系统，Kconfig 文件是各种配置界面的源文件。当在 bsp 目录下使用 env 工具执行 menuconfig 命令时会出现 RT-Thread 系统的配置界面，所有配置工具都是通过读取当前 bsp 目录下的 Kconfig 文件来生成配置界面的，这个文件就是所有配置的总入口，它会包含其他目录的 Kconfig 文件。配置工具读取各个 Kconfig 文件，生成配置界面供开发人员配置系统，最终生成 RT-Thread 系统的配置文件 rtconfig.h。

Kconfig 基本语法

config 语句

config 定义了一组新的配置选项

以下为 RT-Thread 系统中 config 语句的示例

config BSP_USING_GPIO
    bool "Enable GPIO"
    select RT_USING_PIN
    default y
    help
    config gpio

以上代码对应的配置界面如下所示

config

对应的帮助信息界面如下所示

help

语句分析： - config 表示一个配置选项的开始，紧跟着的 BSP_USING_GPIO 是配置选项的名称，config 下面几行定义了该配置选项的属性。属性可以是该配置选项的 - 类型 - 输入提示 - 依赖关系 - 默认值 - 帮助信息

  • bool 表示配置选项的类型，每个 config 菜单项都要有类型定义，变量有5种类型
    • bool 布尔类型
    • tristate 三态类型
    • string 字符串
    • hex 十六进制
    • int 整型
  • select 是反向依赖关系的意思，即当前配置选项被选中，则 RT_USING_PIN 就会被选中。
  • default 表示配置选项的默认值，bool 类型的默认值可以是 y/n。
  • help 帮助信息。

通过 env 选中以上配置界面的选项后，最终可在 rtconfig.h 文件中生成如下两个宏

#define RT_USING_PIN
#define BSP_USING_GPIO

变量类型

bool 类型

布尔类型变量的取值范围是 y/n ，其使用示例如下

config BSP_USING_WDT
    bool "Enable Watchdog Timer"
    select RT_USING_WDT
    default n

上述语句对应的配置界面如下所示

bool

以上配置项在 rtconfig.h 文件中生成的宏如下所示

#define BSP_USING_WDT
#define RT_USING_WDT

string 类型

字符串变量的默认值是一个字符串，其使用示例如下

config RT_CONSOLE_DEVICE_NAME
    string "the device name for console"
    default "uart1"

上述语句对应的配置界面如下所示

string

以上配置项在 rtconfig.h 文件中生成的宏如下所示

#define RT_CONSOLE_DEVICE_NAME "uart1"

int 类型

整型变量的取值范围是一个整型的数，其使用示例如下

config BSP_I2C1_SCL_PIN
    int "I2C1 scl pin number"
    range 1 176
    default 116

上述语句对应的配置界面如下所示

int

以上配置项在 rtconfig.h 文件中生成的宏如下所示

#define BSP_I2C1_SCL_PIN 116

hex 类型

十六进制类型变量的取值范围是一个十六进制的数，其使用方法和整型变量用法一致，整型变量生成的是十进制的数，而十六进制生成的是十六进制的数。

tristate 类型

三态类型变量的取值范围是 y、n 和 m。tristate 代表在内核中有三种状态，一种是不选中，一种是选中直接编译进内核，还有一种是 m 手动添加驱动，而布尔类型变量只有两种状态，即选中和不选中。其使用方法和布尔类型变量类似。

menu 语句用于生成菜单。

以下为 RT-Thread 系统中 menu/endmenu 语句的示例

menu "Hardware Drivers Config"
    config BSP_USING_COM2
        bool "Enable COM2 (uart2 pin conflict with Ethernet and PWM)"
        select BSP_USING_UART
        select BSP_USING_UART2
        default n
    config BSP_USING_COM3
        bool "Enable COM3 (uart3 pin conflict with Ethernet)"
        select BSP_USING_UART3
        default n
endmenu

menu 之后的字符串是菜单名。menu 和 endmenu 间有很多 config 语句，以上代码对应的配置界面如下所示

menu1

其中 Hardware Drivers Config 就是菜单名，然后进入这个菜单有 Enable COM2、Enable COM3 等选项，如下图所示

menu

通过 env 选中以上配置界面的所有选项后，最终可在 rtconfig.h 文件中生成如下五个宏

#define BSP_USING_UART
#define BSP_USING_UART2
#define BSP_USING_UART3
#define BSP_USING_COM2
#define BSP_USING_COM3

if/endif 语句

if/endif 语句是一个条件判断，定义了一个 if 结构，示例代码如下

menu "Hardware Drivers Config"
    menuconfig BSP_USING_CAN
        bool "Enable CAN"
        default n
        select RT_USING_CAN
        if BSP_USING_CAN
            config BSP_USING_CAN1
                bool "Enable CAN1"
                default n
        endif
endmenu

当没有选中 "Enable CAN" 选项时，下面通过 if 判断的 Enable CAN1 选项并不会显示出来，如下图所示

if0 if1

当上一级菜单选中 "Enable CAN" 时

if11 if2

menuconfig 语句表示带菜单的配置项

以下为 RT-Thread 系统 menuconfig 语句的示例

menu "Hardware Drivers Config"
    menuconfig BSP_USING_UART
        bool "Enable UART"
        default y
        select RT_USING_SERIAL
        if BSP_USING_UART
            config BSP_USING_UART1
                bool "Enable UART1"
                default y

            config BSP_UART1_RX_USING_DMA
                bool "Enable UART1 RX DMA"
                depends on BSP_USING_UART1 && RT_SERIAL_USING_DMA
                default n
        endif
endmenu

当没有打开串口 DMA 配置时，以上代码对应的界面为

menuconfig1

当打开串口 DMA 配置时，以上代码对应的界面为

menuconfig2

语句分析： - menuconfig 这个语句和 config 语句很相似，但它在 config 的基础上要求所有的子选项作为独立的行显示。 - depends on 表示依赖某个配置选项，depends on BSP_USING_UART1 && RT_SERIAL_USING_DMA 表示只有当 BSP_USING_UART1 和 RT_SERIAL_USING_DMA 配置选项同时被选中时，当前配置选项的提示信息才会出现，才能设置当前配置选项

通过 env 选中以上配置界面的所有选项后，最终可在 rtconfig.h 文件中生成如下五个宏

#define RT_USING_SERIAL
#define BSP_USING_UART
#define BSP_USING_UART1
#define RT_SERIAL_USING_DMA
#define BSP_UART1_RX_USING_DMA

choice/endchoice 语句

choice 语句将多个类似的配置选项组合在一起，供用户选择一组配置项

RT-Thread Kconfig 文件中 choice 代码示例如下

menu "Hardware Drivers Config"
    menuconfig BSP_USING_ONCHIP_RTC
        bool "Enable RTC"
        select RT_USING_RTC
        select RT_USING_LIBC
        default n
        if BSP_USING_ONCHIP_RTC
            choice
                prompt "Select clock source"
                default BSP_RTC_USING_LSE

                config BSP_RTC_USING_LSE
                    bool "RTC USING LSE"

                config BSP_RTC_USING_LSI
                    bool "RTC USING LSI"
            endchoice
        endif
endmenu

以上代码对应的配置界面为

choice

语句解析： - prompt 给出提示信息，光标选中后回车进入就可以看到多个 config 条目定义的配置选项； - choice/endchoice 给出选择项，中间可以定义多个配置项供选择，但是在配置界面只能选择一个配置项。

comment 语句

comment 语句出现在界面的第一行，用于定义一些提示信息。

comment 代码示例如下

menu "Hardware Drivers Config"
    comment "uart2 pin conflict with Ethernet and PWM"
    config BSP_USING_COM2
        bool "Enable COM2"
        select BSP_USING_UART
        select BSP_USING_UART2
        default n
endmenu

以上代码对应的配置界面为

comment

source 语句

source 语句用于读取另一个文件中的 Kconfig 文件，如：

source "../libraries/HAL_Drivers/Kconfig"

上述语句用于读取当前 Kconfig 文件所在路径的上一级文件夹 libraries/HAL_Drivers 下的 Kconfig 文件。

c_hnie
关注
Linux内核配置Kconfig语法
诗歌年华
11-29 2万+
何为Kconfig 它的作用是什么内核源码编译过程 遍历每个源码目录（或配置指定的源码目录）Makefile 每个目录的Makefile 会根据Kconfig来定制要编译对象 回到顶层目录的Makeifle执行编译 那么我们就得出各个文件的作用：Kconfig ---> （每个源码目录下）提供选项 .config ---> （源码顶层目录下）保存选择结果 Makefile---> （每个源
Kconfig语法详解
赤壁淘沙
08-21 2608
Kconfig  当在内核目录执行”make menuconfig”的时候读取相应的Kconfig文件，来生成配置界面。Kconfig常用的语法主要是几个重要的条目，每个条目都有自己的依赖关系。使用这些依赖关系以确定条目的可见性。任何子条目是唯一，如果其父条目可见，则可见。1.1 config条目example: config MODVERSIONS bool "Set version in
Kconfig语法简介
ycq4853的博客
11-26 2471
（注：本文节选自正点原子嵌入式Linux开发指南） 本篇只是大概了解Kconfig原理，关于Kconfig的详细语法介绍，可以参考linux内核源码的文件Documentation/kbuild/kconfig-language.txt。 打开uboot根目录下的Kconfig，这个Kconfig文件就是顶层Kconfig，我们就以这个文件为例简单学习一下Kconfig语法。 1、mainmenu 顾名思义mainmenu就是主菜单，也就是输入“make menuco...
Kconfiglib 项目教程
最新发布
gitblog_00852的博客
08-10 333
Kconfiglib 项目教程 KconfiglibA flexible Python 2/3 Kconfig implementation and library项目地址:https://gitcode.com/gh_mirrors/kc/Kconfiglib 项目介绍 Kconfiglib 是一个用 Python 实现的 Kconfig 配置系统库。Kconfig 配置系统最初由 Linux...
linux2.6.x的配置文件kconfig语法
弄影里居
09-02 693
linux在2.6版本以后将配置文件由原来的config.in改为kconfig，对于kconfig的语法在/Documentation/kbuild/kconfig-language.txt中做了详细的说明，在这里给出kconfig-language.txt的中文版。介绍----在配置数据库的配置选项是以树的形式组织的：   +- Code maturity level options 
Kconfig语法
05-25
linux2.6.x的配置文件kconfig语法linux在2.6版本以后将配置文件由原来的config.in 改为kconfig，对于kconfig的语法在/Documentation/kbuild/kconfig-language.txt中做了详细的说 明，在这里给出kconfig-language.txt的中文版。 介绍 ---- 在配置数据库的配置选项是以树的形式组织的： +- Code maturity level options | +- Prompt for development and/or incomplete code/drivers +- General setup | +- Networking support | +- System V IPC | +- BSD Process Accounting | +- Sysctl support +- Loadable module support | +- Enable loadable module support | +- Set version information on all module symbols | +- Kernel module loader +- ... 每个选项都有其自己的依赖关系。这些依赖关系决定了选项是否是可见的。父选项可见，子选项才能可见。 菜单选项 -------- 大多数的选项都定义了一个配置选项，其它选项则有助于对它们进行组织。(原文：Most entries define a config option, all other entries help to organize them.)一个配置选项定义可以是下面 的形式： config MODVERSIONS bool "Set version information on all module symbols" depends MODULES help Usually, modules have to be recompiled whenever you switch to a new kernel. ... 每行都是以关键字开始，并可以接多个参数。"config" 为定义了一新的配置选项。下面的几行定义了该配置 选项的属性。属性可以是该配置选项的类型，输入提示(input prompt)，依赖关系，帮助信息和默认值。一 配置选项可以用相同的名字定义多次，但每个定义只能有一个输入提示并且类型还不能冲突。 菜单属性 -------- 一菜单选项可以有多个属性。并不要求这些属性可以用在任何地方(见语法)。 - 类型定义："bool"/"tristate"/"string"/"hex"/"int" 每个配置选项都必须指定类型。有两个基本类型：tristate 和 string，其他类型都是基于这两个基本 类型。类型定义可以用输入提示，所以下面的两个例子是等价的： bool "Networking support" 和 bool prompt "Networking support" - 输入提示： "prompt" ["if" ] 每个菜单选项最多只能有一个显示给用户的输入提示。可以用 "if" 来表示该提示的依赖关系，当然这是 可选的。 - 默认值："default" ["if" ] 一个配置选项可以有任意多个默认值。如果有多个默认值，那么只有第一个被定义的值是可用的。默认值并 不是只限于应用在定义他们的菜单选项。这就意味着默认值可以定义在任何地方或被更早的定义覆盖。 如果用户没有设置(通过上面的输入提示)，配置选项的值就是默认值。如果可以显示输入提示的话，就会把 默认值显示给用户，并可以让用户进行修改。 默认值的依赖关系可以用 "if" 添加。(可选项) - 依赖关系："depends on"/"requires" 为一菜单选项定义依赖关系。如果定义了多个依赖关系，它们之间用 '&&' 间隔。依赖关系也可以应用到 该菜单中所有的其它选项(同样接受一if表达式)，所以下面的两个例子是等价的： bool "foo" if BAR default y if BAR and depends on BAR bool "foo" default y - 反向依赖关系："select" ["if" ] 尽管普通的依赖关系可以降低一选项的上限，反向依赖能将这一限制降的更低。当前菜单选项的值是symbol 的最小值。如果symbol被选择了多次，上限就是其中的最大值。 反向依赖只能用在 boolean 或 tristate 选项上。 - 数据范围："range" ["if" ] 为int和hex类型的选项设置可以接受输入值范围。用户只能输入大于等于第一个symbol，小于等于第二个 symbol的值。 - 帮助信息： "help" or "---help---" 定义一帮助信息。帮助信息的结束就由缩进的水平决定的，这也就意味着信息是在第一个比帮助信息开始行 的缩进小的行结束。 "---help---" 和 "help" 在实现的作用上没有区别，"---help---" 有助于将文件中的配置逻辑与 给开发人员的提示分开。 菜单依赖关系 ------------ 依赖关系决定了菜单选项是否可见，也可以减少tristate的输入范围。tristate逻辑比boolean逻辑在表 达式中用更多的状态(state)来表示模块的状态。依赖关系表达式的语法如下： ::= (1) '=' (2) '!=' (3) '(' ')' (4) '!' (5) '&&' (6) '||' (7) 表达式是以优先级的降序列出的。 (1) 将symbol赋给表达式。boolean和tristate类型的symbol直接赋给表达式。所有其它类型的symbol 都赋 'n'。 (2) 如果两个symbol相等，返回'y'，否则为'n'。 (3) 如果两个symbol相等，返回'n'，否则为'y'。 (4) 返回表达式的值。用于改变优先级。 (5) 返回 (2-/expr/) 的结果。 (6) 返回 min(/expr/,/expr/) 的结果。 (7) 返回 max(/expr/,/expr/) 的结果。 一个表达式的值可以是'n'，'m'或'y'(或者是计算的结果 0,1,2）。当表达式的值为'm'或'y'的时候，菜 单项才是可见的。 symbol有两种类型：不可变的和可变的。不可变的symbol是最普通的，由'config'语句定义，完全由数字 、字母和下划线组成(alphanumeric characters or underscores)。 不可变的symbol只是表达式的一部分。经常用单引号或双引号括起来。在引号中，可以使用任何字符，使用引 号要用转义字符'\'。 菜单结构 -------- 菜单在树中的位置可由两种方法决定。第一种可以是这样： menu "Network device support" depends NET config NETDEVICES ... endmenu 所有的在"menu" ... "endmenu" 之间都是"Network device support"的子菜单。所有的子菜单选项 都继承了父菜单的依赖关系，比如，"NET"的依赖关系就被加到了配置选项NETDEVICES的依赖列表中。 还有就是通过分析依赖关系生成菜单的结构。如果菜单选项在一定程度上依赖于前面的选项，它就能成为该选 项的子菜单。首先，前面的(父)选项必须是依赖列表中的一部分并且它们中必须有满足下面两个条件的选项： - 如果父选项为'n'，子选项必须不可见。 - 如果父选项可见，子选项才能可见。 config MODULES bool "Enable loadable module support" config MODVERSIONS bool "Set version information on all module symbols" depends MODULES comment "module support disabled" depends !MODULES MODVERSIONS 直接依赖 MODULES，这就意味着如果MODULES不为'n'，该选项才可见。换句话说，当 MODULES可见时，选项才可见(MODULES的(空)依赖关系也是选项依赖关系的一部分)。 Kconfig 语法 ------------ 配置文件描述了菜单选项，每行都是以一关键字开头(除了帮助信息)。下面的关键字结束一菜单选项： - config - menuconfig - choice/endchoice - comment - menu/endmenu - if/endif - source 前5个同样可以用在菜单选项定义的开始。 config: "config" 定义了一配置选项 并且可以接受任何前面介绍的属性。 menuconfig: "menuconfig" 此关键字和前面的关键字很相似，但它在前面的基础上要求所有的子选项作为独立的行显示。(This is similar to the simple config entry above, but it also gives a hint to front ends, that all suboptions should be displayed as a separate list of options.) choices: "choice" "endchoice" 该关键字定义了一组选择项，并且选项可以是前面描述的任何属性。尽管boolean只允许选择一个配置选项， tristate可以抒多个配置选项设为'm'，但选项只能是boolean或tristate类型。这可以在一个硬件有多 个驱动的情况下使用，最终只有一个驱动被编译进/加载到内核，，但所有的驱动都可以编译成模块。 选项可以接受的另一个选项是"optional"，这样选项就被设置为'n'，没有被选中的。 comment: "comment" 这里定义了在配置过程中显示给用户的注释，该注释还将写进输出文件中。唯一可用的可选项是依赖关系。 menu: "menu" "endmenu" 这里定义了一个菜单，详细信息请看前面的"菜单结构"。唯一可用的可选项是依赖关系。 if: "if" "endif" 这里定义了if结构。依赖关系被加到所有在if ... endif 中的菜单选项中。
kconfig语法
10-23
内核移植Kconfig的语法 把那些目录 文件编入内核 哪些文件编程模块 内核的配置 等等
Kconfig 语法介绍1
01-09
Kconfig 语法介绍1 Kconfig 语法介绍1 Kconfig 语法介绍1 Kconfig 语法介绍1
linux kconfig详解及语法.pdf
10-30
### Linux Kconfig 详解与语法 #### 一、Kconfig 的基本概念 在 Linux 内核开发中，Kconfig 文件是用于定义内核配置菜单的关键文件。这些菜单允许用户在编译内核时进行定制，选择需要哪些特性、驱动程序等。...
Linux 2.6.x Kconfig 语法详解
"Kconfig语法是Linux内核配置文件的语法，主要用来管理配置选项，组织成树形结构。选项的依赖关系决定了它们的可见性。配置选项有多种类型，如bool、tristate、string、hex和int，每个选项可以有输入提示、默认值、...
linux下kconfig语法
04-07
kconfig 语法详细介绍，要看内核必看makefile，要看makefile必看kconfig,要看kconfig必要了解kconfig语法。 万里长征第一步，大家走好。
Linux内核移植：Kconfig语法详解
`Kconfig`语法使得这一过程更为高效和灵活。 1. **配置选项** - `config MODVERSIONS` 是一个配置选项的例子，定义了一个名为`MODVERSIONS`的布尔型选项，用于设置所有模块符号的版本信息。`bool`表示该选项为布尔...
Linux Kconfig语法详解与驱动添加关键
理解Linux Kconfig的语法结构对于内核开发者至关重要，它不仅决定了内核的配置界面，也影响了编译过程。通过熟练掌握`Kconfig`的配置项定义和`Makefile`的关联规则，开发者可以方便地定制和管理内核功能，确保代码...
Kconfig的语法
hellowording的专栏
04-30 603
介绍 ------------   配置数据库是组织在一个树结构里面的配置选项的集合。   +- 代码成熟级别选项        |  +- 对于开发和/或不完整的代码/驱动 的提示        +-通用配置        |  +- 网络支持        |  +- System V 进程通信机制        |  +- BSD
Kconfig语法详解--结合示例
玫瑰花店的博客
10-12 1915
Kconfig语法 bool/tristate/int/hex/string属性 bool 值为y或n tristate 值为y或m或n string 值为字符串 int 值为十进制整数 hex 值为十六进制整数 这几个属性一般必有一个。 default属性 表示缺省值，意思就是系统默认属性 help属性 这个属性是简介，没有啥实际作用，主要是写一些信息备注一类的 示例： 我在char目录的Kconfig下添加了一个新的驱动 config JASON1 tristate
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

c_hnie

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值