• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# cem工具
2
3Common Event Manager(公共事件管理工具, 简称cem)是实现公共事件信息打印、发布公共事件等功能的工具,为开发者提供基本的公共事件调试和测试能力,例如打印所有公共事件订阅者、已发送公共事件和接受者、模拟发布公共事件等。
4
5> **说明:**
6>
7> 在使用本工具前,开发者需要先获取<!--Del-->[<!--DelEnd-->hdc工具<!--Del-->](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)<!--DelEnd-->,执行hdc shell。
8
9## cem调试助手
10
11### help
12
13* 介绍
14
15  打印帮助信息。
16
17* 用法
18
19  ```
20  cem help
21  ```
22
23### publish
24
25* 介绍
26
27  发布公共事件。
28
29* 用法
30
31  ```
32  cem publish [<options>]
33  ```
34
35  参数如下表所示
36
37  | 参数         | 参数说明                                   |
38  | ------------ | ------------------------------------------ |
39  | -e/--event   | 必选参数,发布事件名称                     |
40  | -o/--ordered | 可选参数,发布有序事件,默认发布无序事件   |
41  | -c/--code    | 可选参数,公共事件结果码                   |
42  | -d/--data    | 可选参数,公共事件携带数据                 |
43  | -h/--help    | 帮助信息                                   |
44
45* 示例:
46
47  ```bash
48  # 发布名称为testevent的公共事件
49  cem publish --event "testevent"
50  ```
51
52  ![cem-publish-event](figures/cem-publish-event.png)
53
54  ```bash
55  # 发布名称为testevent的有序公共事件,该事件的结果码为100,携带数据内容为“this is data”
56  cem publish -e "testevent" -o -c 100 -d "this is data"
57  ```
58
59  ![cem-publish-all](figures/cem-publish-all.png)
60
61### dump
62
63> **说明:**
64>
65> 当前工具区分eng与user版本。dump命令仅支持在eng版本中使用,在user版本中使用会出现报错error: user version cannot use dump。
66
67* 介绍
68
69  打印公共事件相关信息。
70
71* 用法
72
73  ```
74  cem dump [<options>]
75  ```
76
77  参数如下表所示
78
79  | 参数       | 参数说明                                     |
80  | ---------- | -------------------------------------------- |
81  | -a/--all   | 打印开机以来所有已发送的公共事件及其具体信息 |
82  | -e/--event | 查询特定名称事件的具体信息                   |
83  | -h/--help  | 帮助信息                                     |
84
85* 示例
86
87  ```bash
88  # 打印公共事件名称为testevent的具体信息
89  cem dump -e "testevent"
90  ```
91
92  ![cem-dump-e](figures/cem-dump-e.png)
93