Hello Shell

This is a derived work from the original Zephyr “Hello World” example! Most of the stuff in this README file needs to be redesigned and changed!

Overview

A simple Hello World example that can be used with any supported board and prints ‘Hello World! I’m THE SHELL’ to the console. This application can be built into modes:

Requirements

Building and Running

This project outputs ‘Hello World! I’m THE SHELL’ to the console. It can be built and executed as emulation in X86 Emulation (QEMU) as follows:

west build -b qemu_x86 -d build/helloshell-qemu_x86 bridle/samples/helloshell
west build -t run -d build/helloshell-qemu_x86

Also it can be built and executed on following targets:

  • As Native POSIX execution (native_posix), fancy command set mode:

    west build -b native_posix -d build/helloshell-native_posix bridle/samples/helloshell
west build -t run -d build/helloshell-native_posix

    Hint

    Connect a terminal emulator to the given pseudotty or start the application directly with the autoconnect argument:

    ./build/helloshell-native_posix/zephyr/zephyr.exe -attach_uart

  • As emulation in ARM Cortex-M3 Emulation (QEMU), fancy command set mode:

    west build -b qemu_cortex_m3 -d build/helloshell-qemu_cortex_m3 bridle/samples/helloshell
west build -t run -d build/helloshell-qemu_cortex_m3

    Hint

    Exit QEMU by pressing CTRL+A x.

  • On ST Nucleo F746ZG board, fancy command set mode:

    west build -b nucleo_f746zg -d build/helloshell-nucleo_f746zg bridle/samples/helloshell
west flash -d build/helloshell-nucleo_f746zg

Further you can deside either to run in a basic or fancy command set mode:

  • On ST Nucleo F746ZG board, basic command set mode:

    west build -b nucleo_f746zg -d build/helloshell-nucleo_f746zg bridle/samples/helloshell -- -DCONF_FILE=prj-minimal.conf
west flash -d build/helloshell-nucleo_f746zg

  • On ST Nucleo F746ZG board, fancy command set mode:

    west build -b nucleo_f746zg -d build/helloshell-nucleo_f746zg bridle/samples/helloshell -- -DCONF_FILE=prj.conf
west flash -d build/helloshell-nucleo_f746zg

Sample Output

Hello World! I'm THE SHELL from nucleo_f746zg


Please press the <Tab> button to see all available commands.
You can also use the <Tab> button to prompt or auto-complete all commands or its subcommands.
You can try to call commands with <-h> or <--help> parameter for more information.

Shell supports following meta-keys:
  Ctrl + (a key from: abcdefklnpuw)
  Alt  + (a key from: bf)
Please refer to shell documentation for more details.

Available commands:
  adc      :ADC commands
  bridle   :Bridle commands.
  clear    :Clear screen.
  device   :Device commands
  flash    :Flash shell commands
  gpio     :GPIO commands
  hello    :say hello
  help     :Prints the help message.
  history  :Command history.
  hwinfo   :HWINFO commands
  i2c      :I2C commands
  kernel   :Kernel commands
  log      :Commands for controlling logger
  pwm      :PWM shell commands
  resize   :Console gets terminal screen size or assumes default in case the
            readout fails. It must be executed after each terminal width change
            to ensure correct text display.
  sensor   :Sensor commands
  shell    :Useful, not Unix-like shell commands.

uart:~$ <Tab>
  adc      bridle   clear    device   flash    gpio     hello    help
  history  hwinfo   i2c      kernel   log      pwm      resize   sensor
  shell

uart:~$ hello -h
hello - say hello
uart:~$ hello
Hello from shell.

uart:~$ kernel version
Zephyr version 3.1.0

uart:~$ bridle version
Bridle version 3.1.0

uart:~$ kernel uptime
Uptime: 254707293 ms

uart:~$ kernel cycles
cycles: 4281597339 hw cycles

uart:~$ kernel threads
Threads:
 0x20020d28 sysworkq
        options: 0x0, priority: -1 timeout: 0
        state: pending, entry: 0x800b169
        stack size 1024, unused 864, usage 160 / 1024 (15 %)

*0x200208f8 shell_uart
        options: 0x0, priority: 14 timeout: 0
        state: queued, entry: 0x80044b9
        stack size 2048, unused 1136, usage 912 / 2048 (44 %)

 0x20020840 logging
        options: 0x0, priority: 14 timeout: 0
        state: pending, entry: 0x8002555
        stack size 768, unused 664, usage 104 / 768 (13 %)

 0x20020bb0 idle 00
        options: 0x1, priority: 15 timeout: 0
        state: , entry: 0x800e501
        stack size 320, unused 272, usage 48 / 320 (15 %)

uart:~$ kernel stacks
0x20020d28 sysworkq   (real size 1024):      unused 864      usage 160 / 1024 (15 %)
0x200208f8 shell_uart (real size 2048):      unused 1096     usage 952 / 2048 (46 %)
0x20020840 logging    (real size 768):       unused 664      usage 104 / 768 (13 %)
0x20020bb0 idle 00    (real size 320):       unused 272      usage 48 / 320 (15 %)
0x20023580 IRQ 00     (real size 2048):      unused 1484     usage 564 / 2048 (27 %)

uart:~$ _