AI 助理
备案控制台
开发者社区 物联网 行业解决方案 文章 正文

JavaScript轻应用硬件模块介绍

2021-08-06 259
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 为了便于开发者使用底层硬件的功能，轻应用里以JSAPI的形式对底层硬件接口做了封装。主要包含uart、gpio、adc、dac、pwm、i2c、spi、timer、rtc、watch dog等。
来源 | HaaS技术社区

1、前言

关于JavaScript轻应用的文档请参考：轻应用总览

为了便于开发者使用底层硬件的功能，轻应用里以JSAPI的形式对底层硬件接口做了封装。主要包含uart、gpio、adc、dac、pwm、i2c、spi、timer、rtc、watch dog等。

2、UART - 串口

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "serial1":{
  4. "type": "UART",
  5. "port": 2,
  6. "dataWidth": 8,
  7. "baudRate": 115200,
  8. "stopBits": 0,
  9. "flowControl": "disable",
  10. "parity": "none"
  11. }
  12. },
  13. "debugLevel": "DEBUG"
  14. }

业务脚本

  1. var uart = require( 'uart');
  3. var msgbuf = 'this is amp uart test'
  4. // uart open
  5. var serial = uart.open({
  6. id: 'serial1'
  7. });
  9. // uart write
  10. serial.write(msgbuf);
  12. // uart read
  13. var value = serial.read();
  15. console.log( 'sensor value is ' + value);
  17. // uart data event
  18. serial.on( 'data', function(data) {
  19. console.log( 'uart receive data is ' + data);
  20. });
  22. // uart close
  23. serial.close();

open(Object options)

打开串口，创建 UART 实例。

入参

Object类型，属性如下：

属性

类型

必填

描述

id

String

是

在app.json中定义的UART id名称

返回

  • UART 串口实例，为空代表创建失败。

UART 实例

事件：'data'

当串口接收到新数据时，会触发

'data'
事件，
'data'
事件回调函数参数：

参数

类型

必填

描述

data

ArrayBuffer

是

串口接收到的数据

UART.write(String|ArrayBuffer data)

发送串口数据，该函数为阻塞函数，串口发送完成后才会返回。

入参

参数

类型

必填

描述

data

String或ArrayBuffer

是

需要发送到串口的数据

UART.read(Number bytes)

主动读取指定bytes的串口数据。

入参

参数

类型

必填

描述

bytes

Number

是

需要读取的字节个数

返回值

  • 读取到的串口数据，ArrayBuffer类型，如果没有数据，则返回空数组。

UART.close()

关闭串口实例。

UART.on(String event, Function cb)

监听串口事件。

3、GPIO

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "led": {
  4. "type": "GPIO",
  5. "port": 23,
  6. "dir": "output",
  7. "pull": "pullup"
  8. },
  9. "key": {
  10. "type": "GPIO",
  11. "port": 25,
  12. "dir": "input",
  13. "pull": "pullup",
  14. "intMode": "rising"
  15. }
  16. },
  17. "debugLevel": "DEBUG"
  18. }

业务脚本

  1. var gpio = require('gpio');
  3. // led
  4. var led = gpio.open({
  5. id: 'led'
  6. });
  8. // set led gpio level
  9. led.writeValue(1);
  10. led.readValue();
  11. led.writeValue(0);
  12. led.readValue();
  14. // led toggle
  15. led.toggle();
  17. // key
  18. var key = gpio.open({
  19. id: 'key'
  20. });
  22. //key trigger callback
  23. key.onIRQ({
  24. trigger: 'rising',
  25. cb: function() {
  26. console.log('key pressed\n');
  27. }
  28. });
  30. // release led&key
  31. led.close();
  32. key.close();

open(Object options)

打开GPIO接口，创建 GPIO 实例。

入参

Object类型，属性如下：

属性

类型

必填

描述

id

String

是

在app.json中定义的GPIO id名称

返回

GPIO 实例

GPIO.writeValue(Number level)

设置GPIO电平值，GPIO引脚为输出模式时可用。

入参

属性

类型

必填

描述

level

Number

是

电平值，1（高电平） 或者 0（低电平）

GPIO.toggle()

切换GPIO的电平，当前GPIO电平为低电平时设置为高电平，当前GPIO电平为高电平时设置为低电平。

GPIO.onIRQ(Function cb)

开启引脚中断触发，引脚为输入模式时可用。

