# @adeunis/codecs 中文文档

规范地址：https://npmcn.com/package/%40adeunis/codecs/

版本：1\.7\.1
npm 元数据更新时间：2024-03-15T10:21:51.610Z
中文译文更新时间：2026-11-06T22:48:56.950Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adeunis/codecs
原文对照：https://npmcn.com/package/%40adeunis/codecs/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.9 MB，453 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2019-11-29T13:04:50.139Z
- 最新版本发布：2024-03-15T10:21:51.125Z
- 近 30 天下载量：2206（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 0 个）

## 中文简介

数据源

## 安装

```sh
npm install @adeunis/codecs
```

也可以使用：`pnpm add @adeunis/codecs`、`yarn add @adeunis/codecs`、`bun add @adeunis/codecs`

## README

# 音译器

JavaScript/Node.js Adeunis代码库来解码/encode Adeunis产品数据帧.

## 安装

```
npm i @adeunis/codecs
npm i --save-dev @types/node
```

## 基本用途

```
const codec = require('@adeunis/codecs');

// All product types are defined in DecoderProducts enum (src/shared/product.enum.ts)
const productType = 'analog';
const payloadValue = '42500110000002100000';
let payloadResult;

console.log(`Decoding ${productType} frame => ${payloadValue}`);

const decoder = new codec.Decoder();

// Configure the decoder for the appropriate device 
decoder.setDeviceType(productType);

// Decode the given payload
let parserResult = decoder.decode(payloadValue);

// Incompatible frame and product
if (parserResult.error) {
    payloadResult = 'decoding issue';
} else {
    // Display result
    payloadResult = JSON.stringify(parserResult, null, 2);
}

console.log(payloadResult);
```

## 国 际

