====== Kernel bootargs user config ======

===== Introduction =====

This document explains how users can customize the Linux kernel boot parameters (bootargs) on Ubuntu for the Edge-2L.

===== How to customize Linux Kernel bootargs =====

You can add user-defined boot arguments by editing the file ''/boot/uEnv.txt''.

The default contents of this file are similar to the following:

```shell
$ cat /boot/uEnv.txt 
#############################DO NOT TOUCH THIS OPTION#############################
rootdev=root=UUID=a92f7f2f-0d4a-4607-a45a-4549cfe71036
partitiontype=partition_type=generic
#############################DO NOT TOUCH THIS OPTION#############################
## Setup console
consoles=console=ttyS0,921600 console=tty0

## Setup FAN mode
fan_mode=auto

## Add user args here, spilt with space.
## e.g. Add bootargs 'test1=111 test2=222'
## boot_user_args=test1=111 test2=222
boot_user_args=
```

==== Normal bootargs ====
You can append your custom boot arguments to the ''boot_user_args='' configuration variable.

Example: To add the bootargs ''cgroup_enable=cpuset cgroup_memory=1 cgroup_enable=memory systemd.unified_cgroup_hierarchy=0'', the line should look like this:

```shell
boot_user_args=cgroup_enable=cpuset cgroup_memory=1 cgroup_enable=memory systemd.unified_cgroup_hierarchy=0
```

/* Edge-2L support kernel6.1 only.
==== Console Bootargs ====
<WRAP important>
This configuration is suitable for only the 5.15 kernel.
</WRAP>

You can change the linux UART pins for normal usage by modifying the configuration ''console=''

^ UART mode ^ Configuration ^
| Configure the UART for linux debug | ''consoles=console=ttyS0,<baud rate> console=tty0'' |
| Configure the UART for general usage | ''consoles=console=tty0'' |

eg. Enable linux UART console with 921600 baud rate should be as below:

```shell
consoles=console=ttyS0,921600 console=tty0
```

^ Model          ^ Baudrate   ^
| VIM3/VIM3L     | 115200     |
| VIM4/VIM1S     | 921600     |

<WRAP important >
Please make sure the bootargs are split with space and don't add quotation marks.
</WRAP>


<WRAP info >
Save the file and reboot to take effect.
</WRAP>
*/
===== How to check the current Kernel bootargs =====

After rebooting, you can verify the active kernel command line by running:

```shell
$ cat /proc/cmdline
```