入参

属性

类型

必填

描述

cb

Function

否

引脚中断触发回调函数

GPIO.readValue()

读取GPIO电平值，输入模式和输出模式时均可用。

返回值

  • Number类型，电平值，1（高电平） 或者 0（低电平）。

GPIO.close()

关闭GPIO实例。

4、ADC

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "battery": {
  4. "type": "ADC",
  5. "port": 1,
  6. "sampling": 12000000
  7. }
  8. },
  9. "debugLevel": "DEBUG"
  10. }

业务脚本

  1. var adc = require('adc');
  3. // voltage
  4. var vol = adc.open({
  5. id: 'battery'
  6. });
  8. // read voltage
  9. var value = vol.readValue();
  11. console.log('voltage value is ' + value);
  13. vol.close();

open(Object options)

打开ADC，创建 ADC 实例。

入参

属性

类型

必填

描述

id

String

是

在app.json中定义的ADC id名称。

返回

  • ADC 实例。

ADC 实例

ADC.readValue()

读取ADC数据。

返回值

  • Number类型，读取到的ADC数据。

ADC.close()

关闭ADC实例。

5、DAC

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "voltage": {
  4. "type": "DAC",
  5. "port": 1
  6. }
  7. },
  8. "debugLevel": "DEBUG"
  9. }

业务脚本

  1. var dac = require('dac');
  3. // led
  4. var voltage = dac.open({
  5. id: 'voltage'
  6. });
  8. voltage.writeValue(65536 / 2);
  10. var value = voltage.readValue();
  12. console.log('voltage value is ' + value);
  14. voltage.close();

open(Object options)

打开DAC，创建 DAC 实例，默认启动DAC电压输出。

入参

Object类型，属性如下：

属性

类型

必填

描述

id

String

是

在app.json中定义的DAC id名称。

返回

  • DAC 实例。

DAC 实例

DAC.readValue()

读取DAC输出值。

返回值

  • Number类型，DAC输出值。

DAC.writeValue(Number value)

设置DAC输出值。

入参

属性

类型

必填

描述

value

Number

是

需要设置的DAC值

DAC.close()

关闭DAC实例。关闭DAC实例后，也会停止DAC电压输出。

6、PWM

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明。

  1. {
  2. "io": {
  3. "motor":{
  4. "type":"PWM",
  5. "port":4
  6. }
  7. },
  8. "debugLevel": "DEBUG"
  9. }

业务脚本

  1. var pwm = require('pwm');
  3. // motor start
  4. var motor = pwm.open({
  5. id: 'motor'
  6. });
  8. // get motor option
  9. var freq = motor.get().freq;
  10. var duty = motor.get().duty;
  12. console.log('pwm config freq is ' + freq + ' duty is ' + duty);
  14. // set motor option
  15. motor.set(0.5, 500000);
  17. // motor stop
  18. motor.close();

open(Object options)

打开PWM，创建 PWM 实例。

入参

属性

类型

必填

描述

id

String

是

在app.json中定义的PWM id名称。

返回

  • PWM 实例。

PWM 实例

PWM.set(Number duty, Number freq)

设置PWM参数，同时会启动PWM输出。

入参

属性

类型

描述

duty

Number

设置PWM占空比，范围在0~100，单位是百分比

freq

Number

设置PWM的频率，单位是HZ

PWM.get()

获取PWM参数。

返回值

Object类型，详细的属性为：

属性

类型

描述

duty

Number

PWM占空比。

freq

Number

PWM的频率。

PWM.close()

关闭PWM实例，同时也会停止PWM输出。

7、I2C

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "i2c1":{
  4. "type":"I2C",
  5. "port":0,
  6. "mode":"slave",
  7. "addrWidth":7,
  8. "devAddr":27,
  9. "freq":400000
  10. }
  11. },
  12. "debugLevel": "DEBUG"
  13. }

业务脚本

  1. var i2c = require('i2c');
  3. var memaddr = 0x18;
  4. var msgbuf = [0x10, 0xee];
  5. // sensor
  6. var sensor = i2c.open({
  7. id: 'i2c1'
  8. });
  10. // sensor write
  11. sensor.write(msgbuf);
  12. var value = sensor.read(2);
  14. console.log('sensor value is ' + value);
  16. // sensor write to memory address
  17. sensor.writeMem(memaddr, msgbuf);
  19. // sensor read from memory address
  20. var vol = sensor.readMem(memaddr, 2);
  21. console.log('sensor read mem vol is ' + vol);
  23. sensor.close();

