Provide a set of tools to realize the Asset Administration Shell for Industrie 4.0.

1. Description
2. Requirements
3. Download and Installation
4. Known Issues
5. How to obtain support
6. Contributing
7. Upcoming Changes
8. License

i40-aas is a typescript implementation of the specification "Details of the AssetAdministrationShell" part 1 version 1.0.

It implements all required classes to build an AAS-JSON-file. It is also possible to use it in the browser as it is JavaScript.

You need to download and install Node.js and its packagemanager NPM.

Enter node --version and npm --version in your command line to test your installation. You should see:

$ node --version
// min version: v8.12.0

$ npm --version
// min version: 6.4.1

Download and install the TypeScriptCompiler (tsc).

$ npm install -g typescript

Check your installation with tsc --version. You should see:

$ tsc --version
// min version: 3.5.3

Import i40-aas as a dependency in your package.json file of your Node.js or TypeScript project.

$ mkdir myaas
$ cd myaas
$ npm init

Create a tsconfig.json file in the root of the project directory and paste in the following snippet:

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "outDir": "dist",
    "sourceMap": true,
    "resolveJsonModule": true,
    "esModuleInterop": true,
    "strict": true,
    "declaration": true
  },
  "include": ["src/**/*.ts", "index.ts"],
  "exclude": ["node_modules"]
}

Let it be added by the package manager:

$ npm i --save git://github.com/SAP/i40-aas.git

Or add it manually to your package.json. (NOTE: You need to run npm i after you have edited your package.json.)

{
  "name": "testaas",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "dependencies":{
      "i40-aas": "git://github.com/SAP/i40-aas.git",
      ...
  },
  "author": "",
  "license": "ISC"
}

Please refer to the list of issues on GitHub.

Please use the GitHub issue tracker for any questions, bug reports, feature requests, etc.

You are welcome to join us in our efforts to improve and increase the set of tools to realize the Asset Administration Shell for Industrie 4.0!

Simply check the Contribution Guidelines.

This project follows the specification "Details of the AssetAdministrationShell" part 1 version 1.0, which is work in progress. As the specification changes, so will this project.

For upcoming changes under development, please refer to the Github issue board.

Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.