---
name: "SmartDeviceModel.queryDps"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.14.0" }
---

## SmartDeviceModel.queryDps

> [VERSION] @ray-js/panel-sdk >= 1.14.0

> 💡 queryType parameter description:
> - 3 (default): App auto-adapts; requires App >= 6.9.0 and container >= 3.32.0
> - 0: BLE empty-command query
> - 1: Normal query
> Auto-degrade on lower versions: use empty-command query (0) when a BLE single-point device is online; use normal query (1) for other devices.
> If queryType is specified in the input, that value takes precedence.

### Description

Actively query device DP status (not supported for groups)

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `{ deviceId?: string; dpIds: number[]; queryType?: number; }` | Yes | Query parameters |

### Return Value

Type: `Promise<any>`

Whether the query command was sent successfully; does not indicate whether the query succeeded

### Examples

#### Example

```typescript
const result = await device.queryDps({ dpIds: [1, 2, 3] });
```