open(Object options)

打开I2C，创建 I2C 实例。

入参

属性

类型

必填

描述

id

String

是

指定要打开的I2C端口。

返回

  • I2C 实例。

I2C 实例

I2C.write(String|ArrayBuffer data)

发送数据，该函数为阻塞函数，I2C发送完成后才会返回。

入参

属性

类型

必填

描述

data

String或ArrayBuffer

是

要发送的数据

I2C.writeMem(ArrayBuffer memaddr, String|ArrayBuffer data)

向寄存器地址

memaddr
发送数据，该函数为阻塞函数，I2C发送完成后才会返回。

入参

属性

类型

必填

描述

memaddr

Number

是

寄存器地址memaddr

data

String或ArrayBuffer

是

要发送的数据

I2C.read(Number bytes)

主动读取指定

bytes
的I2C数据。该函数为阻塞函数，会一直等待读取指定
bytes
的数据。

入参

属性

类型

必填

描述

bytes

Number

是

需要读取的字节个数

返回值

  • ArrayBuffer类型，读取到的I2C数据。

I2C.readMem(String|ArrayBuffer memaddr, Number bytes)

主动向寄存器地址

memaddr
读取指定
bytes
的I2C数据。该函数为阻塞函数，会一直等待读取指定
bytes
的数据。

入参

属性

类型

必填

描述

memaddr

Number

是

寄存器地址memaddr

bytes

Number

是

需要读取的字节个数

返回值

  • 读取到的I2C数据，ArrayBuffer类型。

I2C.close()

关闭I2C实例。

8、SPI

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "sensor1":{
  4. "type":"SPI",
  5. "port":1,
  6. "mode":"slave",
  7. "freq":3250000
  8. }
  9. },
  10. "debugLevel": "DEBUG"
  11. }

业务脚本

  1. var spi = require('spi');
  3. var msgbuf = [0x10, 0xee];
  4. // spi sensor
  5. var sensor = spi.open({
  6. id: 'sensor1'
  7. });
  9. sensor.write(msgbuf);
  10. var value = sensor.read(2);
  12. console.log('sensor value is ' + value);
  14. sensor.close();

open(Object options)

打开SPI，创建 SPI 实例。

入参

属性

类型

必填

描述

id

String

是

指定要打开的SPI端口

返回

  • SPI 实例。

SPI 实例

SPI.write(String|ArrayBuffer data)

通过SPI发送数据，该函数为阻塞函数，SPI发送完成后才会返回。

入参

属性

类型

必填

描述

data

String | ArrayBuffer

是

需要发送的数据

SPI.read(Number bytes)

读取指定bytes的SPI数据，该函数为阻塞函数，读取到指定bytes的数据后才会返回。

入参

属性

类型

必填

描述

bytes

Number

是

指定需要读取的字节个数

返回值

  • ArrayBuffer类型，读取到的SPI数据。

SPI.close()

关闭SPI实例。

9、timer

示例代码

板级配置

板级详细配置说明见：app.json - 全局配置文件说明

  1. {
  2. "io": {
  3. "timer1": {
  4. "type": "TIMER",
  5. "port": 1
  6. }
  7. },
  8. "debugLevel": "DEBUG"
  9. }

业务脚本

  1. var timer = require('timer');
  3. var timer1 = timer.open({
  4. id: 'timer1'
  5. });
  7. // set timer1 timeout
  8. timer1.setTimeout(function() {
  9. console.log('timer1 timeout');
  10. }, 1000);
  12. // timer1.clearTimeout();
  14. // set timer1 interval
  15. timer1.setInterval(function() {
  16. console.log('timer1 interval');
  17. }, 1000);
  19. // timer1.clearInterval();
  21. timer1.close();

open(Object options)

打开硬件TIMER，创建 TIMER 实例。

入参

Object类型，属性如下：

属性

类型

必填

描述

id

String

是

在app.json中定义的TIMER id名称

返回

TIMER 实例

硬件TIMER可以设置成超时（setTimeout()）和周期（setInterval()）2种状态，但是同一时刻只能有一个状态。

TIMER.setTimeout(Function cb, Number timeout)

在指定的毫秒数后调用回调函数。

入参

属性

类型

必填

描述

cb

Function

