BeagleBoard/GSoC/2021 Proposal/beagle config

< BeagleBoard‎ | GSoC
Revision as of 01:50, 9 April 2021 by Satacker (talk | contribs)
Jump to: navigation, search

Proposal for Beagle Config


  • Pre-application phase


  • Completed all the general requirements
  • Completed "Hello Wolrd" of cross-compilation mentioned in the requirements list.
  • Sent a PR to the mentioned upstream #145

About You

About Your Project

  • Project name: Beagle Config


  • As we all know, nearly all of the user operations in Linux can be done using shell commands, scripts, and Linux Userspace API for advanced users. But all that being said for an average user and sometimes in production, these steps can be repetitive and time-consuming. For example- Simply sharing a network i.e. editing iptables and enabling forwarding on the host pc is an uphill task without a script provided. However running scripts could be dangerous. This explains that using a compiled program instead can implement safe and proper security.
  • Enabling the PRU and loading the firmware is much daunting and unless anybody goes through their usage Documentations it will be difficult.
  • Hence I propose beagle-config which is a terminal-based UI application that brings down the steep curve and enables anybody to config their beagle device as they wish. Also, a host-side application to enable ICS
  • Not only does it makes beagle devices more friendly but provides an edge to beagle devices over other similar platforms.
  • Also while configuring sometimes if the script has hard-coded values it makes it difficult for the user to go back to default configurations. With beagle-config that won't be a problem anymore. Beagle-Config will store the defaults at /usr/local/share/ and user configurations in /home/user/.config/beagle-config/Backups/config.json . This ensures portability and helps in reverting to defaults in case settings are unwanted.
  • Goal: Beagle-Config aims to provide the functionality to make the most common low-level configuration changes in beagle devices easily and providing a terminal UI to do the same as well as a host-side application for ICS

Implementation Details

  • Beagle-Config consists of a host-side application developed with cross-platform framework Qt.

Reason to choose Qt: It seems that Qt satisfies the objectives which are Good Documentations, Fewer dependencies, and as for deployment electron is easier but Qt is not much difficult. This isn't performance-critical right now but if in the future it adds some performance-critical activity then Qt would be great here.

  • Beagle-Config on user (board) side which will use bash, C/C++ as back end for low-level access to linux's userspace API and FTXUI for frontend.

Comparision of a few text-based GUI

Name Description
  • This is again a JS library
  • Easy to develop
  • UI/UX feels old enough or retro like
  • C++ is a plus point
  • Depends on libncursesw
blessed contrib
  • JS
  • Nice Widgets support
  • Python
  • Many applications built on it
  • Functional style. Inspired by [1] and React
  • No dependencies.
  • Cross platform
  • Simple and elegant syntax

This wasn't a detailed review but definitely, I would choose FXTUI despite its newness, I feel it has all that I need and doesn't involve dependencies while providing a DOM manip. functional style like react.

  • All the configuration options are stored in the user's home directory inside /home/user/.config/beagle-config/Backups/config.json
  • A restore to defaults option


  • Internet Connection Sharing Enabling in Linux as well as windows
  • console for SSH within the application

Recipe Outline -

  1. TODO

User (Board)

System Options

The system options sub-menu allows you to make configuration changes to various parts of the boot, login, and networking process, along with some other system-level changes.

PRU enable/disable

This will enable hobbyists to enable/disable their PRUs (/var/lib/cloud9/common/Makefile TARGET=gpio.prux start) and if they want to test their PRU code in c or in simppru (Checks and asks if they want to install). Example -

               PRU Conf
                       PRU 1 Enable Disable
                       PRU 2 Enable Disable

Recipe Outline -

  1. It will essentially be a wrapper around make targets (clpru and lnkpru ,the PRU compiler and linker are already installed on the standard images.)
  2. The PRUs appear in the Linux file space at /sys/devices/platform/ocp/4a32600*.pruss-soc-bus/4a300000.pruss

Note: If it comes out that the addresses are not fixed I would have to traverse through the ocp node until I discover "pruss-soc-bus"

  1. Select .out file and copy to /sys/devices/platform/ocp/4a32600*.pruss-soc-bus/4a300000.pruss/lib/firmware/am335x-pruX-fw (X=0,1)

GPIO configuration

Enabling a GPIO pin for input/output using config-pin Example -

                GPIO 18 -
                       Enable Disable Set Value

Recipe Outline -

  1. Now there's config-pin .
  2. Also traversing through /sys/class/gpio is an option

Internet Sharing and Client Configurations

Enables users to share their host internet with a click Example -

                   Host A
                       Enable Internet
                               Set IP gateway
                       Return to Defaults
               Host Name           BBB
               Country Code       <Select Menu>

Recipe Outline -

  1. Ask for user password
  2. Add routes for default gateways
  3. Add nameservers IP addresses

On host side -

  1. If Linux then configures USB Ethernet with default IP address and iptables rules.
  2. If windows then use `net start SharedAccess` (Windows 7) or Powershell script

eMMC stats

Enables users to extend the sd card partition size if available Example -

              eMMC Storage        Total 52 %
                   Free            --------
                   Extend          --------

Recipe Outline -

  1. TODO

Freeze Packages

apt-mark hold <package> and make a note of it in JSON

Wireless Configurations

For wireless-enabled devices like beaglebone black wireless configuring Access Point names, mDNS configurations, etc Recipe Outline -

  1. Enable /etc/systemd/resolved.conf and turn MulticastDNS=yes
  2. The other way is to using Avahi : check if avahi is installed
  3. TODO

