3A5000之UEFI

/dev/sda1 on /boot/efi type vfat (rw,relatime,fmask=0022,dmask=0022,codepage=936,iocharset=cp936,shortname=mixed,utf8,errors=remount-ro)

Shell> help
alias         - Displays, creates, or deletes UEFI Shell aliases.
attrib        - Displays or modifies the attributes of files or directories.
bcfg          - Manages the boot and driver options that are stored in NVRAM.
cd            - Displays or changes the current directory.
cls           - Clears the console output and optionally changes the background and foreground color.
comp          - Compares the contents of two files on a byte-for-byte basis.
connect       - Binds a driver to a specific device and starts the driver.
cp            - Copies one or more files or directories to another location.
date          - Displays and sets the current date for the system.
dblk          - Displays one or more blocks from a block device.
devices       - Displays the list of devices managed by UEFI drivers.
devtree       - Displays the UEFI Driver Model compliant device tree.
dh            - Displays the device handles in the UEFI environment.
disconnect    - Disconnects one or more drivers from the specified devices.
dmem          - Displays the contents of system or device memory.
dmpstore      - Manages all UEFI variables.
drivers       - Displays the UEFI driver list.
drvcfg        - Invokes the driver configuration.
drvdiag       - Invokes the Driver Diagnostics Protocol.
echo          - Controls script file command echoing or displays a message.
edit          - Provides a full screen text editor for ASCII or UCS-2 files.
eficompress   - Compresses a file using UEFI Compression Algorithm.
efidecompress - Decompresses a file using UEFI Decompression Algorithm.
else          - Identifies the code executed when 'if' is FALSE.
endfor        - Ends a 'for' loop.
endif         - Ends the block of a script controlled by an 'if' statement.
exit          - Exits the UEFI Shell or the current script.
for           - Starts a loop based on 'for' syntax.
getmtc        - Gets the MTC from BootServices and displays it.
goto          - Moves around the point of execution in a script.
help          - Displays the UEFI Shell command list or verbose command help.
hexedit       - Provides a full screen hex editor for files, block devices, or memory.
if            - Executes commands in specified conditions.
ifconfig      - Modifies the default IP address of the UEFI IPv4 Network Stack.
load          - Loads a UEFI driver into memory.
loadpcirom    - Loads a PCI Option ROM.
ls            - Lists the contents of a directory or file information.
map           - Displays or defines file system mappings.
memmap        - Displays the memory map maintained by the UEFI environment.
mkdir         - Creates one or more new directories.
mm            - Displays or modifies MEM/MMIO/IO/PCI/PCIE address space.
mode          - Displays or changes the console output device mode.
mv            - Moves one or more files to a destination within or between file systems.
openinfo      - Displays the protocols and agents associated with a handle.
parse         - Retrieves a value from a standard format output file.
pause         - Pauses a script and waits for an operator to press a key.
pci           - Displays PCI device list or PCI function configuration space and PCIe extended
configuration space.
pcieswitch    - PCIE signal test switch.
pcietest      - PCIE signal test.
ping          - Ping the target host with an IPv4 stack.
reconnect     - Reconnects drivers to the specific device.
reset         - Resets the system.
rm            - Deletes one or more files or directories.
rtcWakeup     - Test rtc wakeup after Shutdown.
run           - Load and run the linux kernal.
satatest      - SATA signal test.
sermode       - Sets serial port attributes.
set           - Displays or modifies UEFI Shell environment variables.
setsize       - Adjusts the size of a file.
setvar        - Displays or modifies a UEFI variable.
shift         - Shifts in-script parameter positions.
smbiosview    - Displays SMBIOS information.
spi           - Read or write spi flash.
stall         - Stalls the operation for a specified number of microseconds.
time          - Displays or sets the current time for the system.
timezone      - Displays or sets time zone information.
touch         - Updates the filename timestamp with the current system date and time.
type          - Sends the contents of a file to the standard output device.
unload        - Unloads a driver image that was already loaded.
usbtest       - USB signal test.
ver           - Displays UEFI Firmware version information.
vers          - Displays Loongson UEFI build version information.
vol           - Displays or modifies information about a disk volume.

Shell> set
    path = FS0:\efi\tools\;FS0:\efi\boot\;FS0:\;FS1:\efi\tools\;FS1:\efi\boot\;FS1:\;FS2:\efi\tools\
;FS2:\efi\boot\;FS2:\;FS3:\efi\tools\;FS3:\efi\boot\;FS3:\
nonesting = False
debuglasterror = 0x0
lasterror = 0x0
profiles = ;Driver1;Debug1;network1;spi;signal test;LoongsonTest;vers;
uefishellsupport = 3
uefishellversion = 2.2
uefiversion = 2.70

Shell> ver
UEFI Interactive Shell v2.2
EDK II
UEFI v2.70 (EDK II, 0x00010000)

Shell> help cd
Displays or changes the current directory.

CD [path]

  path - Specifies the relative or absolute directory path.