是

定时器超时回调函数

timeout

Number

是

设置timer的定时时间

TIMER.clearTimeout()

停止执行

setTimeout()
。

TIMER.setInterval(Function cb, Number time)

按照指定的周期（以毫秒计）来调用回调函数。

入参

参数option为Object类型，详细的属性为：

属性

类型

必填

描述

cb

Function

是

定时器周期回调函数

time

Number

是

设置timer的周期时间

TIMER.clearInterval()

停止执行

setInterval()
。

TIMER.close()

关闭TIMER实例。

10、RTC

示例代码

  1. var rtc = require('rtc');
  3. // start rtc
  4. rtc.start();
  6. // set rtc time
  7. rtc.setTime(new Date());
  9. // get rtc time
  10. var current_time = rtc.getTime();
  11. console.log('current time is ' + current_time);
  13. rtc.close();

方法

rtc.start()

启动RTC。

rtc.setTime(Date time)

设置RTC时间。

入参

  • 需要设置的时间，Date 类型。

rtc.getTime()

获取RTC当前时间。

返回值

  • 返回当前的RTC时间，Date 类型。

rtc.close()

关闭RTC。

11、watchdog

示例代码

业务脚本

  1. var wdg = require('wdg');
  3. //start wdg
  4. wdg.start(2000);
  6. // feed wdg
  7. wdg.feed();
  9. // stop wdg
  10. wdg.stop();

方法

wdg.feed()

喂狗。

wdg.stop()

停止WDG定时器。

wdg.start(Number timeout)

启动WDG定时器。如果timeout之后没有进行喂狗操作，会导致系统重启。

入参

参数

类型

是否必须

说明

timeout

Number

是

WDG超时时间，单位毫秒

如需更多技术支持，可加入钉钉开发者群，或者关注微信公众号

更多技术与解决方案介绍，请访问阿里云AIoT首页https://iot.aliyun.com/

文章标签：
JavaScript
前端开发
传感器
开发者
关键词：
JavaScript应用
JavaScript模块
JavaScript轻应用
JavaScript轻应用模块
JavaScript应用模块
开发者小助理
目录
相关文章
那年春天
|
24天前
|
监控 JavaScript 算法
如何使用内存监控工具来定位和解决Node.js应用中的性能问题？
总之，利用内存监控工具结合代码分析和业务理解，能够逐步定位和解决 Node.js 应用中的性能问题，提高应用的运行效率和稳定性。需要耐心和细致地进行排查和优化，不断提升应用的性能表现。
那年春天
174 77
那年春天
|
22天前
|
存储 缓存 监控
如何使用内存监控工具来优化 Node.js 应用的性能
需要注意的是，不同的内存监控工具可能具有不同的功能和特点，在使用时需要根据具体工具的要求和操作指南进行正确使用和分析。
那年春天
65 31
游客moiomvrp3vyac2
|
23天前
|
JavaScript 前端开发 API
深入理解Node.js事件循环及其在后端开发中的应用
本文旨在揭示Node.js的核心特性之一——事件循环，并探讨其对后端开发实践的深远影响。通过剖析事件循环的工作原理和关键组件，我们不仅能够更好地理解Node.js的非阻塞I/O模型，还能学会如何优化我们的后端应用以提高性能和响应能力。文章将结合实例分析事件循环在处理大量并发请求时的优势，以及如何避免常见的编程陷阱，从而为读者提供从理论到实践的全面指导。
游客moiomvrp3vyac2
26 4
那年春天
|
22天前
|
JavaScript
如何使用内存快照分析工具来分析Node.js应用的内存问题？
需要注意的是，不同的内存快照分析工具可能具有不同的功能和操作方式，在使用时需要根据具体工具的说明和特点进行灵活运用。
那年春天
39 3
众所周知
|
26天前
|
JavaScript 前端开发 安全
JavaScript与TypeScript的对比，分析了两者的特性及在实际项目中的应用选择
本文深入探讨了JavaScript与TypeScript的对比，分析了两者的特性及在实际项目中的应用选择。JavaScript以其灵活性和广泛的生态支持著称，而TypeScript通过引入静态类型系统，提高了代码的可靠性和可维护性，特别适合大型项目。文章还讨论了结合使用两种语言的优势，以及如何根据项目需求和技术背景做出最佳选择。
众所周知
44 4
东方睿赢
|
26天前
|
机器学习/深度学习 人工智能 JavaScript
JavaScript和TypeScript的未来发展趋势及其在Web开发中的应用前景
本文探讨了JavaScript和TypeScript的未来发展趋势及其在Web开发中的应用前景。JavaScript将注重性能优化、跨平台开发、AI融合及WebAssembly整合；TypeScript则强调与框架整合、强类型检查、前端工程化及WebAssembly的深度结合。两者结合发展，特别是在Vue 3.0中完全采用TypeScript编写，预示着未来的Web开发将更加高效、可靠。
东方睿赢
40 4
白雾茫茫丶
|
24天前
|
前端开发 JavaScript 关系型数据库
基于 Vue2.0 + Nest.js 全栈开发的后台应用
Vue2 Admin 是一个基于 Vue2 和 Ant Design Pro 开发的前端项目，配合 Nest.js 构建的后端，提供了一个完整的全栈后台应用解决方案。该项目支持动态国际化、用户权限管理、操作日志记录等功能，适合全栈开发者学习参考。线上预览地址：https://vue2.baiwumm.com/，用户名：Admin，密码：abc123456。
白雾茫茫丶
30 1
土木林森
|
26天前
|
设计模式 前端开发 JavaScript
JavaScript设计模式及其在实战中的应用，涵盖单例、工厂、观察者、装饰器和策略模式
本文深入探讨了JavaScript设计模式及其在实战中的应用，涵盖单例、工厂、观察者、装饰器和策略模式，结合电商网站案例，展示了设计模式如何提升代码的可维护性、扩展性和可读性，强调了其在前端开发中的重要性。
土木林森
29 2
程序员成长之路
|
25天前
|
JavaScript 前端开发 API
Vue.js 3：深入探索组合式API的实践与应用
Vue.js 3：深入探索组合式API的实践与应用
程序员成长之路
36 0
一缕微风绕指柔
|
25天前
|
Web App开发 JSON JavaScript
Node.js 中的中间件机制与 Express 应用
Node.js 中的中间件机制与 Express 应用
一缕微风绕指柔
31 0
物联网

