---
name: "sendCmdForRefreshDeviceLQI"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.7.60" }
async: true
title: "sendCmdForRefreshDeviceLQI - 下发更新LQI指令"
---

## sendCmdForRefreshDeviceLQI

> [VERSION] @ray-js/ray >= 1.7.60

> ⚡ **支持 Promise 调用** — 不传 success / fail / complete 回调时，该方法返回 Promise。

### 描述

下发更新 LQI 指令，用于刷新网关子设备的信号质量值

### 参数

| 属性 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `devId` | `string` | 是 | 子设备 ID |

### 返回值

类型: `Promise<boolean>`

是否下发成功

### 示例代码

```typescript
import { gateway } from '@ray-js/ray'

const refreshLQI = async () => {
  try {
    const success = await gateway.sendCmdForRefreshDeviceLQI({
      devId: 'sub_device_001',
    });
    console.log('下发刷新LQI指令:', success);
  } catch (err) {
    console.error('下发失败:', err);
  }
};
```