Vicharak Linux Configuration Tool

Fact

vicharak-config also has a systemd service that is use configure system prior to system boot and after the system boots.

Vicharak Config TUI

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Please select an option below:                                                             │
│                                                                                            │
│                                    System Maintaince                                       │
│                                    Hardware                                                │
│                                    Overlays                                                │
│                                    Connectivity                                            │
│                                    Advanced Options                                        │
│                                    User Settings                                           │
│                                    Localization                                            │
│                                    About                                                   │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

Note

The above menu might be shown differently depending on the terminal style.

How to navigate around vicharak-config

  • Use UP or DOWN key to move the selection across available options.

  • Use RIGHT or LEFT key to move in or out of the options menu and also, allows you to select or option.

  • Alternatively, you can also use TAB key to switch between them.

  • Enter key is used to confirm the corresponding option.

  • ESC key is used to do back to previous menu.

Available Features

System Maintenance

This feature allows you to update the packages and bootloader.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Please select an option below:                                                             │
│                                                                                            │
│                                    **System Maintaince**                                   │
│                                    Hardware                                                │
│                                    Overlays                                                │
│                                    Connectivity                                            │
│                                    Advanced Options                                        │
│                                    User Settings                                           │
│                                    Localization                                            │
│                                    About                                                   │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

System Update

This option allows you to update the firmware packages that are installed on the system. It uses apt-get to update these packages to their latest versions.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ System Maintaince                                                                          │
│                                                                                            │
│                                      **System Update**                                     │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

Hardware

This feature allows you to configure different hardware options.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Please select an option below:                                                             │
│                                                                                            │
│                                    System Maintaince                                       │
│                                    **Hardware**                                            │
│                                    Overlays                                                │
│                                    Connectivity                                            │
│                                    Advanced Options                                        │
│                                    User Settings                                           │
│                                    Localization                                            │
│                                    About                                                   │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

Video capture devices

This option allows you to capture the camera frame using v4l2-ctl. It uses v4l2-ctl to capture the camera frame.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Manage on-board hardware                                                                   │
│                                                                                            │
│                             **Video capture devices**                                      │
│                             GPIO LEDs                                                      │
│                             Thermal governor                                               │
│                             Configure DSI display mirroring                                │
│                             40-pin GPIO                                                    │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

GPIO LEDs

This option allows you to enable/disable the LEDs. It changes the leds triggers by echoing the specific trigger to the LED sysfs.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Manage on-board hardware                                                                   │
│                                                                                            │
│                             Video capture devices                                          │
│                             **GPIO LEDs**                                                  │
│                             Thermal governor                                               │
│                             Configure DSI display mirroring                                │
│                             40-pin GPIO                                                    │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

- Select any LED to enable/disable/modify its trigger

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Below are the available LEDs and their triggers.                                           │
│ Select any to update their trigger.                                                        │
│                                                                                            │
│    [*] :power [default-on]                                                                 │
│    [ ] :status [heartbeat]                                                                 │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

- Select the LED trigger from the list of available LED triggers.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Please select the new trigger:                                                             │
│                                                                                            │
│    ( ) kbd-shiftllock                                                                      │
│    ( ) kbd-shiftrlock                                                                  ▒   │
│    ( ) kbd-ctrlllock                                                                       │
│    ( ) kbd-ctrlrlock                                                                   ▒   │
│    ( ) mmc2                                                                            ▒   │
│    ( ) timer                                                                           ▒   │
│    ( ) oneshot                                                                         ▒   │
│    (*) disk-activity                                                                   ▒   │
│    ( ) disk-read                                                                       ▒   │
│    ( ) disk-write                                                                          │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

- Upon succesful completion, LED trigger will be updated.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│                                                                                            │
│ LED trigger has been updated.                                                              │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                           <Ok>                                             │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

Change thermal governor

This option allows you to change the thermal governor. It changes thermal governor by echoing to the specific sysfs.

