Step 5 : Boot the OS
===============================

.. tab-set::

   .. tab-item:: Boot the OS

        * In this program, you are going to learn


        .. panels::
                :container: container pb-4
                :column: col-lg-12 p-2
                :card: shadow

                * How to ?


.. panels::
        :container: container pb-4
        :column: col-lg-12 p-2
        :card: shadow

        Topics in this section,

                * :ref:`Boot the OS <freertos_qemu_rpi3b_step5_0>`


.. _freertos_qemu_rpi3b_step5_0:

.. tab-set::

   .. tab-item:: Boot the OS

        * Once the build is done and kernel image is generated run "make run" to boot the OS.

        .. code-block:: c

                FreeRTOS_with_QEMU/FreeRTOS-raspi3$ make run
                make kernel8.elf
                make[1]: Entering directory "/home/test/FreeRTOS_with_QEMU/FreeRTOS-raspi3"
                aarch64-none-elf-as -mcpu=cortex-a53 -c -o build/startup.o Demo/startup.S
                aarch64-none-elf-as -mcpu=cortex-a53 -c -o build/FreeRTOS_asm_vector.o Demo/FreeRTOS_asm_vector.S
                aarch64-none-elf-gcc -Wl,--build-id=none -std=gnu11 -T raspberrypi3.ld -o kernel8.elf -ffreestanding -O2 -nostdlib build/startup.o  build/FreeRTOS_asm_vector.o build/FreeRTOS_tick_config.o build/uart_string.o build/uart.o build/Sample-CLI-commands.o build/UARTCommandConsole.o build/FreeRTOS_CLI.o build/serial.o build/main.o build/port.o build/portASM.o build/list.o build/tasks.o build/queue.o build/timers.o build/heap_1.o
                aarch64-none-elf-objdump -D kernel8.elf > kernel8.list
                make[1]: Leaving directory "/home/test/FreeRTOS_with_QEMU/FreeRTOS-raspi3"
                qemu-system-aarch64 -M raspi3b -m 1024 -serial null -serial mon:stdio -nographic -kernel kernel8.elf
                Hello World !!!
                FreeRTOS command server.
                Type Help to view a list of registered commands.

                >

        * Now the Free-RTOS os is booted on QEMU with rpi3b.

        * Next, run help command in FreeRTOS command server to view the list of registered commands:

        .. code-block:: c

                >help

                help:
                 Lists all the registered commands


                task-stats:
                 Displays a table showing the state of each FreeRTOS task

                echo-3-parameters <param1> <param2> <param3>:
                 Expects three parameters, echos each in turn

                echo-parameters <...>:
                 Take variable number of parameters, echos each in turn


        * Run task-stats command to display the table which shows the state of each FreeRTOS task:

        .. code-block:: c

                >task-stats
                Task              State   Priority  Stack       "#"
                ****************************************
                CLI            	X	u	u	u
                IDLE           	R	u	u	u
                Tmr Svc        	B	u	u	u


        * To exit the command server or terminate the QEMU, enter ctrl+A and then press X.

        .. code-block:: c

                >QEMU: Terminated