Bootmusic User Guide

1. Overview¶

Bootmusic is the audio played when the computer is booted. It can play custom wav audio.

This article will introduce how to configure and use bootmusic.

2. Compile configuration options¶

2.1 bootmusic driver¶

SigmaStar drivers --->
        SigmaStar AIO

2.2 bootmusic command¶

Command line interface --->
    SigmaStar common commands --->
        bootmusic

2.3 System Partition¶

ARM architecture  --->
    SigmaStar arch features support  --->

The configuration files and audio files are placed in the same partition as the bootlogo.

File systems ---->
    Support Firmware FileSystem

If the storage medium uses emmc, you need to select Use firmwarefs on emmc/sdcard device, otherwise it cannot be selected.

2.4 CJSON parsing configuration file¶

SigmaStar drivers ---->
    Sigmastar CJSON FILE PARSER

3. padmux¶

AMP control requires setting padmux

boot/arch/arm/dts/pcupid-padmux.dtsi

You need to check the actual schematic to find the AMP pin and configure the padmux

4. Bootmusic storage location¶

project/board/ini/misc/$(music_name)

If you want to put the audio into the misc partition by default, you can modify the following location:

project/image/configs/general/misc.mk

You can also copy the audio to the misc partition after the board starts.

5. bootmusic parameter configuration¶

Related file paths:

project/board/ini/misc/audio_configuration.json

audio_configuration.json mainly includes the following parameters:

{
    "property":{
        "gain": 511,
        "file_name" : "boot_music.wav"
    }
}

Parameters	Description
gain	Range: 0~1023, step is 0.125db, minimum value is 0 (-63.75db), maximum value is 1023 (64db), default value is 511 (0db)
file_name	Boot audio file

6. Introduction to bootmusic command¶

SigmaStar # help bootmusic
bootmusic - playback boot music

Usage:
bootmusic bootmusic [gain]
    gain: set gain value [0~1023]

Example:

bootmusic // Without parameters, the gain parameter in audio_confirguation.json is used by default

bootmusic 500 // Set the gain value to 500

For debug flag, refer to debug level in Audio Development Guide. Here, 0x04 can print information.

To get debug information:

setenv aiodbglevel 0x04
saveenv