NEQTO Docs
  • Languages icon日本語
    • English
  • ドキュメント
  • API
  • FAQ

›neqto.js

Getting Started

  • NEQTO Hello World!
  • Tutorial Step 1. NEQTO Console設定
  • Tutorial Step 2. デバイス設定とサービスの開始 (NEQTO Bridge)
  • Tutorial Step 2. デバイス設定とサービスの開始 (STM32 Discovery)
  • Tutorial Step 2. デバイス設定とサービスの開始 (SPRESENSE)
  • Tutorial Step 3. スクリプトを使ったアプリケーション開発

NEQTO

  • NEQTO アカウント登録
  • サブアカウント
  • APIの利用
  • GCP用NEQTO CloudSync
  • NEQTO Engineファームウェアリスト
  • お問い合わせに関するガイドライン

NEQTO Console

  • はじめに
  • 基本情報
  • 管理者専用の操作
  • デバイス管理
  • Linuxデバイス管理
  • 一括登録
  • スクリプト
  • アクション & コンタクト
  • Consoleでデータを表示
  • NEQTO Apps

    • NEQTO Apps について
    • NEQTO Infinitypool
    • NEQTO Insights
    • NEQTO Custodia
    • NEQTO Flow
  • Machine Driver
  • 推奨ブラウザ
  • 請求情報

SPRESENSE

    ハードウェア仕様

    • 01. About Spresense

    ソフトウェア仕様

    • 01. 動作フロー
    • 02. 初期インストール
    • 03. Spresense Wi-Fi 初期設定
    • 04. Spresense LTE-M 初期設定
    • 05. デバッグログ取得方法
    • 06. システムLED動作
    • 07. イベントメッセージ
    • 08. ファームウェア更新方法

    neqto.js

    • 01. About neqto.js
    • 02. Log
    • 03. Timers
    • 04. HTTP
    • 05. HTTPS
    • 06. MQTT
    • 07. Secure
    • 08. Storage
    • 09. Sleep
    • 10. RTC
    • 11. GPIO
    • 12. UART
    • 13. SPI
    • 14. I2C
    • 15. ADC
    • 16. GNSS
    • 17. Camera
    • 18. Utils
    • 19. nqSpresense
    • 20. nqService
    • 21. nqMqtt
    • 22. nqFOTA
    • 23. nqWiFi
    • 24. nqLte

STM32 Discovery

    ハードウェア仕様

    • 01. About STM32 Discovery Kit (B-L4S5I-IOT01A)

    ソフトウェア仕様

    • 01. 動作フロー
    • 02. 初期インストール
    • 03. STM32 Discovery Wi-Fi 初期設定
    • 04. デバッグログ取得方法
    • 05. システムLED動作
    • 06. イベントメッセージ
    • 07. ファームウェア更新方法

    neqto.js

    • 01. About neqto.js
    • 02. Log
    • 03. Timers
    • 04. HTTP
    • 05. HTTPS
    • 06. MQTT
    • 07. Secure
    • 08. Storage
    • 09. Sleep
    • 10. RTC
    • 11. UserSW
    • 12. GPIO
    • 13. UART
    • 14. SPI
    • 15. I2C
    • 16. ADC
    • 18. Utils
    • 19. nqDiscovery
    • 20. nqService
    • 21. nqMqtt
    • 22. nqFOTA
    • 23. nqWiFi

NEQTO Bridge

    ハードウェア仕様

    • 01. NEQTO Bridge Module
    • 02. NEQTO Bridge Wi-Fi Module
    • 03. NEQTO Bridge LTE-1 Module
    • 04. NEQTO Bridge LTE-M/NB Module
    • 05. NEQTO Bridge IO Board
    • 06. NEQTO Bridge Digital IO Board
    • 07. NEQTO Bridge Connector Board

    ソフトウェア仕様

    • 01. 動作フロー
    • 02. NEQTO Bridge Wi-Fi Module 初期設定
    • 03. NEQTO Bridge LTE Module 初期設定
    • 04. デバッグログ取得方法
    • 05. システムLED動作
    • 06. イベントメッセージ
    • 07. ファームウェア更新方法

    neqto.js

    • 01. About neqto.js
    • 02. Log
    • 03. Timers
    • 04. HTTP
    • 05. HTTPS
    • 06. MQTT
    • 07. Secure
    • 08. Storage
    • 09. Sleep
    • 10. RTC
    • 11. UserSW
    • 12. GPIO
    • 13. UART
    • 14. SPI
    • 15. I2C
    • 16. ADC
    • 17. BLE
    • 18. Utils
    • 19. nqBridge
    • 20. nqService
    • 21. nqMqtt
    • 22. nqFOTA
    • 23. nqWiFi
    • 24. nqLte
    • 25. nqLAN
    • 26. nqEx

