Huawei

Getting Started

Issue 01
Date 2020-03-27

HUAWEI TECHNOLOGIES CO., LTD.

Copyright © Huawei Technologies Co., Ltd. 2021. All rights reserved.
No part of this document may be reproduced or transmitted in any form or by any means without prior
written consent of Huawei Technologies Co., Ltd.

Trademarks and Permissions

and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective
holders.

Notice
The purchased products, services and features are stipulated by the contract made between Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees
or representations of any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.

Huawei Technologies Co., Ltd.

Address: Huawei Industrial Base
Bantian, Longgang
Shenzhen 518129
People's Republic of China

Website: https://www.huawei.com
Email: [email protected]

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. i

Huawei
Getting Started Contents

Contents

1 Before You Start....................................................................................................................... 1

1.1 User Types.................................................................................................................................................................................. 1
1.2 Preparations.............................................................................................................................................................................. 1

2 Quickly Developing Skills (Developers)............................................................................. 3

3 Developing Skills Using HiLens Studio (Developers)................................................... 11
4 Purchasing and Using Skills Oriented to HiSilicon Hi35xx Series Chips.................. 16
5 Change History...................................................................................................................... 20

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. ii

Huawei
Getting Started 1 Before You Start

1 Before You Start

1.1 User Types

Huawei HiLens users have three roles: common users, AI developers, and camera
manufacturers. Select the corresponding guide based on the actual scenario. Table
1-1 describes the users.

Table 1-1 Huawei HiLens users

User Role Typical User Application Scenario Procedure for
Using HiLens

Developers ● Technical Develop skills with AI For details, see

personnel capabilities and release Quickly
engaged in AI them to the skill market Developing Skills
development to build a sound AI (Developers).
● University developer ecosystem.
students

Manufactu ● Manufacturers ● Camera For details, see

rers of cameras manufacturers: Power Purchasing and
running AI capabilities for Using Skills
HiSilicon mid-/low-end cameras. Oriented to
Hi35xx series HiSilicon Hi35xx
chips Series Chips.

1.2 Preparations
Creating a HUAWEI CLOUD Account
Before using Huawei HiLens, you need to apply for a HUAWEI CLOUD account and
complete real-name authentication. By using this account, you can use HUAWEI
CLOUD services and pay only for the services you use. For details, see Account
Registration Process and Real-Name Authentication.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 1

Huawei
Getting Started 1 Before You Start

Obtaining Permissions of Related Services

Huawei HiLens depends on other services. Therefore, you need to obtain the
permissions of related services before using Huawei HiLens, including ModelArts,
Object Storage Service (OBS), and Software Repository for Container (SWR). For
details about the relationships between Huawei HiLens and other services, see
Related Services.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 2

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

2 Quickly Developing Skills (Developers)

This chapter describes how developers who purchase HiLens Kit devices develop
skills using templates and install the skills to devices. After the installation is
complete, you can view the skill running effect on the Huawei HiLens
management console.
The Safety Helmet Detection Template is used as an example to demonstrate
the entire process from skill development to skill effect viewing. After the skill is
installed, the camera can detect whether workers are wearing safety helmets.
Before you start, carefully complete the preparations described in Preparations.
Figure 2-1 shows the development process.

Figure 2-1 Quick start guide for developers

Preparations
● Register a HUAWEI CLOUD account and perform real-name authentication.
Before using Huawei HiLens, check the account status, which cannot be in
arrears or frozen.
● Purchase a HiLens Kit device and register it with the Huawei HiLens
platform.

Step 1: Develop the Skill

1. Log in to the Huawei HiLens management console, choose Skill
Development > Skill Management in the left navigation pane. The Skill
Management page is displayed.
2. Click Create Skill in the upper right corner. The Create Skill page is
displayed.
a. Enter basic information about the skill. For details about the parameters,
see Table 2-1.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 3

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

Table 2-1 Basic information parameters

Parame Description Suggestion

ter

Skill You can select Create from Click Select Template. In

Templat Scratch or Select Template. the dialog box that is
es If you have saved a skill displayed, select the Safety
template, you can use it to Helmet Detection
quickly develop the skill. If you Template.
select the skill template, its
logic code and model will be
used by default. You can also
edit the skill template.
If no skill template is available
in the system, you can use an
empty template to develop the
skill.

Name Skill name. The name is also It is recommended that the