**Windows、Linux和MacOS的可执行文件可以从中构建 [来源](https://www.download.codec-adeunis.com/adeunis-codecs-src-1.7.1.tgz) 使用根文件夹中的以下命令:**

-   `npm run start`

**其中一个:**

-   `npm run pack:exe`
-   `npm run pack:linux`
-   `npm run pack:mac`

节点使用: `node bin/codec.js <command> [<args> ...] [-- <options>]` 可执行文件的使用 : `codec <command> [<args> ...] [-- <options>]`

可用命令 :

-   **解码**: 解码框架
-   **编码**: 编码框架
-   **帮助**: 显示帮助

可用的选项 :

-   **\-v, --version (英语)**: 打印版本
-   **.**: 命令特定选项

### 解码器

用法 : `codec decode <frame1> [<frame2> ...] [--deviceType <device_type>] [--network lora868|sigfox] [--csv] [--json]`

### 编码器

用法 : `codec encode <device_type> <frame_code> [--network lora868|sigfox] [-- <encode_options>]`

## 演示(HTML页)

基本演示页面可用于 `generic\src\demo\` 目录

你也可以参观 [演示网页](https://codec-adeunis.com/)

## 产品/编码类型关联表

| 产品 | 参考文献 | APP FW 版本 | Min 代码 lib | 要选择的编码类型 |
| --- | --- | --- | --- | --- |
| 模拟 / 模拟 PWR | 8180BA, 8181BA, ARF8201AA, ARF8200 AA 对 | 1.3.x (单位:千美元) | 1.3.0 (单位:千美元) | `analog` |
| 类似2 / 类似2 PWR | 8180BA, 8181BA, ARF8201AA, ARF8200 AA 对 | 2.1.x (韩语) | 1.7.1 联合国 | `analog2` |
| 呼吸 | 8377AA, 8377CA | 2.4.x (中文(简体) ) | 1.6.0 (简体中文) | `breath` |
| 舒适 | 8275AA、8275CA | < 2.1.0 | 0.4.2 (中文(简体) ) | `comfort` |
| 舒适2号 | 8275AA、8275CA | \>= 2.1.x | 1.4.0 (中文(简体) ) | `comfort2` |
| 舒适的二氧化碳 | 8373AA, 8373CA | 2.2.x (中文(简体) ) | 1.5.0 (中文(简体) ) | `comfortCo2` |
| 舒适安乐 | 8373 \[A/B/C/D/I/J/K/L\]R\] (中文(简体) ) | 1.1.x (单位:千美元) | 1.7.1 联合国 | `comfortSerenity` |
| 干联系人 | 8170BA, 8171BA (英语) | 1.3.x (单位:千美元) | 0.4.2 (中文(简体) ) | `dc` 或者说 `drycontacts` (自 1.4.0 立额起) |
| 干接触器 2 | 8170BA, 8171BA (英语) | 2.1.x (韩语) | 1.4.0 (中文(简体) ) | `drycontacts2` |
| 三角洲方案 | 8283AA、8283CA | 1.5.x或 2.0.x (中文(简体) ) | 1.0.0 (单位:千美元) | `deltap` |
| 调制解调器 | 8240AA、8240BA、8240CA | 2.x.x (中文(简体) ) | 1.7.1 联合国 | `modbus` |
| 动议 | 8276AA、8276CA | 1.5.x (中文(简体) ) | 1.0.0 (单位:千美元) | `motion` |
| 动议2 | 8276AA、8276CA | 2.0.x (中文(简体) ) | 1.2.0 (中文(简体) ) | `motion` |
| 脉冲/脉冲ATEX | 8230AA、8230CA、8230GA、8230GA 汉字 | 1.2.x (单位:千美元) | 0.4.2 (中文(简体) ) | `pulse` |
| 脉冲 3/脉冲 3 ATEX | 8230AA、8230CA、8230GA、8230GA 汉字 | 2.0.x (中文(简体) ) | 1.1.0 国家 | `pulse3` |
| 脉冲4/脉冲4 ATEX | 8230AA、8230CA、8230GA、8230GA 汉字 | 2.1.x (韩语) | 1.4.0 (中文(简体) ) | `pulse4` |
| 脉冲 4 NB-IOT | 第8335号 AA 对 | 2.0.x (中文(简体) ) | 0.4.2 (中文(简体) ) | `pulse4nbiot` |
| 中继器 Sigfox | 第8168号 AA 对 | 2.x.x (中文(简体) ) | 0.4.2 (中文(简体) ) | `repeater` |
| 时间/时间 2S | 8180BA, 8181BA, 8180BA2, 8181BA2 (英语) | 1.3.x (单位:千美元) | 0.4.2 (中文(简体) ) | `temp` |
| 时间 3/时间 2S 3 | 8180BA, 8181BA 8180BA2, 8181BA2 (英语) | 2.0.x (中文(简体) ) | 1.1.0 国家 | `temp3` |
| 时间 4 / 时间 2S 4 | 8180BA, 8181BA, 8180BA2, 8181BA2 (英语) | 2.1.x (韩语) | 1.4.0 (中文(简体) ) | `temp4` |
| Temp 4 / Temp 2S 4 IP68 | 8180BCA、8181BCA、8180BCB、8181BCB | 2.1.x (韩语) | 1.4.0 (中文(简体) ) | `temp4` |
| 东京CBE/林肯 | 8250 (中文(简体) ). AA 对 | 1.4.x (中文(简体) ) | 1.3.0 (单位:千美元) | `ticCbeLinkyMono` |
| CBE/链接TRI | 8250 (中文(简体) ). AA 对 | 1.4.x (中文(简体) ) | 1.3.0 (单位:千美元) | `ticCbeLinkyTri` |
| 东京PME-PMI | 8250 (中文(简体) ). AA 对 | 1.4.x (中文(简体) ) | 1.4.0 (中文(简体) ) | `ticPmePmi` |

请注意:

-   RTU 固件版本对编码器没有影响 `type` 选择
-   套装使用相同的 `type` 超过标准产品

## 常见问题

### @adeunis/codecs 是什么？

数据源

### 如何安装 @adeunis/codecs？

在项目目录运行 npm install @adeunis/codecs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 codec，可以用 npx codec 直接运行。

### @adeunis/codecs 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adeunis/codecs 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @adeunis/codecs 可以商用吗？

@adeunis/codecs 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adeunis/codecs 的下载量有多少？

根据 npm 官方下载统计，@adeunis/codecs 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,206 次，日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adeunis/codecs 还在维护吗？

最新版本 1\.7\.1 发布于 2024/03/15（2 年前）；至今共发布 10 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/11/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。