系统状态
## 系统状态
系统状态包含网关基本信息展示，以及基本控制功能。
### 一、 信息展示
导入头文件`#import <H3CMagicKit/H3CGatewayObject+SystemSet.h`
#### 1.1 获取当前智能带宽状态
获取网关基本信息Lan口、WAN口、版本等基本信息。
```
[H3CGatewayObject getGatewaySystemInfoWithSuccess:^(H3CGatewaySystemInfoModel * _Nonnull result) {
} failure:^(H3CError *error) {
}];
```
#### 1.2 获取网关是否为中继状态
获取网关是否为中继状态。
```
[H3CGatewayObject getNetworkSettingTrunKSatateInfoWithSuccess:^(BOOL isRepeating) {
} failure:^(H3CError *error) {
}];
```
>w 1、中继模式没有WAN口信息；
2、路由能力集能力集第1位`isSupportWan`, 若不支持互联网也没有WAN信息；
3、部分设备支持2个WAN口信息展示，需要能力集24位支持
### 二、 基本控制
导入头文件`#import <H3CMagicKit/H3CGatewayObject+SystemSet.h`
#### 2.1 修改设备名称
修改路由器的名称。
```
[H3CGatewayObject modifyRouterNameWithName:updateName success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
#### 2.2 重启设备
```
[H3CGatewayObject rebootGatewayWithSuccess:^(id obj) {
} failure:^(H3CError *error) {
}];
```
#### 2.3 恢复出厂设置
恢复出厂设置，恢复出厂指令发送成功后，再发送重启指令。
```
[H3CGatewayObject resetGatewayWithSuccess:^(id obj) {
} failure:^(H3CError *error) {
}];
```
#### 2.4 设备更新
* 检查网关是否有新版需要更新。
```
[H3CGatewayObject checkoutGatewayCanUpgrateWithSuccess:^(BOOL needUpgrate) {
} failure:^(H3CError *error) {
}];
```
* 升级网关
```
[H3CGatewayObject upgrateGatewayVersionWithSuccess:^(id obj) {
} failure:^(H3CError *error) {
// 网关繁忙中
if (error.retCode == 71) {
}
}];
```
>w 如果设备是组网状态，子路由也会全部升级至最新版本。
* 获取网关升级进度，需展示升级过程可以轮询该接口。
```
[H3CGatewayObject getGatewayVersionUpgrateStatusWithSuccess:^(NSInteger updateStatus) {
} failure:^(H3CError *error) {
// 网关繁忙
if (error.retCode == 71) {
}
}];
```
字段updateStatus说明：
|参数|描述|
|-|-|
|0|非升级状态 |
|1|正在下载 |
|2|烧写flash|
|3|升级成功|
|4|下载失败|
|5|版本校验错误|
|6|烧写flash失败。|
|7|准备重启|
#### 2.5 修改管理密码
* 获取管理密码是否与Wi-Fi密码一致
```
[H3CGatewayObject getGatewayPasswordSyncFlagWithSuccess:^(NSInteger passwordSyncFlag) {
} failure:^(H3CError *error) {
}];
```
* 修改管理密码:
* 允许修改为与Wi-Fi密码一致；
* 不与Wi-Fi密码一致，需输入旧的密码。
```
[H3CGatewayObject changeGatewayAdminPasswordWithPasswordSyncFlag:passwordSyncFlag oldPassword:oldPassword newPassword:newPassword success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
参数说明：
|参数|描述|
|-|-|
|passwordSyncFlag|设置管理密码与wifi密码一致: 1、不一致 2、一致 |
|oldPassword|旧密码，当passwordSyncFlag为2时传空值。 |
|110|新密码，当passwordSyncFlag为2时传空值。|
#### 2.6 故障信息上传
通知网关上报设备故障信息，有助于网关问题定位。
```
[H3CGatewayObject uploadGatewayFaultInfoWithSuccess:^(id obj) {
} failure:^(H3CError *error) {
}];
```
获取上传故障结果接口，需要展示上传过程可以轮询查询。
```
[H3CGatewayObject getGatewayFaultInfoUploadStatusWithSuccess:^(H3CUpdateFaultLogModel * _Nonnull updateFaultLogModel) {
} failure:^(H3CError *error) {
}];
```
字段说明：
|字段|描述|
|-|-|
|upLoadStatus |1、上传成功 2、上传中 3-9、上传失败 其他、未知 |
>w 接口需要能力集28位支持
### 三、 能力集
| 能力集序号|能力集属性|描述|
|-|-|-|
|1| isSupportWan | 是否支持互联网|
|24| isSupportDoubleWanMode | 是否支持双Wan模式|
|28| isSuportUploadFault | 是否支持故障信息上传|