used to name the root skill name be in the format
directory when the skill is of brand + application
delivered to a device. name.
Enter 3 to 60 characters. Only
Chinese characters, letters,
digits, underscores (_), and
hyphens (-) are allowed. The
name must start with a
Chinese character or letter and
end with a Chinese character,
letter, or digit.
NOTE
The skill market does not allow
duplicate skill names. Therefore, if
you want to release a skill to the
skill market, use a globally unique
name to name your skill.

Version Skill version. For example, 1.0.0.

The format is
number.number.number, for
example, 2.1.3. Each number
ranges from 0 to 999. When it
has two or more digits, it
cannot start with 0.

Chip Chip supported by the skill. For Ascend 310

skills running on HiLens Kit
devices, select the Ascend 310
chip.

Skill Used for skill verification to Use the hash check value
Code prevent fake skills. in the template. You do not
Value need to set this parameter.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 4

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

Parame Description Suggestion

ter

Applicat Application scenario of the You can directly use the

ion skill, such as sub-scenarios of template model and do
Scenari Smart Campus, Smart Home, not need to set this
o Smart In Vehicle Device, and parameter.
Smart Mall and Supermarket,
and Others.

Icon Icon of the skill This parameter is optional.

OS OS where the skill runs, Linux

Platfor including Linux, Android, iOS,
m LiteOS, and Windows.

Descript Detailed description about the Enter the skill output mode
ion skill, based on the template.
You can enter a maximum of ● HDMI: The video data is
2,048 characters. Special output to the display
characters ~^$%& are not through the HDMI port
allowed. of the device.
● RTMP: The video data is
output to a server in
real time for users to
view.
● H264_FILE: The video
data is output as files to
OBS for users to view.

b. Set the skill content. For details about the parameters, see Table 2-2.
NOTE

In this example, an existing template is used to develop the skill. The skill content
uses the model and code of the template by default. You can use the default
information or edit it as required. The parameters vary if you use an empty
template to develop the skill. For details, see the Huawei HiLens User Guide.

Table 2-2 Skill content parameters

Param Description Suggestion
eter

Skill Format of the skill to be You can directly use the template
Format created. Two formats are model and do not need to set
available: Skill package this parameter.
and Container image.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 5

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

Param Description Suggestion

eter

Runtim Runtime language of the You can directly use the template
e logic code. Currently, the model and do not need to set
Langua value can be Python3.7 this parameter.
ge or C/C++. If the C/C++
language is selected for
development, online
code compilation is not
supported. Developers
need to develop and
compile the code offline,
package the code in the
Linux environment, and
upload the package the
OBS.

Functio The startup of a skill uses You can directly use the template
n the code execution file as model and do not need to set
Executi the entry, which is similar this parameter.
on to the main function of
Entry the C language. The
main file must be in the
level-1 directory.
● The main file of a skill
in the Skill package
format must be in the
root directory of the
skill package. For
example, end the file
of a Python skill
with .py.
● For a skill in the
Container image
format, if
ENTTRYPOINT has
been configured for
dockerfile, the
description can be left
blank. Otherwise, you
need to enter the path
to the execution file
within the image.
The file name can
contain a maximum of
1,024 characters,
consisting of letters,
digits, and underscores
(_). Special characters
#~^ are not allowed.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 6

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

Param Description Suggestion

eter

Model Core algorithm of the If you use a template, you do not

skill to be created. The need to set this parameter.
model can be trained
locally or in ModelArts
and then be imported to
Huawei HiLens. Click the
plus sign (+). In the
dialog box that is
displayed, select a model
from the model
management list on the
Huawei HiLens platform.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 7

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

Param Description Suggestion

eter

Code Upload mode of the logic If you use a template, you do not
Entry code. need to set this parameter.
Mode ● Online Compilation
Use the logic code for
developing skills
online to
automatically
generate a .zip
package and upload it
to OBS. Huawei
HiLens automatically
creates an OBS bucket
for storing the skill
package. The bucket is
named in the
<project_id>-hilens-
skill format. You can
go to the OBS
console, find the OBS
bucket with the
corresponding name,
and obtain the code
package file edited
online.
● Upload From OBS
You can develop
complex project code
offline, manually
generate a .zip
or .tar.gz package,
upload it to OBS, and
select the .zip
or .tar.gz package
from OBS here.
● Select Container
Image
For skills in the
container image
format, you can
upload their container
image files to SWR in
advance. For details,
see Uploading an
Image Through the
Docker Client.

c. Configure runtime configurations. The Runtime Configuration is used to

configure the parameters required by the skill for users who use the skill.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 8

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

The configuration parameters provided by the template can be directly

used.
3. After setting and confirming all skill development parameters, click OK on the
right.
The developed skill is stored on the Skill Development > Skill Management
page. You can view the skill status this page.