- Select thermal governor

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Please select the thermal governor.                                                        │
│ Recommendation: fanless or DC fan => power_allocator | PWM fan => step_wise                │
│                                                                                            │
│    ( ) power_allocator                                                                     │
│    ( ) user_space                                                                          │
│    (*) step_wise                                                                           │
│    ( ) fair_share                                                                          │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

- Upon succesful completion, thermal governor will be updated.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│                                                                                            │
│ Thermal governor has been updated.                                                         │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                           <Ok>                                             │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

DSI mirroring

: This option allows you to enable/disable DSI mirroring. It uses vicharak-config to enable/disable DSI mirroring.

40-Pin GPIO header

This option allows you to enable/disable 40-pin GPIO header. Additionally, it can be used to check the current state of the 40-pin GPIO header.

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│ Please select the test case:                                                               │
│                                                                                            │
│                                  Set all GPIO to High                                      │
│                                  Set all GPIO to Low                                       │
│                                  **Get all GPIO state**                                    │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                         <Ok>                             <Cancel>                          │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘

┌────────────────────┤ VICHARAK_CONFIG ├───────────────────────┐
│ Following is the current reading of all supported GPIO pins  │
│                                                              │
│                                                              │
│ 0: Low | 1: High | E: Error                                  │
│                                                              │
│ State  Pin  State                                            │
│        1 2                                                   │
│        3 4                                                   │
│        5 6                                                   │
│ 1      7 8      1                                            │
│        9 10     1                                            │
│ 0     11 12     0                                            │
│ 0     13 14                                                  │
│ 0     15 16     0                                            │
│       17 18     0                                            │
│       19 20                                                  │
│       21 22     0                                            │
│       23 24                                                  │
│       25 26                                                  │
│ 1     27 28     1                                            │
│ 1     29 30                                                  │
│ 1     31 32     1                                            │
│ 1     33 34                                                  │
│ 0     35 36     0                                            │
│ 0     37 38     0                                            │
│       39 40     0                                            │
│                                                              │
│       <Ok>                <Cancel>                           │
└──────────────────────────────────────────────────────────────┘

Overlays

This feature allows you to configure different overlays options.

Warning

┌────────────────────────────────────┤ VICHARAK_CONFIG ├─────────────────────────────────────┐
│                                                                                            │
│ WARNING                                                                                    │
│                                                                                            │
│ Overlays, by its nature, require "hidden" knowledge about the running device tree.         │
│ While major breakage is unlikely, this does mean that after kernel update, the overlay may │
│ cease to work.                                                                             │
│                                                                                            │
│ If you accept the risk, select Yes to continue.                                            │
│ Otherwise, select No to go back to previous menu.                                          │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                                                                                            │
│                          <Yes>                             <No>                            │
│                                                                                            │
└────────────────────────────────────────────────────────────────────────────────────────────┘
  • Enable DTBO overlays

    This option allows you to enable/disable the DTBO overlays. It uses uboot-update script installed inside rootfs to enable or disable the specific dtbo overlay from extlinux configuration.

  • Build third-party DTBO

    This option allows you to build the third-party DTBO. It builds and installs the dtbo using the device-tree-compiler utility.

Connectivity

This feature allows you to configure different connectivity options.

  • Configure network

    This option allows you to configure network using nmtui.

Advanced Options

This feature allows you to configure different advanced options.

  • Install GPU library

    This option allows you to install Mali GPU library and enable OpenGL support.

    It uses apt install to install the mali library from userdata partition and enables the gl4es library support for converting OpenGL-ES context to OpenGL.

    Tip

    Use gl4es prefix with your desired application to run that application with OpenGL.

    Example: gl4es supertuxkart

User Settings

This feature allows you to configure different user settings.

  • Change system password

    This option allows you to change the system password. It uses passwd to change the system password.

  • Change hostname

    This option allows you to change the system hostname. It uses hostnamectl to change the system hostname.

Localization

This feature allows you to configure different localization options.

  • Change Time-Zone

    This option allows you to change the system Time-Zone. It uses timedatectl to change the system Time-Zone.

  • Change Locale

    It will generate the new locale as per the selection.