From 599208453bd739263d8c2cca4acd05df80bed1c3 Mon Sep 17 00:00:00 2001 From: shawn_he Date: Mon, 22 Aug 2022 11:46:01 +0800 Subject: [PATCH] update doc Signed-off-by: shawn_he --- .../subsys-aiframework-tech-codemanage.md | 12 +++++--- .../subsystems/subsys-boot-init-jobs.md | 28 ++++++++++++++++++ .../subsystems/subsys-boot-init-service.md | 4 +-- en/readme/figures/location_En-1.png | Bin 0 -> 29495 bytes en/readme/location.md | 17 ++++++++--- 5 files changed, 51 insertions(+), 10 deletions(-) create mode 100644 en/readme/figures/location_En-1.png diff --git a/en/device-dev/subsystems/subsys-aiframework-tech-codemanage.md b/en/device-dev/subsystems/subsys-aiframework-tech-codemanage.md index 16602e69ef..e10289c626 100644 --- a/en/device-dev/subsystems/subsys-aiframework-tech-codemanage.md +++ b/en/device-dev/subsystems/subsys-aiframework-tech-codemanage.md @@ -15,15 +15,19 @@ In the overall planning of the AI engine framework, northbound SDKs are a part o - SDK code directory: //foundation/ai/engine/services/client/algorithm\_sdk - e.g. //foundation/ai/engine/services/client/algorithm\_sdk/cv + Examples: + + //foundation/ai/engine/services/client/algorithm\_sdk/cv - e.g. //foundation/ai/engine/services/client/algorithm\_sdk/nlu + //foundation/ai/engine/services/client/algorithm\_sdk/nlu - Plug-in code directory: //foundation/ai/engine/services/server/plugin - e.g. //foundation/ai/engine/services/server/plugin/cv + Examples: - e.g. //foundation/ai/engine/services/server/plugin/nlu + //foundation/ai/engine/services/server/plugin/cv + + //foundation/ai/engine/services/server/plugin/nlu ## Rule: Store all external APIs provided by plug-ins in the **interfaces/kits** directory of the AI subsystem. diff --git a/en/device-dev/subsystems/subsys-boot-init-jobs.md b/en/device-dev/subsystems/subsys-boot-init-jobs.md index 8bbbc1a8c0..31e52aa9bb 100644 --- a/en/device-dev/subsystems/subsys-boot-init-jobs.md +++ b/en/device-dev/subsystems/subsys-boot-init-jobs.md @@ -160,6 +160,20 @@ A job is a command set, where you can manage the commands to be executed. A maxi Small and standard systems + + + write + + + write filename value
Example:
write /data/testfile 0 + + + Writes a file. filename and value respectively indicate the absolute file path and the string to write. + + + Standard system + + stop @@ -300,6 +314,20 @@ A job is a command set, where you can manage the commands to be executed. A maxi Small and standard systems + + + syncexec + + + syncexec Path of the executable file Parameters passed by the executable file
Example:
syncexec /system/bin/udevadm trigger + + + Runs an executable file synchronously. The **wait** function will be called to wait for the child process to end. The command must not contain more than 10 parameters. + + + Standard system + + mknode diff --git a/en/device-dev/subsystems/subsys-boot-init-service.md b/en/device-dev/subsystems/subsys-boot-init-service.md index 38f88f250c..6b686c2dcf 100644 --- a/en/device-dev/subsystems/subsys-boot-init-service.md +++ b/en/device-dev/subsystems/subsys-boot-init-service.md @@ -208,11 +208,11 @@ By parsing the *.cfg file, you can obtain **service** fields, a importance - Current service priority. + Service priority (for the standard system) or service importance (for the mini system). Standard system: The service priority ranges from -20 to 19. A value beyond the range is invalid.
- Small system: The value 0 indicates an unimportant process and a value greater than 0 indicates an important process. + Small system: The value 0 indicates that a system restart is not required, and a value greater than 0 indicates the opposite. Small and standard systems diff --git a/en/readme/figures/location_En-1.png b/en/readme/figures/location_En-1.png new file mode 100644 index 0000000000000000000000000000000000000000..1ae4bcd7173f2e95004c96fa13d420c09f017f76 GIT binary patch literal 29495 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 + +![](figures/location_En-1.png) +![](figures/location_En-1.png) ## Directory Structure @@ -102,7 +106,8 @@ The following table describes APIs available for obtaining device location infor **Obtaining the device location information:** 1. Before using basic location capabilities, check whether your application has been granted the permission to access the device location information. If not, your application needs to obtain the permission from the user. - The system provides the following location permissions: + + The system provides the following location permissions: - ohos.permission.LOCATION - ohos.permission.LOCATION_IN_BACKGROUND @@ -131,7 +136,7 @@ The following table describes APIs available for obtaining device location infor } ``` - For details about the configuration fields, see the description of the **module.json** file. + For details about the configuration fields, see [Application Package Structure Configuration File](../application-dev/quick-start/stage-structure.md). 2. Import the **geolocation** module by which you can implement all APIs related to the basic location capabilities. @@ -204,7 +209,8 @@ The following table describes APIs available for obtaining device location infor ``` 4. Instantiate the **Callback** object for the system to report location results. - Your application needs to implement the callback defined by the system. When the system successfully obtains the real-time location of a device, it will report the location result to your application through the callback interface. Your application can implement the callback interface in such a way to complete your own service logic. + + Your application needs to implement the callback defined by the system. When the system successfully obtains the real-time location of a device, it will report the location result to your application through the callback interface. Your application can implement the callback interface in such a way to complete your own service logic. ``` var locationChange = (location) => { @@ -239,6 +245,7 @@ The following table describes APIs available for obtaining device location infor **Converting the coordinates and geocoding information:** > **NOTE** +> > The **GeoConvert** instance needs to access backend services to obtain information. Therefore, before performing the following steps, ensure that your device is connected to the network. 1. Import the **geolocation** module by which you can implement all APIs related to the geocoding and reverse geocoding conversion capabilities. @@ -248,6 +255,7 @@ The following table describes APIs available for obtaining device location infor ``` 2. Obtain the conversion result. + - Call **getAddressesFromLocation** to convert coordinates into geographical location information. ``` @@ -258,6 +266,7 @@ The following table describes APIs available for obtaining device location infor ``` Your application can obtain the **GeoAddress** list that matches the specified coordinates and then read location information from it. For details, see the *API Reference*. + - Call **getAddressesFromLocationName** to convert geographic description into coordinates. ``` -- GitLab