Step 2: Install the Skill

1. Choose Skill Development > Skill Management, select the developed skill,
and click Install in the Operation column.
2. In the dialog box that is displayed, select the device to which the skill is
installed and click Install. After the installation is successful, click OK.
During the installation, the Huawei HiLens management console delivers the
skill package to the device. It takes some time to deliver the skill package. You
can view the skill installation progress in the progress bar. After the delivery is
complete, the progress bar displays Installation succeeded. See Figure 2-2.

Figure 2-2 Successful installation

Step 3: Start the Skill

If the skill status is Installation succeeded, the skill is successfully installed on the
device. You can start it to view its output data.
1. Use the HDMI video cable to connect the video output port of the Huawei
HiLens device to the display.
2. In the navigation pane, choose Device Management > HiLens Kit. The device
list page is displayed.
3. Click Manage Skill of the registered device. The status of the installed Safety
Helmet Detection skill is Stopped. Click Start in the Operation column and
click OK to start the skill on the device.
The skill status changes to Running after a short period of time, indicating
that the skill is successfully running on the device. Then, you can view the skill
output data on the display.
Table 2-3 describes the skill statuses.

Figure 2-3 Viewing the installed skill

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 9

Huawei
Getting Started 2 Quickly Developing Skills (Developers)

Table 2-3 Skill installation statuses

Status Description

Stopped The skill stops running on the device.

Running The skill is successfully installed on the device and is running.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 10

Huawei 3 Developing Skills Using HiLens Studio
Getting Started (Developers)

3 Developing Skills Using HiLens Studio

(Developers)

This chapter describes how developers who purchase HiLens Kit devices develop
skills using HiLens Studio and install the skills to devices. After the installation is
complete, you can view the skill running effect on the Huawei HiLens
management console.

This chapter uses the Studio_Mask_Detection (C++ version) skill template as an

example to describe the entire process of skill development, installation, and
effect viewing in HiLens Studio. After the skill is installed, cameras with the skill
can detect and recognize faces wearing masks.

Before you start, carefully complete the preparations described in Preparations.

● Step 1: Create a Skill Project

● Step 2: Debug the Code
● Step 3: Install the Skill
● Step 4: Start the Skill
● (Optional) Step 5: Release the Skill

Preparations
● Register a HUAWEI CLOUD account and perform real-name authentication.
Before using Huawei HiLens, check the account status, which cannot be in
arrears or frozen.
● Purchase a HiLens Kit device and register it with the Huawei HiLens
platform.
● Apply for the HiLens Studio OBT permission. For details, see Applying for the
HiLens Studio OBT.

Step 1: Create a Skill Project

1. Log in to the Huawei HiLens management console and choose Skill
Development > HiLens Studio from the left navigation pane.
Wait about 30 seconds. The HiLens Studio page is displayed.
2. On the HiLens Studio page, click New Project.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 11

Huawei 3 Developing Skills Using HiLens Studio
Getting Started (Developers)

The Select Skill Template dialog box is displayed.

3. In the Select Skill Template dialog box, select the Studio_Mask_Detection
skill template card and click OK.
The Create Skill page is displayed. The default configurations of the selected
template are automatically loaded. You can view related information on the
right pane.

Figure 3-1 Skill template

4. Fill in the skill information. In this example, you can directly use the default
parameters. For details about the parameters, see Filling In Basic
Information.
5. Confirm the information and click OK.
The HiLens Studio page is displayed, with the created mask detection skill
project.

Step 2: Debug the Code

1. Open the file directory of the development project on the left of the HiLens
Studio page.
If the file directory is not displayed, click in the upper right corner.
2. Choose src > cpp > main.cpp to open the project source code file and modify
the initialization interface parameter to ensure that its value is the same as
the entered verification value.
In this example, the default verification value hello is used.
int ret = hilens::Init("hello");

3. Open the project source code folder src. In the editing area on the HiLens
Studio page, you can directly edit and add breakpoints to the logic code of
the skill based on your service requirements, and then click the icon on the
left for debugging.
For details about the compilation, cleanup, debugging, and execution
operations, see the readme.txt file.
4. Choose Debug > Start Debugging on the top menu bar of the HiLens Studio
page to execute the code.
After the code is successfully executed, you can view the skill output video in
the Video Output area on the right.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 12

Huawei 3 Developing Skills Using HiLens Studio
Getting Started (Developers)

Figure 3-2 Skill output

Step 3: Install the Skill

1. Power on the HiLens Kit device. For details, see Connecting a HiLens Kit
Device to a PC. Ensure that the network connection is normal.
NOTE

