Running a Hello OHOS Program

• Creating a Program
• Building
• Burning
• Running an Image
• Running a Program

This section describes how to create, compile, burn, and run the first program, and finally print Hello OHOS! on the develop board.

Creating a Program

1. Create a directory and the program source code.

   Create the applications/sample/camera/apps/src/helloworld.c directory and file whose code is shown in the following example. You can customize the content to be printed. For example, you can change OHOS to World. You can use either C or C++ to develop a program.

   #include <stdio.h>
   
   int main(int argc, char **argv)
   {
       printf("\n************************************************\n");
       printf("\n\t\tHello OHOS!\n");
       printf("\n************************************************\n\n");
   
       return 0;
   }

2. Create a build file.

   Create the applications/sample/camera/apps/BUILD.gn file. The file content is as follows:

   import("//build/lite/config/component/lite_component.gni")
   lite_component("hello-OHOS") {
     features = [ ":helloworld" ]
   }
   executable("helloworld") {
     output_name = "helloworld"
     sources = [ "src/helloworld.c" ]
     include_dirs = []
     defines = []
     cflags_c = []
     ldflags = []
   }

3. Add a new component.

   Add the configuration of the hello_world_app component to the build/lite/components/applications.json file. The sample code below shows some configurations defined in the applications.json file, and the code between ##start## and ##end## is the new configuration (Delete the rows where ##start## and ##end## are located after the configurations are added.)

   {
     "components": [
       {
         "component": "camera_sample_communication",
         "description": "Communication related samples.",
         "optional": "true",
         "dirs": [
           "applications/sample/camera/communication"
         ],
         "targets": [
           "//applications/sample/camera/communication:sample"
         ],
         "rom": "",
         "ram": "",
         "output": [],
         "adapted_kernel": [ "liteos_a" ],
         "features": [],
         "deps": {
           "components": [],
           "third_party": []
         }
       },
   ##start##
       {
         "component": "hello_world_app",
         "description": "Communication related samples.",
         "optional": "true",
         "dirs": [
           "applications/sample/camera/apps"
         ],
         "targets": [
           "//applications/sample/camera/apps:hello-OHOS"
         ],
         "rom": "",
         "ram": "",
         "output": [],
         "adapted_kernel": [ "liteos_a" ],
         "features": [],
         "deps": {
           "components": [],
           "third_party": []
         }
       },
   ##end##
       {
         "component": "camera_sample_app",
         "description": "Camera related samples.",
         "optional": "true",
         "dirs": [
           "applications/sample/camera/launcher",
           "applications/sample/camera/cameraApp",
           "applications/sample/camera/setting",
           "applications/sample/camera/gallery",
           "applications/sample/camera/media"
         ],

4. Modify the board configuration file.

   Add the hello_world_app component to the vendor/hisilicon/hispark_taurus/config.json file. The sample code below shows the configurations of the applications subsystem, and the code between ##start## and ##end## is the new configuration (Delete the rows where ##start## and ##end## are located after the configurations are added.)

         {
           "subsystem": "applications",
           "components": [
             { "component": "camera_sample_app", "features":[] },
             { "component": "camera_sample_ai", "features":[] },
   ##start##
             { "component": "hello_world_app", "features":[] },
   ##end##
             { "component": "camera_screensaver_app", "features":[] }
           ]
         },

Building

If the Linux environment is installed using Docker, perform the building by referring to Using Docker to Prepare the Build Environment. If the Linux environment is installed using a software package, go to the root directory of the source code and run the following commands for source code compilation:

hb set (Set the building path.)
. (Select the current path.)
Select ipcamera_hispark_taurus@hisilicon and press Enter.
hb build -f (Start building.)

Figure 1 Settings

The result files are generated in the out/hispark_taurus/ipcamera_hispark_taurus directory.

NOTICE: The U-boot file of the Hi3516D V300 development board can be obtained from the following path: device/hisilicon/hispark_taurus/sdk_liteos/uboot/out/boot/u-boot-hi3516dv300.bin

Burning

The Hi3516 development board allows you to burn flash memory over the USB port, serial port, or network port. The following uses the network port burning as an example.

1. Connect the PC and the target development board through the power port, serial port, and network port. In this section, the Hi3516DV300 is used as an example. For details, please refer to Introduction to the Hi3516 Development Board.

2. Open Device Manager, then check and record the serial port number corresponding to the development board.

   NOTE: If the serial port number is not displayed correctly, follow the steps described in Installing the Serial Port Driver on the Hi3516 or Hi3518 Series Development Boards.

   

3. Open DevEco Device Tool and go to Projects > Settings.

   

4. On the Partition Configuration tab page, modify the settings. In general cases, you can leave the fields at their default settings.

5. On the hi3516dv300 tab page, configure the programming options.

   • upload_port: Select the serial port number obtained in step 2.
   • upload_protocol: Select the programming protocol hiburn-net.
   • upload_partitions: Select the file to be programmed. By default, the fastboot, kernel, rootfs, and userfs files are programmed at the same time.

   

6. Check and set the IP address of the network adapter connected to the development board. For details, see Setting the IP Address of the Network Port for Programming on Hi3516.

7. Set the IP address of the network port for programming:

   • upload_net_server_ip: Select the IP address set in 6, such as 192.168.1.2.
   • upload_net_client_mask: Set the subnet mask of the development board, such as 255.255.255.0. Once the upload_net_server_ip field is set, this field will be automatically populated.
   • upload_net_client_gw: Set the gateway of the development board, such as 192.168.1.1. Once the upload_net_server_ip field is set, this field will be automatically populated.
   • upload_net_client_ip: Set the IP address of the development board, such as 192.168.1.3. Once the upload_net_server_ip field is set, this field will be automatically populated.

   

8. When you finish modifying, click Save in the upper right corner.

9. Open the project file and go to > PROJECT TASKS > hi3516dv300 > Upload to start programming.

   

10. When the following message is displayed, power off the development board and then power it on.

    

11. Start programming. When the following message is displayed, it indicates that the programming is successful.

    

Running an Image

1. Connect to a serial port.

   NOTICE: If the connection fails, rectify the fault by referring to FAQs.

   Figure 2 Serial port connection

   

   1. Click Monitor to enable the serial port.
   2. Press Enter repeatedly until hisilicon displays.
   3. Go to step 2 if the board is started for the first time or the startup parameters need to be modified; go to step 3 otherwise.

2. (Mandatory when the board is started for the first time) Modify the bootcmd and bootargs parameters of U-boot. You need to perform this step only once if the parameters need not to be modified during the operation. The board automatically starts after it is reset.

   NOTICE: The default waiting time in the U-boot is 2s. You can press Enter to interrupt the waiting and run the reset command to restart the system after "hisilicon" is displayed.

   Table 1 Parameters of the U-boot

   Command	Description
   setenv bootcmd "mmc read 0x0 0x80000000 0x800 0x4800; go 0x80000000";	Run this command to read content that has a size of 0x4800 (9 MB) and a start address of 0x800 (1 MB) to the memory address 0x80000000. The file size must be the same as that of the OHOS_Image.bin file in the IDE.
   setenv bootargs "console=ttyAMA0,115200n8 root=emmc fstype=vfat rootaddr=10M rootsize=20M rw";	Run this command to set the output mode to serial port output, baud rate to 115200, data bit to 8, rootfs to be mounted to the emmc component, and file system type to vfat. rootaddr=10 M, rootsize=20 M rw indicates the start address and size of the rootfs.img file to be burnt, respectively. The file size must be the same as that of the rootfs.img file in the IDE.
   saveenv	saveenv means to save the current configuration.
   reset	reset means to reset the board.

   NOTICE: go 0x80000000 (optional) indicates that the command is fixed in the startup parameters by default and the board automatically starts after it is reset. If you want to manually start the board, press Enter in the countdown phase of the U-boot startup to interrupt the automatic startup.

3. Run the reset command and press Enter to restart the board. After the board is restarted, OHOS is displayed when you press Enter.

   Figure 3 System startup

   

Running a Program

In the root directory, run the ./bin/helloworld command to operate the demo program. The compilation result is shown in the following example.

Figure 4 Successful system startup and program execution