Linux-based device

    ソフトウェア仕様

    • 01. システム要件
    • 02. インストール
    • 03. ソフトウェア構成
    • 04. 動作フロー
    • 05. デバッグログ取得方法
    • 06. イベントメッセージ
    • 07. ソフトウェア更新方法

    neqto.js

    • 01. About neqto.js
    • 02. Log
    • 03. Timers
    • 04. HTTP
    • 05. HTTPS
    • 06. MQTT
    • 07. Secure
    • 08. Storage
    • 09. RTC
    • 10. UNIXSocket
    • 11. FileSystem
    • 12. SubProcess
    • 13. Utils
    • 14. nqLinux
    • 15. nqService
    • 16. nqMqtt
    • 17. nqFOTA
    • 18. nqLAN

neqto.js Libraries

  • About neqto.js Libraries
  • UART

    • GM65 Barcode Reader
    • SRF Ultrasonic Range Finder - Serial Mode

    I2C

    • HTS221 v2 Temperature and Humidity Sensor
    • LIS2DW12 v2 Accelerometer
    • SRF Ultrasonic Range Finder - I2C Mode
    • [Archive] HTS221 Temperature and Humidity Sensor
    • [Archive] LIS2DW12 Accelerometer

    Utils

    • RTC Alarm Synchronized Scheduler

    Integration

    • AWS S3 v2
    • AWS IoT Core v2
    • Azure IoT v2
    • GCP IoT Core
    • [Archive] AWS S3
    • [Archive] AWS IoT Core

neqto.js Snippets

  • About neqto.js Snippets
  • DataDog
  • Dropbox
  • Google Sheets
  • InfluxDB
  • Oracle Cloud Object Storage
  • Salesforce
  • SAP Cloud Platform Internet of Things
  • Splunk
  • Niagara

Release Notes

  • NEQTO Console アップデート
  • NEQTO Firmware (Bridge Wi-Fi/LTE Module) リリース
  • NEQTO Firmware (STM32 Discovery Wi-Fi) リリース
  • NEQTO Firmware (Spresense Wi-Fi/LTE-M) リリース
  • NEQTO Engine Linux版 リリース

12. SubProcess

subprocessオブジェクトは、パイプを使用した外部アプリケーション間プロセス通信機能を提供する組み込みオブジェクトです。

機能概要:

  • 外部アプリケーションの標準入力(stdin)、標準出力(stdout)、標準エラー出力(stderr)をそれぞれパイプ接続し、リアルタイムでデータを送受信する機能を提供します。
  • 外部アプリケーションに特定シグナルを送信する機能を提供します。
  • 外部アプリケーションの終了コードを取得する機能を提供します。

制限事項:

  • 使用可能なコマンド実行リソースは3本です。



subprocess Global Object

Methods()/PropertiesSummaryVersionNote
subprocess.create()コマンド実行インスタンスを生成します。



subprocess.create(cmd[,options])

コマンド実行インスタンスを生成します。

NameTypeM/OSummaryNote
cmdstringmandatoryコマンド実行パスを指定します。
コマンド引数が必要な場合はコマンド実行パスの後に空白文字区切りで指定します。空白文字を含む文字列を1つの引数として扱う場合は、対象となる文字列範囲をシングルクォート'またはダブルクォート"で囲んでください。
尚、コマンド文字数は最大4095文字、コマンド実行パスを含めたコマンド引数は最大31までとなります。
例:date, uname -a, ls -l /tmp,
cat /tmp/memo.txt, tail -f /tmp/memo.txt,
/usr/bin/myApp "hello world",
/home/user/start.sh "abc" 1 2 3
リダイレクト、パイプを使用した複数コマンドの組み合わせによる実行はサポートしていません。
optionsObjectoptionalオプション
詳細はOptionsを参照してください。
return{Exec}, null-{Exec} : 生成された{Exec}
null : リソース不足でインスタンスの生成が失敗した場合
パラメータ異常の場合は例外となります。

Options

