// Copyright (c) 2017 Intel Corporation. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
'use strict';
const { Clock, ROSClock } = require('./lib/clock.js');
const ClockType = require('./lib/clock_type.js');
const compareVersions = require('compare-versions');
const Context = require('./lib/context.js');
const debug = require('debug')('rclnodejs');
const Duration = require('./lib/duration.js');
const fs = require('fs');
const generator = require('./rosidl_gen/index.js');
const loader = require('./lib/interface_loader.js');
const logging = require('./lib/logging.js');
const NodeOptions = require('./lib/node_options.js');
const {
FloatingPointRange,
IntegerRange,
Parameter,
ParameterDescriptor,
ParameterType,
DEFAULT_NUMERIC_RANGE_TOLERANCE,
} = require('./lib/parameter.js');
const path = require('path');
const QoS = require('./lib/qos.js');
const rclnodejs = require('bindings')('rclnodejs');
const tsdGenerator = require('./rostsd_gen/index.js');
const validator = require('./lib/validator.js');
const Time = require('./lib/time.js');
const ActionClient = require('./lib/action/client.js');
const ActionServer = require('./lib/action/server.js');
const ClientGoalHandle = require('./lib/action/client_goal_handle.js');
const { CancelResponse, GoalResponse } = require('./lib/action/response.js');
const ServerGoalHandle = require('./lib/action/server_goal_handle.js');
const {
getActionClientNamesAndTypesByNode,
getActionServerNamesAndTypesByNode,
getActionNamesAndTypes,
} = require('./lib/action/graph.js');
function inherits(target, source) {
let properties = Object.getOwnPropertyNames(source.prototype);
properties.forEach((property) => {
target.prototype[property] = source.prototype[property];
});
}
function getCurrentGeneratorVersion() {
let jsonFilePath = path.join(generator.generatedRoot, 'generator.json');
return new Promise((resolve, reject) => {
fs.open(jsonFilePath, 'r', (err, fd) => {
if (err) {
if (err.code === 'ENOENT') {
resolve(null);
return;
}
reject(err);
} else {
fs.readFile(jsonFilePath, 'utf8', (err, data) => {
if (err) {
reject(err);
} else {
resolve(JSON.parse(data).version);
}
});
}
});
});
}
/**
* A module that exposes the rclnodejs interfaces.
* @exports rclnodejs
*/
let rcl = {
_rosVersionChecked: false,
// Map<Context,Array<Node>
_contextToNodeArrayMap: new Map(),
/** {@link Clock} class */
Clock: Clock,
/** {@link ClockType} enum */
ClockType: ClockType,
/** {@link Context} class */
Context: Context,
/**
* @constant {number}
* The plus/minus tolerance for determining number equivalence.
*
* @see [FloatingPointRange]{@link FloatingPointRange}
* @see [IntegerRange]{@link IntegerRange}
*/
DEFAULT_NUMERIC_RANGE_TOLERANCE: DEFAULT_NUMERIC_RANGE_TOLERANCE,
/** {@link Duration} class */
Duration: Duration,
/** {@link FloatingPointRange} class */
FloatingPointRange: FloatingPointRange,
/** {@link IntegerRange} class */
IntegerRange: IntegerRange,
/** {@link Logging} class */
logging: logging,
/** {@link NodeOptions} class */
NodeOptions: NodeOptions,
/** {@link Parameter} */
Parameter: Parameter,
/** {@link ParameterDescriptor} */
ParameterDescriptor: ParameterDescriptor,
/** {@link ParameterType} */
ParameterType: ParameterType,
/** {@link QoS} class */
QoS: QoS,
/** {@link ROSClock} class */
ROSClock: ROSClock,
/** {@link Time} class */
Time: Time,
/** {@link module:validator|validator} object */
validator: validator,
/** {@link ActionClient} class */
ActionClient: ActionClient,
/** {@link ActionServer} class */
ActionServer: ActionServer,
/** {@link ClientGoalHandle} class */
ClientGoalHandle: ClientGoalHandle,
/** {@link ServerGoalHandle} class */
ServerGoalHandle: ServerGoalHandle,
/** {@link ServerGoalHandle} enum */
CancelResponse: CancelResponse,
/** {@link GoalResponse} enum */
GoalResponse: GoalResponse,
/** {@link getActionClientNamesAndTypesByNode} function */
getActionClientNamesAndTypesByNode: getActionClientNamesAndTypesByNode,
/** {@link getActionServerNamesAndTypesByNode} function */
getActionServerNamesAndTypesByNode: getActionServerNamesAndTypesByNode,
/** {@link getActionNamesAndTypes} function */
getActionNamesAndTypes: getActionNamesAndTypes,
/**
* Create a node.
* @param {string} nodeName - The name used to register in ROS.
* @param {string} namespace - The namespace used in ROS, default is an empty string.
* @param {Context} context - The context, default is Context.defaultContext().
* @param {NodeOptions} options - The options to configure the new node behavior.
* @return {Node} The instance of Node.
*/
createNode(
nodeName,
namespace = '',
context = Context.defaultContext(),
options = NodeOptions.defaultOptions
) {
if (typeof nodeName !== 'string' || typeof namespace !== 'string') {
throw new TypeError('Invalid argument.');
}
if (!this._contextToNodeArrayMap.has(context)) {
throw new Error('Invalid context. Must call rclnodejs(context) before using the context');
}
let handle = rclnodejs.createNode(nodeName, namespace, context.handle());
let node = new rclnodejs.ShadowNode();
node.handle = handle;
Object.defineProperty(node, 'handle', { configurable: false, writable: false }); // make read-only
node.context = context;
node.init(nodeName, namespace, context, options);
debug('Finish initializing node, name = %s and namespace = %s.', nodeName, namespace);
this._contextToNodeArrayMap.get(context).push(node);
return node;
},
/**
* Init the module.
* @param {Context} context - The context, default is Context.defaultContext().
* @param {string[]} argv - Process commandline arguments.
* @return {Promise<undefined>} A Promise.
*/
init(context = Context.defaultContext(), argv = process.argv) {
return new Promise((resolve, reject) => {
// check if context has already been initialized
if (this._contextToNodeArrayMap.has(context)) {
throw new Error('The context has already been initialized.');
}
// check argv for correct value and state
if (!Array.isArray(argv)) {
throw new TypeError('argv must be an array.');
}
if (argv.reduce((hasNull, arg) => hasNull || typeof arg !== 'string', false)) {
throw new TypeError('argv elements must not be null');
}
// initialize context
rclnodejs.init(context.handle(), argv);
this._contextToNodeArrayMap.set(context, []);
if (this._rosVersionChecked) {
// no further processing required
resolve();
}
getCurrentGeneratorVersion()
.then((version) => {
let forced = version === null || compareVersions(version, generator.version()) === -1;
if (forced) {
debug('The generator will begin to create JavaScript code from ROS IDL files...');
}
generator
.generateAll(forced)
.then(() => {
this._rosVersionChecked = true;
resolve();
})
.catch((e) => {
reject(e);
});
})
.catch((e) => {
reject(e);
});
});
},
/**
* Start to spin the node, which triggers the event loop to start to check the incoming events.
* @param {Node} node - The node to be spun.
* @param {number} [timeout=10] - ms to wait, block forever if negative, don't wait if 0, default is 10.
* @return {undefined}
*/
spin(node, timeout = 10) {
if (!(node instanceof rclnodejs.ShadowNode)) {
throw new TypeError('Invalid argument.');
}
if (node.spinning) {
throw new Error('The node is already spinning.');
}
node.startSpinning(timeout);
},
/**
* Execute one item of work or wait until a timeout expires.
* @param {Node} node - The node to be spun.
* @param {number} [timeout=10] - ms to wait, block forever if negative, don't wait if 0, default is 10.
* @return {undefined}
*/
spinOnce(node, timeout = 10) {
if (!(node instanceof rclnodejs.ShadowNode)) {
throw new TypeError('Invalid argument.');
}
if (node.spinning) {
throw new Error('The node is already spinning.');
}
node.spinOnce(node.context.handle(), timeout);
},
/**
* @param {Context} context - The context to be shutdown.
* @return {undefined}
*/
shutdown(context = Context.defaultContext()) {
if (this.isShutdown(context)) {
throw new Error('The module rclnodejs has been shutdown.');
return;
}
// shutdown and remove all nodes assigned to context
this._contextToNodeArrayMap.get(context).forEach((node) => {
node.stopSpinning();
node.destroy();
});
this._contextToNodeArrayMap.delete(context);
// shutdown context
if (context === Context.defaultContext()) {
Context.shutdownDefaultContext();
} else {
context.shutdown();
}
},
/**
* A predictate for testing if a context has been shutdown.
* @param {Context} [context=defaultContext] - The context to inspect
* @return {boolean} Return true if the module is shut down, otherwise return false.
*/
isShutdown(context = Context.defaultContext()) {
return !this._contextToNodeArrayMap.has(context);
},
/**
* Get the interface package, which is used by publisher/subscription or client/service.
* @param {string} name - The name of interface to be required.
* @return {object} - the object of the required package/interface.
*/
require(name) {
return loader.loadInterface(name);
},
/**
* Search packgaes which locate under path $AMENT_PREFIX_PATH, regenerate all JavaScript structs files from the IDL of
* messages(.msg) and services(.srv) and put these files under folder 'generated'. Any existing files under
* this folder will be overwritten after the execution.
* @return {Promise<undefined>} A Promise.
*/
regenerateAll() {
// This will trigger to regererate all the JS structs used for messages and services,
// to overwrite the existing ones although they have been created.
debug('Begin regeneration of JavaScript code from ROS IDL files.');
return new Promise((resolve, reject) => {
generator
.generateAll(true)
.then(() => {
tsdGenerator.generateAll(); // create interfaces.d.ts
debug('Finish regeneration.');
resolve();
})
.catch((e) => {
reject(e);
});
});
},
/**
* Judge if the topic/service is hidden, see http://design.ros2.org/articles/topic_and_service_names.html#hidden-topic-or-service-names
* @param {string} name - Name of topic/service.
* @return {boolean} - True if a given topic or service name is hidden, otherwise False.
*/
isTopicOrServiceHidden(name) {
if (typeof name !== 'string') {
throw new TypeError('Invalid argument');
}
let arr = name.split('/');
for (let i = 0; i < arr.length; i++) {
if (arr[i].startsWith('_')) return true;
}
return false;
},
/**
* Expand a given topic name using given node name and namespace as well.
* @param {string} topicName - Topic name to be expanded.
* @param {string} nodeName - Name of the node that this topic is associated with.
* @param {string} nodeNamespace - Namespace that the topic is within.
* @return {string} Expanded topic name which is fully qualified.
*/
expandTopicName(topicName, nodeName, nodeNamespace) {
return rclnodejs.expandTopicName(topicName, nodeName, nodeNamespace);
},
createMessage(type) {
let typeClass = loader.loadInterface(type);
if (typeClass) {
return new typeClass();
}
return undefined;
},
/**
* Create a plain JavaScript by specified type identifier
* @param {string|Object} type -- the type identifier, acceptable formats could be 'std_msgs/std/String'
* or {package: 'std_msgs', type: 'msg', name: 'String'}
* @return {Object|undefined} A plain JavaScript of that type
*/
createMessageObject(type) {
return this.createMessage(type).toPlainObject();
},
};
process.on('SIGINT', () => {
debug('Catch ctrl+c event and will cleanup and terminate.');
rcl.shutdown();
process.exit(0);
});
module.exports = rcl;
// The following statements are located here to work around a
// circular dependency issue occuring in rate.js
const Node = require('./lib/node.js');
const TimeSource = require('./lib/time_source.js');
/** {@link TimeSource} class */
rcl.TimeSource = TimeSource;
inherits(rclnodejs.ShadowNode, Node);