mirror of
https://github.com/OpenMTC/OpenMTC.git
synced 2024-12-24 07:06:46 +00:00
Merge branch 'master' into feature-python3-port
This commit is contained in:
Ronald Steinke
commit
f8ec30c59b
114
README.md
114
README.md
@ -4,43 +4,95 @@
|
||||
</a>
|
||||
</p>
|
||||
|
||||
The OpenMTC SDK aims to provide developers with a convenient yet flexible tool to write oneM2M compliant applications. This includes network applications (NAs), gateway application (GAs), device applications (DAs), as well as interworking proxy entities (IPEs).
|
||||
[](https://www.fiware.org/developers/catalogue/)
|
||||
[](https://www.eclipse.org/legal/epl-v10.html)
|
||||
[](https://stackoverflow.com/questions/tagged/fiware+iot)
|
||||
<br/>
|
||||
[](http://fiware-openmtc.readthedocs.org/en/latest/?badge=latest)
|
||||
|
||||
[](https://hub.docker.com/u/openmtc)
|
||||
[](https://travis-ci.org/OpenMTC/OpenMTC)
|
||||
|
||||
# Table of Content
|
||||
The OpenMTC SDK aims to provide developers with a convenient yet flexible tool
|
||||
to write oneM2M compliant applications. This includes network applications
|
||||
(NAs), gateway application (GAs), device applications (DAs), as well as
|
||||
interworking proxy entities (IPEs).
|
||||
|
||||
- [Quick Start](doc/openmtc-get-started.md)
|
||||
- [Introduction](doc/introduction.md)
|
||||
- [Deployment](doc/deployment-guide.md)
|
||||
- [The MQTT Client](doc/onem2m-client-mqtt.md)
|
||||
- [Authentication Guide](doc/authentication.md)
|
||||
- [Installation of the OpenMTC SDK](doc/install-sdk.md)
|
||||
- [Overview REST API](doc/overview-rest-api.md)
|
||||
- [Write your first OpenMTC applications](doc/training/training-index.md)
|
||||
- [SDK - Using the Application Framework](doc/sdk-framework.md)
|
||||
- [SDK - The low-level CSE Client](doc/sdk-client.md)
|
||||
- [SDK - The Data Model](doc/sdk-datamodel.md)
|
||||
- Examples
|
||||
- [IoT Data Visualization](doc/example-apps/IoT-data-visualization.py)
|
||||
- [Data Aggregation](doc/example-apps/data-aggregation.py)
|
||||
- [Simple Decision](doc/example-apps/simple-decision.py)
|
||||
- [Simple Decision 2](doc/example-apps/simple-decision-2.py)
|
||||
- Scripts
|
||||
- [Create App Structure Script](doc/create-app-structure.md)
|
||||
- [Create binary docker images Script](doc/create-binary-docker.md)
|
||||
- [Code Repository Structure](doc/repository-structure.md)
|
||||
- [Developer FAQ](doc/developer-faq.md)
|
||||
This project is part of [FIWARE](https://www.fiware.org/). For more information
|
||||
check the FIWARE Catalogue entry for the
|
||||
[IoT Agents](https://github.com/Fiware/catalogue/tree/master/iot-agents).
|
||||
|
||||
# Content
|
||||
|
||||
- [Install](#install)
|
||||
- [Usage](#usage)
|
||||
- [API](#api)
|
||||
- [Quality Assurance](#quality-assurance)
|
||||
- [License](#license)
|
||||
|
||||
|
||||
# Python
|
||||
## Install
|
||||
|
||||
The OpenMTC SDK is written in and for the Python programming language. Users should therefore have at least a certain knowledge of Python and its paradigms. For this matter, the following material is recommended:
|
||||
Information about how to install the JSON IoTAgent can be found at the
|
||||
corresponding section of the
|
||||
[Installation & Administration Guide](https://fiware-openmtc.readthedocs.io/en/latest/deployment-guide).
|
||||
|
||||
- [The Python Homepage](http://www.python.org)
|
||||
- [Expert Python Programming by Tarek Ziadé](http://www.e-reading.by/bookreader.php/138816/Ziade_-_Expert_Python_programming.pdf)
|
||||
- [Code Like a Pythonista: Idiomatic Python](http://www.omahapython.org/IdiomaticPython.html)
|
||||
## Usage
|
||||
|
||||
# Feedback
|
||||
Information about how to use the IoT Agent can be found in the
|
||||
[User & Programmers Manual](https://fiware-openmtc.readthedocs.io/en/latest/introduction).
|
||||
|
||||
Please create issues for any problems and direct any comments or feedback you are having to <a href="mailto:support@openmtc.org">support@openmtc.org</a>
|
||||
## API
|
||||
|
||||
Information about the REST API can be found in the
|
||||
[API Section](https://fiware-openmtc.readthedocs.io/en/latest/overview-rest-api)
|
||||
|
||||
|
||||
## Python
|
||||
|
||||
The OpenMTC SDK is written in and for the Python programming language. Users
|
||||
should therefore have at least a certain knowledge of Python and its paradigms.
|
||||
For this matter, the following material is recommended:
|
||||
|
||||
- [The Python Homepage](http://www.python.org)
|
||||
- [Expert Python Programming by Tarek Ziadé](http://www.e-reading.by/bookreader.php/138816/Ziade_-_Expert_Python_programming.pdf)
|
||||
- [Code Like a Pythonista: Idiomatic Python](http://www.omahapython.org/IdiomaticPython.html)
|
||||
|
||||
## Feedback
|
||||
|
||||
Please create issues for any problems and direct any comments or feedback you
|
||||
are having to <a href="mailto:support@openmtc.org">support@openmtc.org</a>
|
||||
|
||||
Please let us know what you think. We are also very interested in any use case
|
||||
you are _not_ able to implement with the SDK or if you find it difficult to do
|
||||
so.
|
||||
|
||||
|
||||
## Quality Assurance
|
||||
|
||||
This project is part of [FIWARE](https://fiware.org/) and has been rated as
|
||||
follows:
|
||||
|
||||
- **Version Tested:**
|
||||
|
||||
- **Documentation:**
|
||||
|
||||
|
||||
- **Responsiveness:**
|
||||
|
||||
|
||||
- **FIWARE Testing:**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Licence
|
||||
|
||||
The OpenMTC SDK is licensed under the Eclipse Public License (EPL)
|
||||
version 1.
|
||||
|
||||
© 2018 OpenMTC
|
||||
|
||||
Please let us know what you think. We are also very interested in any use case you are *not* able to implement with the SDK or if you find it difficult to do so.
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
Transfer OpenMTC Data to an InfluxDB
|
||||
"""
|
||||
|
||||
__version__ = "1.1.0"
|
||||
__version__ = "1.2.0"
|
||||
__description__ = "InfluxdbApp"
|
||||
__author_name__ = "Christian Klopp"
|
||||
__author_mail__ = "christian.klopp@fokus.fraunhofer.de"
|
||||
|
||||
@ -3,7 +3,7 @@ This App will forward all incoming sensor traffic to the Fiware Orion Context
|
||||
Broker
|
||||
"""
|
||||
|
||||
__version__ = "1.1.0"
|
||||
__version__ = "1.2.0"
|
||||
__description__ = "OrionContextBroker"
|
||||
__author_name__ = "Christian Klopp"
|
||||
__author_mail__ = "christian.klopp@fokus.fraunhofer.de"
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
App to inject data from a csv file to OpenMTC
|
||||
"""
|
||||
|
||||
__version__ = "1.1.0"
|
||||
__version__ = "1.2.0"
|
||||
__description__ = "csvInjector"
|
||||
__author_name__ = "Christian Klopp"
|
||||
__author_mail__ = "christian.klopp@fokus.fraunhofer.de"
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
TODO: Add description here
|
||||
"""
|
||||
|
||||
__version__ = "1.1.0"
|
||||
__version__ = "1.2.0"
|
||||
__description__ = "mqttConnector"
|
||||
__author_name__ = "Ronald Steinke"
|
||||
__author_mail__ = "ronald.steinke@fokus.fraunhofer.de"
|
||||
|
||||
9
doc/index.md
Normal file
9
doc/index.md
Normal file
@ -0,0 +1,9 @@
|
||||
# Open MTC IoT Agent
|
||||
|
||||
[](https://www.fiware.org/developers/catalogue/)
|
||||
[](https://stackoverflow.com/questions/tagged/fiware+iot)
|
||||
|
||||
The OpenMTC SDK aims to provide developers with a convenient yet flexible tool
|
||||
to write oneM2M compliant applications. This includes network applications
|
||||
(NAs), gateway application (GAs), device applications (DAs), as well as
|
||||
interworking proxy entities (IPEs).
|
||||
@ -2,7 +2,7 @@
|
||||
Interworking Proxy for Cul868 devices.
|
||||
"""
|
||||
|
||||
__version__ = "1.1.0"
|
||||
__version__ = "1.2.0"
|
||||
__description__ = "The OpenMTC Cul868IPE"
|
||||
__author_name__ = "Ronny Kreuch"
|
||||
__author_mail__ = "ronny.kreuch@fokus.fraunhofer.de"
|
||||
|
||||
52
mkdocs.yml
Normal file
52
mkdocs.yml
Normal file
@ -0,0 +1,52 @@
|
||||
site_name: Open MTC
|
||||
site_url: https://github.com/OpenMTC/OpenMTC
|
||||
repo_url: https://github.com/OpenMTC/OpenMTC.git
|
||||
site_description: FIWARE Open MTC IoT Agent document site
|
||||
docs_dir: doc/
|
||||
site_dir: html
|
||||
markdown_extensions: [toc,tables, fenced_code]
|
||||
use_directory_urls: false
|
||||
theme: readthedocs
|
||||
extra_css: ["https://fiware.org/style/fiware_readthedocs.css", "https://fiware.org/style/fiware_readthedocs_iot.css"]
|
||||
pages:
|
||||
- Home: index.md
|
||||
- 'User & Programmers Manual':
|
||||
- Introduction: introduction.md
|
||||
- Quick Start: openmtc-get-started.md
|
||||
- The MQTT Client: onem2m-client-mqtt.md
|
||||
- Authentication Guide: authentication.md
|
||||
- Overview REST API: overview-rest-api.md
|
||||
- Write your first OpenMTC applications: training/training-index.md
|
||||
- Console Outputs:
|
||||
- Sensor Backend: training/console-outputs/training-sensor-backend.md
|
||||
- Sensor Gateway: training/console-outputs/training-sensor-gateway.md
|
||||
- Sensor IPE: training/console-outputs/training-sensor-ipe.md
|
||||
- Sensor GUI: training/console-outputs/training-sensor-gui.md
|
||||
- Sensor Actuator Backend: training/console-outputs/training-sensor-actuator-backend.md
|
||||
- Sensor Actuator Gateway: training/console-outputs/training-sensor-actuator-gateway.md
|
||||
- Sensor Actuator IPE: training/console-outputs/training-sensor-actuator-ipe.md
|
||||
- Sensor Actuator GUI: training/console-outputs/training-sensor-actuator-gui.md
|
||||
- Training:
|
||||
- IPE Sensors: training/training-ipe-sensors.md
|
||||
- IPE Sensors Actuators: training/training-ipe-sensors-actuators.md
|
||||
- GUI Sensors: training/training-gui-sensors.md
|
||||
- GUI Sensors Actuators: training/training-gui-sensors-actuators.md
|
||||
- SDK - Using the Application Framework: sdk-framework.md
|
||||
- SDK - The low-level CSE Client: sdk-client.md
|
||||
- SDK - The Data Model: sdk-datamodel.md
|
||||
- Examples:
|
||||
- IoT Data Visualization: example-apps/IoT-data-visualization.py
|
||||
- Data Aggregation: example-apps/data-aggregation.py
|
||||
- Simple Decision: example-apps/simple-decision.py
|
||||
- Simple Decision 2: example-apps/simple-decision-2.py
|
||||
- Scripts:
|
||||
- Create App Structure Script: create-app-structure.md
|
||||
- Create binary docker images Script: create-binary-docker.md
|
||||
- Code Repository Structure: repository-structure.md
|
||||
- Developer FAQ: developer-faq.md
|
||||
- 'Installation & Administration Manual':
|
||||
- Deployment: deployment-guide.md
|
||||
- Installation of the OpenMTC SDK: install-sdk.md
|
||||
- Appendix : various.md
|
||||
- Resource Names & Types : reference-doc/resource-names-and-types.md
|
||||
- Gateway & Backend Configuration : reference-doc/gateway-and-backend-configuration.md
|
||||
@ -13,7 +13,7 @@ from utils import (get_packages, OpenMTCSdist, OpenMTCBuildPy,
|
||||
|
||||
# name and version
|
||||
SETUP_NAME = "openmtc-all"
|
||||
SETUP_VERSION = "1.1.0"
|
||||
SETUP_VERSION = "1.2.0"
|
||||
SETUP_DESCRIPTION = "The OpenMTC Backend and Gateway (GEvent version)"
|
||||
|
||||
# meta
|
||||
|
||||
@ -7,7 +7,7 @@ from utils import get_packages, OpenMTCSdist
|
||||
# name and version
|
||||
NAME = "sdk"
|
||||
SETUP_NAME = "openmtc-" + NAME
|
||||
SETUP_VERSION = "1.1.0"
|
||||
SETUP_VERSION = "1.2.0"
|
||||
SETUP_DESCRIPTION = "The OpenMTC Python SDK"
|
||||
|
||||
# meta
|
||||
|
||||
@ -17,7 +17,7 @@ The tests can be run from the command line. Make sure that a instance is running
|
||||
Assuming that a gateway is running at localhost, port 8000.
|
||||
|
||||
```bash
|
||||
$ pyresttest http://localhost:8000 tests/conformance/basic.yaml
|
||||
$ pyresttest http://localhost:8000 tests/interoperability/basic.yaml
|
||||
Test Group Openmtc Test 8.1.1 SUCCEEDED: : 1/1 Tests Passed!
|
||||
Test Group Openmtc Test 8.1.2 SUCCEEDED: : 4/4 Tests Passed!
|
||||
Test Group Openmtc Test 8.1.3 SUCCEEDED: : 4/4 Tests Passed!
|
||||
|
||||
Loading…
Reference in New Issue
Block a user