NOTES:
  1. This command changes the current working directory that is used by the
     UEFI Shell environment. If a file system mapping is specified, then the
     current working directory is changed for that device. Otherwise, the
     current working directory is changed for the current device.
  2. If path is not present, then the current working directory (including
     file system mapping) is displayed to standard out.
  3. The table below describes the conventions that are used to refer to the
     directory, its parent, and the root directory in the UEFI Shell
     environment.
     Convention  Description
      '.'        Refers to the current directory.
      '..'       Refers to the directory's parent.
      '\'        Refers to the root of the current file system.
  4. The current working directory is maintained in the environment
     variable %cwd%.

EXAMPLES:
  * 将当前文件系统变为映射的 fs0 文件系统：
    Shell> fs0:

  * 将当前目录变为 efi 子目录：
    fs0:\> cd efi

  * 将当前目录变为父目录 (fs0:\):
    fs0:\efi\> cd ..

  * 将当前目录变为 'fs0:\efi\Tools':
    fs0:\> cd efi\Tools

  * 将当前目录变为当前 fs 的根目录 (fs0):
    fs0:\efi\Tools\> cd \
Shell>

Shell> help reset
Resets the system.

RESET [-w [string]]
RESET [-s [string]]
RESET [-c [string]]

  -s     - 关机
  -w     - 热启动
  -c     - 冷启动
  string - 给出一个原因并重启

NOTES:
  1. This command resets the system.
  2. The default is to perform a cold reset unless the -w parameter is
     specified.
  3. If a reset string is specified, it is passed into the Reset()
     function, and the system records the reason for the system reset.

Shell> help spi
Read or write spi flash.

SPI [-r StartAddr Size]/[-w data/-w StartAddr data]/[-u file]/[-e]/[-l file StartAddr Size]

  -r           - read ls7a spi from address.
  -w           - write ls7a spi data.
  -u           - update ls3a spi flash.
  -e           - erase ls7a spi flash by Sector.
  -x           - download correct firmware to Serial ROM for xhci.
  -l           - write ls7a spi data from start address to end address

NOTES:
  1. This command can update flash you should be careful.

  * 刷新固件
    fs0:\> spi -u uefi

  * write the ls7a spi flash:
    fs0:\> spi -w 00:11:22:33:44:55
    fs0:\> spi -w 0x10 aa:bb:cc:dd:ee:ff

  * write the ls7a spi flash:
    fs0:\> spi -l vbios.bin 0x1000 0x20000
Shell> 

<M> EFI Variable Support via sysfs

efivarfs on /sys/firmware/efi/efivars type efivarfs (rw,nosuid,nodev,noexec,relatime)

$ efibootmgr -h
efibootmgr version 17
usage: efibootmgr [options]
        -a | --active         sets bootnum active
        -A | --inactive       sets bootnum inactive
        -b | --bootnum XXXX   modify BootXXXX (hex)
        -B | --delete-bootnum delete bootnum
        -c | --create         create new variable bootnum and add to bootorder
        -C | --create-only      create new variable bootnum and do not add to bootorder
        -D | --remove-dups      remove duplicate values from BootOrder
        -d | --disk disk       (defaults to /dev/sda) containing loader
        -r | --driver         Operate on Driver variables, not Boot Variables.
        -e | --edd [1|3|-1]   force EDD 1.0 or 3.0 creation variables, or guess
        -E | --device num      EDD 1.0 device number (defaults to 0x80)
        -g | --gpt            force disk with invalid PMBR to be treated as GPT
        -i | --iface name     create a netboot entry for the named interface
        -l | --loader name     (defaults to "\EFI\arch\grub.efi") [1]
        -L | --label label     Boot manager display label (defaults to "Linux")
        -m | --mirror-below-4G t|f mirror memory below 4GB
        -M | --mirror-above-4G X percentage memory to mirror above 4GB
        -n | --bootnext XXXX   set BootNext to XXXX (hex)
        -N | --delete-bootnext delete BootNext
        -o | --bootorder XXXX,YYYY,ZZZZ,...     explicitly set BootOrder (hex)
        -O | --delete-bootorder delete BootOrder
        -p | --part part        partition containing loader (defaults to 1 on partitioned devices)
        -q | --quiet            be quiet
        -t | --timeout seconds  set boot manager timeout waiting for user input.
        -T | --delete-timeout   delete Timeout.
        -u | --unicode | --UCS-2  handle extra args as UCS-2 (default is ASCII)
        -v | --verbose          print additional information
        -V | --version          return version and exit
        -w | --write-signature  write unique sig to MBR if needed
        -y | --sysprep          Operate on SysPrep variables, not Boot Variables.
        -@ | --append-binary-args file  append extra args from file (use "-" for stdin)
        -h | --help             show help/usage