Sensor Stats and Configurations

If beagle bone has onboard sensors then enabling them, viewing stats For ex. on Beaglebone Blue 9-axis IMU, barometer, thermometer, and a balancing LiPo charger are present Recipe Outline -

  1. TODO


Configure passwords along with the addition of users, groups Recipe Outline -

  1. TODO

Boot / Auto login

We can configure whether to boot in desktop mode or using just console enabled. Add option to login automatically. Recipe Outline -

  1. TODO

User LED

Configure the USR LEDs on the board. Their frequency and events. Recipe Outline -

  1. TODO

Firmware Update

Firmware - apt update and upgrade to update your system, Recipe Outline -

  1. Provide timely update option
  2. wrapper for apt update and apt upgrade
  3. TODO

Display Options


Enable configuration of HDMI/DVI if the board supports it Recipe Outline -

  1. TODO

Interfacing Options

Cape Configurations

Performs apt install bb-cape-overlays If a beagle board and its associated cape need a configuration, this can be configured here easily. Recipe Outline -

  1. TODO


Configure ssh, enable/disable, and setup password Recipe Outline -

  1. TODO

Provide an easy interface to manage uboot overlays

Recipe Outline - U-Boot /boot/uEnv.txt configuration in /boot/uEnv.txt:

               To Disable eMMC:
               To Disable HDMI VIDEO & AUDIO:

Overlay File System

Enable or disable a read-only file system Basically, the writes put a lot of pressure on SD cards, we can disable and use it read-only when not needed. Recipe Outline -

  1. Change the root mount to read-only
  2. Add a couple of temporary file systems to handle logs. This will contain the option for logging size.
  3. Backup the old fstab

Reference - Link1 , link2 Alternative -

  1. Overlay file systems have been defaulted in since Kernel 3.18
  2. Essentially we can create a top-level directory that can be modified while having the layers beneath to be read only
  3. mount -t overlay overlay -o lowerdir=/lower,upperdir=/upper,workdir=/work /merged . Note - work should be an empty directory
  4. Update the init ramfs image and uEnv.txt

Reliable Overlay FS


Update Beagle-Config Recipe Outline -

  1. First way is to create a ppa reference
  2. Second is to make Github releases and code the application to check for a new release


Show strings, license, author, version name, and kernel version


Date Status Details
13/04/2021 to 17/05/2021 Application Review Period Right After submitting the application I will go through a rigorous set of reference materials
  • Fix my bricked Pocketbeagle by debugging using UART output
  • Go through FTXUI documentations
  • Resource for Shell scripting revision
17/05/2021 to 07/06/2021 Community Bonding
  • Before it begins Complete College exams, vivas, practicals, and stuff
  • Make sure that stuff for the project is available
  • Coding Begins
14/06/2021 Milestone #1
  • Introductory Video
  • Implement a basic TUI with basic operations like USR LED enable, disable, frequency
  • Add
  1. Network (ICS and Wireless settings)
  2. ssh
  3. timezone


21/06/2021 Milestone #2
  • Add
  1. PRU
  2. GPIO
  3. eMMC stats and sd card resizer


28/06/2021 Milestone #3
  • Add
  1. Sensor stats and
  2. Display
  3. boot
  4. Password
  5. Freeze Packages


05/07/2021 - 10/07/2021 Milestone #4
  • Review the configurations for errors
  • Documentation for everything till now
17/07/2021 Milestone #5
  • Add
  1. U-boot
  2. File System
  3. Firmware Update


24/07/2021 Milestone #6
  • Build A Host side Qt application to enable ICS
  • Add SSH console within the Application itself
31/07/2021 - 03/07/2021 Milestone #7
  • Documentation of everything till now
  • Brief overview and discussion with a mentor
  • Bring in required changes
10/08/2021 Milestone #8
  • Compile user(board) application with other latest kernels
  • Test the Host Application for cross platform functionality
17/08/2021 Milestone #9
  • Add additional configurations for updates
  • Document If anything remaining
  • Add final About page
  • Distribute a Debian package
  • Distribute Windows executable
24/08/2021 Milestone #10
  • Submit final work product and final mentor evaluation
  • Completion of YouTube video
31/08/2021 Milestone #11 Completion of GSoC

Experience and approach

  • Previously I have worked with Qt and Boost.ASIO. PID-Tuning-GUI is an application that sends data to ESP32 microcontroller which supports WiFi connectivity. Handled Application threads and Plotting of data as well as sending user input to the microcontroller.
  • kernel learn is a repository I had created for kernel learning purpose in which I had learned several Kernel Development Basics.
  • I have played with Pocketbeagle for a month and learned a lot about u-boot, device trees, and Loadable Kernel Modules.
  • This gives me the best of both the worlds embedded as well as a bit in the frontend (Qt).


  • There is good documentation of FXTUI and Qt
  • Plenty of examples to get me through if I am stuck.
  • Past experience regarding Qt and DOM manipulation combined with experience in embedded and loadable kernel module development will pay off in this duration.


  • Having a seamless one-click experience to configure is enjoyed by any user, be it production or a robotics team.
  • Provides a configuration file to the users. Remembers defaults and helps in accidental modification to low-level configurations.



  • For hello_world of cross-compilation, sent a PR to the mentioned upstream #145

Future Work

  • Theme options
  • Flashing functionality can be added instead of making the user download a third-party application like etcher
  • An IDE within the beagle-config host