If you use a wireless network, ensure that the router is powered on to ensure network
connectivity.
If you use a wired network, ensure that the device is connected to a router using a
network cable to ensure network connectivity.
2. Log in to the Huawei HiLens management console and choose Skill
Development > HiLens Studio from the left navigation pane to start HiLens
Studio.

3. Click on the right of the HiLens Studio page.

4. In the Skill Installation area on the right, select the device where the skill is
to be installed in the Device Name column and click Install in the Operation
column.
The Install Skill dialog box is displayed.

Figure 3-3 Installing the skill

5. In the displayed Install Skill dialog box, click Yes.

The skill is delivered to the target HiLens Kit device. You can view the progress
bar in the device list. If message Install Successfully is displayed in the lower
right corner, the skill is successfully installed.
In the Skill Installation area on the right of HiLens Studio, you can click on
the left of the target device in the Device Name column to view the skills
installed on the device.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 13

Huawei 3 Developing Skills Using HiLens Studio
Getting Started (Developers)

Step 4: Start the Skill

1. In the Skill Installation area on the right of the HiLens Studio page, select
the device whose skill is to be started in the Device Name column, and click
on the left of the device name to view the skills installed on the device.
If the Skill Installation area is not displayed, click on the right of the
HiLens Studio page.
2. Move the cursor to the Operation column of the Studio_Mask_Detection
skill and click Start.
The Start Skill dialog box is displayed.
3. In the displayed Start Skill dialog box, click Yes.
Starting the skill is displayed in the lower right corner.
The system starts to start the skill. Skill startup involves a command delivery
process, so you need to wait for a period of time before you can view that
Success to start the skill is displayed in the lower right corner and the skill
Status is updated to Running.

Figure 3-4 Starting a skill

(Optional) Step 5: Release the Skill

After developing, debugging, and running the code of a skill in HiLens Studio, you
can release the skill to the skill market of Huawei HiLens. After the skill is
approved by the platform, it can be purchased and used by other users. You can
also release the skill to the AI market of ModelArts and share it with other users.

The following describes how to release a skill to the skill market on the Huawei
HiLens platform.

1. Click on the right of the HiLens Studio page and click Release in the
HiLens Widget area.
The Release Skill dialog box is displayed.
2. In the Release Skill dialog box, set required parameters and click OK.
– Publish: Select HiLens.
– Billing Policy: Billing policy for releasing the skill to the skill market. The
value can be Free or Charged.
– Specifications Limitation: Maximum number of concurrent channels.
Use the default value.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 14

Huawei 3 Developing Skills Using HiLens Studio
Getting Started (Developers)

– Billed By: The default value One-off is selected.

– Privacy Policy: This example involves the first three privacy policies.
Select them.
For details about the parameters, see Releasing a Skill to the Skill
Market.

Figure 3-5 Releasing a skill to the skill market

After the release application is submitted, it will be sent to the Huawei HiLens
background for review. The review will be completed within three working
days.
After the skill is approved, it will be displayed on the Skill Market > Skill
Market page of the Huawei HiLens console.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 15

Huawei 4 Purchasing and Using Skills Oriented to HiSilicon
Getting Started Hi35xx Series Chips

4 Purchasing and Using Skills Oriented to

HiSilicon Hi35xx Series Chips

This chapter describes how manufacturers of camera devices running HiSilicon

Hi35xx series chips manage products, purchase skills, and bind device licenses to
product skills on the Huawei HiLens management console to equip the chips used
by manufacturers with AI capabilities.

This chapter describes how to purchase a skill oriented to HiSilicon Hi35xx series
chips to demonstrate the entire process from product creation to skill use. Free
test skills are available in the skill market for trial use, but we do not guarantee
their commercial precision.

Before you start, carefully complete the preparations described in Preparations.

Figure 4-1 shows the process of managing products.

Figure 4-1 Quick use of skills oriented to Hi35xx chips

Preparations
Register a HUAWEI CLOUD account and perform real-name authentication. Before
using Huawei HiLens, check the account status, which cannot be in arrears or
frozen.

Step 1: Create a Product

1. Log in to the Huawei HiLens management console, choose Device
Management > Product Management in the left navigation pane. The
Product Management page is displayed.
2. Click Create Product in the upper right corner and set product parameters, as
listed in Table 4-1.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 16

Huawei 4 Purchasing and Using Skills Oriented to HiSilicon
Getting Started Hi35xx Series Chips

Table 4-1 Product parameters

Parameter Description

Name Product name.