NameTypeM/OSummaryNote
readBuffSizenumberoptional読み出しバッファサイズ[Byte]
設定範囲: 1~2,147,483,647
デフォルト値は4096となります。
abortSigNonumberoptional強制終了シグナル番号
.abort()メソッドコール等により、強制的にコマンド実行プロセスを中止させる際に送信するシグナル番号を指定します。実行プロセスはこのシグナル番号で必ず終了可能である必要があります。
設定範囲: 1(SIGHUP), 2(SIGINT),
9(SIGKILL), 15(SIGTERM)
デフォルト値は15(SIGTERM)となります。



{Exec}

Methods()/PropertiesSummaryVersionNote
.on()イベントハンドラを登録します。
.execute()コマンド実行を開始します。
.read()コマンド実行プロセスから受信した標準出力(stdout)データを読み出します。
.readError()コマンド実行プロセスから受信した標準エラー出力(stderr)データを読み出します。
.write()コマンド実行プロセスの標準入力(stdin)にデータを送信します。
.sendSignal()コマンド実行プロセスに指定されたシグナルを送信します。
.isBusy()コマンド実行プロセスの実行状態を取得します。
.getResult()コマンド実行プロセスの終了コードを取得します。
.abort()コマンド実行プロセスを強制的に中止します。
.release()コマンド実行リソースを解放します。



Details

.on(event,callback)

イベントハンドラを登録します。

NameTypeM/OSummaryNote
eventstringmandatoryイベント名
使用できるイベント名は、stdout, stderr, exitとなります。
callbackfunctionmandatoryイベント発生時にコールバック処理を実行します。
returnundefined--パラメータ異常の場合は例外となります。

event : ’stdout’

コマンド実行プロセスから標準出力(stdout)データを受信し、読み出しバッファにデータが格納された際にコールバック処理を実行します。

event : ’stderr’

コマンド実行プロセスから標準エラー出力(stderr)データを受信し、読み出しバッファにデータが格納された際にコールバック処理を実行します。

event : ’exit’

コマンド実行プロセスが終了した際にコールバック処理を実行します。

尚、標準出力(stdout)および標準エラー出力(stderr)の読み出しバッファにデータが存在する状態でプロセスが終了した場合、コールバック処理はすぐに実行されません。必ず.read()または.readError()メソッドで全てのデータを読み出す必要があります。

.execute()

コマンド実行を開始します。

NameTypeM/OSummaryNote
returnboolean-true: 成功
false: 失敗

.read([isBin])

コマンド実行プロセスから受信した標準出力(stdout)データを読み出します。

NameTypeM/OSummary                                    Note
isBinbooleanoptional読み出しデータの形式を指定します。
true: バイナリデータ形式で読み出し
false: 文字列形式で読み出し
デフォルト値はfalseとなります。
returnArrayBuffer, string-読み出しデータ
戻り値の型はisBinで決定されます。
trueを指定した場合はArrayBuffer型、falseを指定した場合は、string型となります。
読み出しデータはreadBuffSizeで指定したサイズ以下となります。読み出しデータがない場合はサイズが0となります。
パラメータ異常の場合は例外となります。

.readError([isBin])

コマンド実行プロセスから受信した標準エラー出力(stderr)データを読み出します。

NameTypeM/OSummary                                    Note
isBinbooleanoptional読み出しデータの形式を指定します。
true: バイナリデータ形式で読み出し
false: 文字列形式で読み出し
デフォルト値はfalseとなります。
returnArrayBuffer, string-読み出しデータ
戻り値の型はisBinで決定されます。
trueを指定した場合はArrayBuffer型、falseを指定した場合は、string型となります。
読み出しデータはreadBuffSizeで指定したサイズ以下となります。読み出しデータがない場合はサイズが0となります。
パラメータ異常の場合は例外となります。

.write(data)

コマンド実行プロセスの標準入力(stdin)にデータを送信します。

NameTypeM/OSummaryNote
datastring, ArrayBuffermandatory送信データ
returnnumber-送信されたデータサイズ
送信が失敗した場合は-1を返却します。
パラメータ異常の場合は例外となります。

.sendSignal(sigNo)

コマンド実行プロセスに指定されたシグナルを送信します。

NameTypeM/OSummaryNote
sigNonumbermandatoryシグナル番号
設定範囲: 1~31
returnboolean-true: 成功
false: 失敗
パラメータ異常の場合は例外となります。

.isBusy()

コマンド実行プロセスの実行状態を取得します。

