如何在Ruff开发板上使用USB存储设备
准备工作
- 确认开发板上的 RuffOS 大于等于1.5版本, 可以通过
rap system info命令来查看 - 确认 PC 端的 SDK 版本大于等于1.5版本
- 一个 U 盘，确保其是
FAT32格式
使用步骤
准备项目
在一个新的文件夹下执行如下命令，创建一个新的工程
rap init
此命令会下载开发板板载设备的驱动。如果看到如下信息
Downloading package "ruff-v1-sys-usb"...
恭喜你，你已经成功一半了。有了这个驱动，你就可以直接在应用代码中使用 $('#usb') 操作 USB 的相关功能。
注意 如果你希望在旧应用上使用 USB，请在 package.json 中，将 ruff-mbd-v1 的版本升级到4.1.2，再执行 rap install。
安装 USB 存储模块
安装存储驱动，执行如下命令
rap install ruff-v1-usb-storage-manager --save
因为 USB 设备的差异性，这里采用模块安装的方式，而不是通常的 rap device add。
编写应用
下面是一段示例代码：
'use strict';
var fs = require('fs');
var path = require('path');
var StorageManager = require('ruff-v1-usb-storage-manager');
var storageManager = new StorageManager();
$.ready(function (error) {
if (error) {
console.log(error);
return;
}
$('#usb').install(storageManager);
storageManager.on('mount', function (storage) {
// storage is mounted
// save data in the storage
var filePath = path.join(storage.partitions[0].path, 'test.txt');
fs.writeFileSync(filePath, 'hello world\n');
// eject the storage from the system before unplugging the storage
storage.eject();
// check whether the storage is successfully ejected
console.log(storage.ejected);
});
storageManager.on('unmount', function (storage) {
// storage is unmounted
});
});
在这段代码里
-
$('#usb')表示的是系统的 USB 管理器 -
$('#usb').install(storageManager)，可以将存储驱动与 USB 关联在一起。如果你的应用中用到多种 USB 设备，可以在这里安装多个不同的 USB Manager。 - storageManager 可以处理设备的插拔事件，USB 存储设备插入时，会产生
mount事件，拔下时，会产生unmount事件。
storageManager('mount', function(storage) {
});
storageManager('unmount', function(storage) {
});
- 下面的代码在 U 盘的第一个分区中创建一个
test.txt文件，并且写入hello world。
var filePath = path.join(storage.partitions[0].path, 'test.txt');
fs.writeFileSync(filePath, 'hello world\n');
- 下面的代码是调用 storage 的
eject()方法，将 storage 安全地从系统中移除，然后可以将 U 盘拔下。
storage.eject();
console.log(storage.ejected);
部署测试
执行如下命令，将应用部署在开发板上
rap deploy -s
好，插上 U 盘，开始你的测试吧！
