Skip to content

README Node.js datalayer.provider.wildcard

This Node.js sample demonstrates dealing with a large set of nodes (big data provider) or any dynamic node hierarchy by listening to any _wildcarded address ( e.g. myRoot/**) and using self-managed virtual nodes, just returned in OnBrowse() method, which is efficient and light-weight.

IMPORTANT: Please read the Best Practise section in common Node.js documentation for more details and recommended samples.

Introduction

The sample demonstrates how to provide a large set of light-weight self-managed nodes by registering a wildcarded address to ctrlX Data Layer tree. The provider creates nodes with types of int/double/string.

Description

The sample demonstrates

  • How to provide nodes on a wildcarded address to ctrlX Data Layer.

  • How to create and provide meta data to nodes.

  • How to provide nodes with read-only or read-write support.

Prerequisites

Please read the common Node.js docs here, first.

Debug and Run

  1. Run 'npm install' in the terminal.
  2. Launch the app with the debugger attached by pressing F5.

Build and Install

  1. Launch Visual Studio Code
  2. Click on the Remote Explorer from the menu.
  3. Choose Open Folder in QEMU VM.
  4. Open the directory datalayer.provider.wildcard.
  5. Build and install snap as described here.
  6. Checkout ctrlX Data Layer web frontend (Settings | Data Layer)
  7. Check the output using Diagnostics:

  8. Login into your ctrlX

  9. Navigate to Diagnostics -> Logbook
  10. Click Settings on the right top corner
  11. Enable Show system messages
  12. Navigate to Filter -> Units and check your snap.sdk-node-provider-wildcard.app.service
  13. Now you should the see the app output diagnostics.
  14. Press Refresh to update.

  15. If you have root permissions, you can also watch the output on any ssh console with the command:

sudo snap logs sdk-node-provider-wildcard.app -f | more

Install the App

Login into ctrlX and install the App (Apps).

Gratulations - We're finished - Let's start coding

Support

Developer Community

Please join the Developer Community

SDK Forum

Please visit the SDK Forum

Issues

If you've found an error in these sample, please file an issue

License

SPDX-FileCopyrightText: Bosch Rexroth AG SPDX-License-Identifier: MIT