行业解决方案

热门文章

最新文章

  • 1
    带你了解热门IoT开源项目：home assistant
  • 2
    网页VUE纯前端在线预览编辑Office，支持doc/docx、xls/xlsx、ppt/pptx、pdf等格式
  • 3
    物联卡：物联网卡和SIM卡的不同
  • 4
    物联网卡锁卡是一个常见的问题，处理这类问题时，可以根据锁卡的具体原因采取相应的解决措施。以下是一些常见的物联网卡锁卡原因及其处理方法
  • 5
    一文看懂音视频流媒体协议及信令技术
  • 6
    低功耗蓝牙LE Audio Profile 详细介绍
  • 7
    HaaS EDU K1设备资源总体介绍
  • 8
    HaaS100 云端钉一体智能语音播放器设计
  • 9
    一站式开发工具HaaS Studio使用说明
  • 10
    基于HaaS100搭建云端一体RFID读卡器
  • 1
    浅谈蓝牙演进之路：从诞生到普及
    134
  • 2
    厂区地图导航制作：GIS技术与路径导航算法融合
    78
  • 3
    物联网卡：物联网卡不支持语音通话，是如何实现设备间的数据传输和通信的？
    86
  • 4
    物联网卡：当物联网设备用卡使用在非物联网设备上会被管控吗
    66
  • 5
    物联网卡：物联网卡为什么不能使用在手机上
    118
  • 6
    物联网：物联网卡不能使用在什么设备上
    74
  • 7
    物联网卡：物联网卡网络不稳定的解决办法
    89
  • 8
    物联网卡：物联网卡为什么好用
    57
  • 9
    物联网卡：物联网卡停机多久会被注销
    59
  • 10
    物联网卡：如何判断并选择合适的流量套餐
    88

    • 相关课程

    更多
  • JavaScript入门与实战
  • JavaScript 自学手册文档教程
  • 前端开发CSS基础

    • 相关电子书

    更多
  • JavaScript函数
  • Delivering Javascript to World
  • 编程语言如何演化-以JS的private为例

    • 相关实验场景

    更多
  • 前端开发基础3：CSS3常见显示属性
  • Html5和Webpack2：Webpack5打包JS和样式表
  • 前端开发基础6：Node.js和LESS预编译工具
    • 下一篇
    DataWorks