Enter 3 to 60 characters. The name must start with a
Chinese character or letter and end with a Chinese
character, letter, or digit. Only Chinese characters,
letters, digits, underscores (_), and hyphens (-) are
allowed.

Platform Device OS type.

Android, Linux, iOS, LiteOS, and Windows are supported.

Chip Device chip model.

HiSilicon Hi35xx series chips, including 3516CV500 and
3519AV100

Description Product description.

Enter 1 to 512 characters. Special characters #~^$%
\'&*<>(){}[]\\/ are not allowed.

3. Confirm the product information and click OK. After the product is created,
the Product Management page is automatically displayed.
4. Select the new product and click Download License in the Operation column
to download the license file.
5. The license contains the identity information of the product, which is used for
registration verification with the skill SDK.

Step 2: Purchase a Skill

You can purchase required skills from the skill market of the Huawei HiLens
platform based on your service requirements to develop devices running HiSilicon
Hi35xx series chips. The skills can be used for Hi3516EV200, Hi3516CV500,
Hi3519AV100, Hi3519V101, Hi3516DV300, and Arm chips. For details about how
to purchase skills, see Purchasing Skills. If the skill market does not have the
skills you need, you can submit your request to Huawei HiLens for customizing
skills. For details, see Customizing Skills.

This example describes how to purchase the free Human Figure and Vehicle
Detection skill, which is used to develop devices running HiSilicon Hi35xx series
chips.

1. Log in to the Huawei HiLens management console, choose Skill Market >
Skill Market in the left navigation pane to enter the corresponding page.
2. Search for the Human Figure and Vehicle Detection skill in the search box
and click the skill card to enter the skill details page.
3. Click Buy Now. The page for purchasing skills is displayed.
4. Specify parameter Copies. You can retain its default value. The Specifications
is default to Channel(s), indicating that a license can be installed on one
device to use one channel of video.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 17

Huawei 4 Purchasing and Using Skills Oriented to HiSilicon
Getting Started Hi35xx Series Chips

Figure 4-2 Purchasing the skill

5. Confirm the fee and click Buy Now.

After the purchase is successful, you can click Purchased to go to the Skill
Market > My Orders page and distribute the skill.

Figure 4-3 Successful purchase

6. After the purchase is successful, the skill is stored on the Skill Market > My
Skills page.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 18

Huawei 4 Purchasing and Using Skills Oriented to HiSilicon
Getting Started Hi35xx Series Chips

Step 3: Use the Skill

Skills oriented to HiSilicon Hi35xx series chips can be used only after being
distributed to device groups. For devices that run HiSilicon Hi35xx series chips, a
maximum of five skills can be distributed to a device group due to performance
restrictions.
1. Log in to the Huawei HiLens management console. In the navigation pane,
choose Skill Market > My Skills. The My Orders tab page is displayed by
default.
2. Select the skill oriented to HiSilicon Hi35xx series chips and distribute the skill
license to a product group.
a. Select the skill to be distributed and click Distribute in the Operation
column.
b. In the Distribute to Product dialog box, select the product group to
which the license is to be distributed, and click the Distribute to Product
button.
If you select Yes under Automatic Upgrade, the skill in the product will
be automatically upgraded to the latest version if a new skill version is
available. This function is not available yet and will be provided.
c. The skill distribution information is displayed in the dialog box. Confirm
that the Installation Status is Successful and click OK.
3. On the My Orders tab page, select the skill to be used and click Download in
the Operation column. The browser automatically downloads the SDK
package of the skill.
4. Install the skill. Integrate the downloaded SDK package to the device.
The device location where the skill is integrated varies according to the device.
For details, see the description document in the SDK or submit a service
ticket.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 19

Huawei
Getting Started 5 Change History

5 Change History

Release Date Description

2020-07-22 Added:
Developing Skills Using HiLens Studio (Developers)

2020-04-21 Optimized the usage processes and descriptions of

common users and manufacturers.
Purchasing and Using Skills Oriented to HiSilicon Hi35xx
Series Chips

2019-10-16 ● Optimized the usage processes and descriptions of

common users and developers.
Quickly Developing Skills (Developers)
● Released the quick start for manufacturers.

2019-09-15 ● Optimized the usage processes and descriptions of

common users and developers.
Quickly Developing Skills (Developers)
● Deleted the quick start for manufacturers because the
firmware management function is no longer available.

2019-05-16 Added:
● Quick start guide for common users
● Quick start guide for manufacturers

2019-01-30 The issue is the first official release.

Issue 01 (2020-03-27) Copyright © Huawei Technologies Co., Ltd. 20