NameTypeM/OSummaryNote
returnboolean-実行状態
true: 実行中
false: 終了または停止状態

.getResult()

コマンド実行プロセスの終了コードを取得します。
このメソッドはコマンド実行プロセスが終了した後に使用します。

NameTypeM/OSummaryNote
return{ExecStatus}-{ExecStatus} : 終了コード

{ExecStatus}

終了コードおよび終了シグナル番号は基本排他的であり、どちらか一方が無効値-1となります。
尚、コマンド未実行またはコマンド実行中の場合は、全てのプロパティ値が-1となります。

NameTypeSummaryNote
.exitCodenumberコマンド実行プロセスの終了コード (0~255)
コマンド実行プロセスが正常終了した場合に終了コードが設定されます。
.sigNonumberコマンド実行プロセスの終了シグナル番号
コマンド実行プロセスがシグナルにより終了した場合に終了の要因となったシグナル番号が設定されます。
.wstatusnumber終了ステータス情報 (参考データ)
終了コードおよび終了シグナル情報が格納されているオリジナルデータとなります。

.abort()

コマンド実行プロセスを強制的に中止します。
コマンド実行中の場合のみ有効となります。

NameTypeM/OSummaryNote
returnundefined--

.release()

コマンド実行リソースを解放します。
実行中のコマンドは強制終了となります。

NameTypeM/OSummaryNote
returnundefined--



オブジェクトの使用例

Sample 1

コマンド実行のサンプルです。
uname -pコマンドを実行し、CPU情報を表示します。

var done = false;
var exec = subprocess.create('uname -p');

exec.on('stdout', function() {
    var resp = exec.read();
    print('response : ' + resp);
});
exec.on('exit', function() {
    done = true;
});

exec.execute();

while(1) {
    if(done) {
        break;
    }
}

exec.release();
exec = undefined;
print('done');

Sample 2

パイプを使用した外部アプリケーション間プロセス通信のサンプルです。
下記、シェルスクリプトを起動し、プロセス通信を確立します。
シェルスクリプトから受信した標準出力および標準エラー出力をPrint出力します。
次にシェルスクリプトへ標準入力を介して"end"を送信し、シェルスクリプトを終了させます。

test.sh

#!/bin/bash
cnt=0
while :
do
  read -t 1 key
  if [ -n "$key" ]; then
    echo "$key"
    break
  fi
  if [ $((${cnt} % 2)) = 1 ]; then
    echo "$cnt" 1>&2
  else
    echo "$cnt"
  fi
  cnt=`expr $cnt + 1`
done

neqto.js

var done = false;
var exec = subprocess.create('/tmp/test.sh');
if(!exec) {
    throw 'subprocess is out of resource';
}
exec.on('stdout', function() {
    var str = exec.read();
    print('stdout : ' + str.replace(/\n/g, ''));
});
exec.on('stderr', function() {
    var str = exec.readError();
    print('stderr : ' + str.replace(/\n/g, ''));
});
exec.on('exit', function() {
    done = true;
});

var tm = setTimeout(function() {
    exec.write('end\n');
}, 10000);

exec.execute();

while(1) {
    if(done) {
        var res = exec.getResult();
        print('.exitCode : ' + res.exitCode)
        print('.sigNo : ' + res.sigNo)
        break;
    }
}

clearTimeout(tm);
exec.release();
exec = undefined;
print('script done');



Updated: 2022-09-06
← 前次 →
  • subprocess Global Object
    • subprocess.create(cmd[,options])
    • Options
  • {Exec}
  • Details
    • .on(event,callback)
    • event : ’stdout’
    • event : ’stderr’
    • event : ’exit’
    • .execute()
    • .read([isBin])
    • .readError([isBin])
    • .write(data)
    • .sendSignal(sigNo)
    • .isBusy()
    • .getResult()
    • {ExecStatus}
    • .abort()
    • .release()
  • オブジェクトの使用例
    • Sample 1
    • Sample 2
NEQTO とはニュースサービスFAQプライバシーポリシー}
NEQTO Console
はじめに基本情報管理者専用の操作デバイス管理NEQTO Apps
NEQTO Bridge
NEQTO Bridge ピン配置NEQTO Bridge Wi-Fi ModuleNEQTO Bridge LTE-1 Moduleデバッグログ取得方法イベントメッセージ
APIのドキュメント
APIの利用グローバル APIリージョン APIAPIサービス利用規約
Jigsaw, Inc.
© 2023 JIG-SAW INC.