$ efibootmgr -v
BootCurrent: 0005
Timeout: 3 seconds
BootOrder: 0005,0004,0001,0002,0003,0000
Boot0000* Enter Setup	FvVol(7cb8bdc9-f8eb-4f34-aaea-3ee4af6516a1)/FvFile(462caa21-7614-4503-836e-8ab6f4662331)
Boot0001  UEFI BootManagerMenuApp	FvVol(7cb8bdc9-f8eb-4f34-aaea-3ee4af6516a1)/FvFile(eec25bdc-67f2-4d95-b1d5-f81b2039d11d)
Boot0002* UEFI S5170-256	PciRoot(0x0)/Pci(0x8,0x0)/Sata(0,65535,0)N.....YM....R,Y.
Boot0003* UEFI Shell	FvVol(7cb8bdc9-f8eb-4f34-aaea-3ee4af6516a1)/FvFile(7c04a583-9e3e-4f1c-ad65-e05268d0b4d1)
Boot0004* rEFInd Boot Manager	HD(1,GPT,125d060a-911a-4a4f-ba44-7035cb7bad01,0x800,0xfa000)/File(\EFI\refind\refind_loongarch64.efi)
Boot0005* arch	HD(1,GPT,125d060a-911a-4a4f-ba44-7035cb7bad01,0x800,0xfa000)/File(\EFI\arch\grubloongarch64.efi)

# efibootmgr -o 0004,0005,0001,0002,0003,0000

# efibootmgr -c -w -L "Linux Boot Manager" -d /dev/sda -p 1 -l \EFI\BOOT\BOOTLA64.EFI
BootCurrent: 0005
Timeout: 3 seconds
BootOrder: 0006,0005,0004,0001,0002,0003,0000
Boot0000* Enter Setup
Boot0001  UEFI BootManagerMenuApp
Boot0002* UEFI S5170-256
Boot0003* UEFI Shell
Boot0004* rEFInd Boot Manager
Boot0005* arch
Boot0006* Linux Boot Manager

$ efibootmgr -b 0006 -B
BootCurrent: 0005
Timeout: 3 seconds
BootOrder: 0005,0004,0001,0002,0003,0000
Boot0000* Enter Setup
Boot0001  UEFI BootManagerMenuApp
Boot0002* UEFI S5170-256
Boot0003* UEFI Shell
Boot0004* rEFInd Boot Manager
Boot0005* arch

#include <efi.h>
#include <efilib.h>

EFI_STATUS
EFIAPI
efi_main (EFI_HANDLE ImageHandle, EFI_SYSTEM_TABLE *SystemTable) {
   InitializeLib(ImageHandle, SystemTable);
   Print(L"Hello, world!\n");

   return EFI_SUCCESS;
}

ARCH            = $(shell uname -m | sed s,i[3456789]86,ia32,)
OBJS            = main.o
TARGET          = hello.efi
EFIINC          = /usr/include/efi
EFIINCS         = -I$(EFIINC) -I$(EFIINC)/$(ARCH) -I$(EFIINC)/protocol
LIB             = /usr/lib
EFI_CRT_OBJS    = $(LIB)/crt0-efi-$(ARCH).o
EFI_LDS         = $(LIB)/elf_$(ARCH)_efi.lds
CFLAGS          = $(EFIINCS) -fno-stack-protector -fpic \
                  -fshort-wchar -Wall
ifeq ($(ARCH),loongarch64)
    CFLAGS += -march=loongarch64 -mabi=lp64 -g -O2 \
              -Wextra -Werror -fno-strict-aliasing \
              -ffreestanding -fno-stack-check \
              $(if $(findstring gcc,$(CC)),-fno-merge-all-constants,)
endif

LDFLAGS         = -nostdlib --warn-common --no-undefined --fatal-warnings -shared \
                  --build-id=sha1 -Bsymbolic --defsym=EFI_SUBSYSTEM=0xa -T $(EFI_LDS) -L $(LIB) $(EFI_CRT_OBJS) \

all: $(TARGET)

hello.so: $(OBJS)
	ld $(LDFLAGS) $(OBJS) -o $@ -lefi -lgnuefi

%.efi: %.so
	@objcopy -j .text -j .sdata -j .data -j .dynamic -j .dynsym -j .rel \
            -j .rela -j .rel.* -j .rela.* -j .rel* -j .rela* \
            -j .reloc -O binary $^ $@

clean:
	@rm -f *.o *.efi *.so

$ make

$ cp hello.efi /boot/efi/hello.efi

Shell> fs0:\hello.efi
Hello, world!
Shell> 

$ git clone https://github.com/loongarch64/gnu-efi
$ git checkout dev-la64/master
$ make
$ make apps
$ ls loongarch64/apps/
AllocPages.efi  debughook.efi        drv0.efi      exit.efi       lfbgrid.efi   printenv.efi  setdbg.efi  t2.efi  t4.efi  t6.efi  t8.efi   t.efi
bltgrid.efi     debughook.efi.debug  drv0_use.efi  FreePages.efi  modelist.efi  route80h.efi  setjmp.efi  t3.efi  t5.efi  t7.efi  tcc.efi  unsetdbg.efi

cat /boot/efi/tools/startup.nsh

cls
echo "Press any key to continue..."
pause

if exist fs0:\hello.efi then
  echo "Run hello.efi..."
  fs0:\hello.efi
endif

if exist fs0:\EFI\arch\grubloongarch64.efi then
  echo "Run Grub..."
  fs0:\EFI\arch\grubloongarch64.efi
endif