├── .github └── workflows │ └── ci.yml ├── .gitignore ├── LICENSE ├── README.md └── services /.github/workflows/ci.yml: -------------------------------------------------------------------------------- 1 | 2 | name: "CI" 3 | on: 4 | push: 5 | branches: 6 | - master 7 | - NGSI-v2 8 | - NGSI-LD 9 | pull_request: 10 | branches: 11 | - master 12 | - NGSI-v2 13 | - NGSI-LD 14 | workflow_dispatch: 15 | 16 | jobs: 17 | test-modules: 18 | name: Test Script 19 | runs-on: ubuntu-latest 20 | timeout-minutes: 10 21 | steps: 22 | - uses: actions/checkout@master 23 | with: 24 | persist-credentials: false 25 | fetch-depth: 0 26 | submodules: recursive 27 | - name: Build Images 28 | run: | 29 | ./services create || true 30 | - name: Run Script 31 | run: | 32 | ./services start test && ./services stop test -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | *~ 2 | .fuse_hidden* 3 | .directory 4 | .Trash-* 5 | .nfs* 6 | *.DS_Store 7 | .AppleDouble 8 | .LSOverride 9 | Icon 10 | ._* 11 | .DocumentRevisions-V100 12 | .fseventsd 13 | .Spotlight-V100 14 | .TemporaryItems 15 | .Trashes 16 | .VolumeIcon.icns 17 | .com.apple.timemachine.donotpresent 18 | .AppleDB 19 | .AppleDesktop 20 | Network Trash Folder 21 | Temporary Items 22 | .apdisk 23 | logs 24 | *.log 25 | npm-debug.log* 26 | yarn-debug.log* 27 | yarn-error.log* 28 | pids 29 | *.pid 30 | *.seed 31 | *.pid.lock 32 | node_modules/ 33 | jspm_packages/ 34 | .npm 35 | .eslintcache 36 | *.tgz 37 | .next -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2018-2023 FIWARE Foundation e.V. 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | [![FIWARE Banner](https://fiware.github.io/tutorials.IoT-Sensors/img/fiware.png)](https://www.fiware.org/developers) 2 | 3 | [![FIWARE IoT Agents](https://nexus.lab.fiware.org/repository/raw/public/badges/chapters/iot-agents.svg)](https://github.com/FIWARE/catalogue/blob/master/iot-agents/README.md) 4 | [![License: MIT](https://img.shields.io/github/license/fiware/tutorials.IoT-Sensors.svg)](https://opensource.org/licenses/MIT) 5 | [![Support badge](https://img.shields.io/badge/tag-fiware-orange.svg?logo=stackoverflow)](https://stackoverflow.com/questions/tagged/fiware) 6 | [![UltraLight 2.0](https://img.shields.io/badge/Payload-Ultralight-27ae60.svg)](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual) 7 | 8 | These tutorials are an introduction to IoT devices and the usage of the 9 | [UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual) 10 | Protocol for constrained devices. The tutorial introduces a series of dummy IoT devices which are displayed within the 11 | browser and allows a user to interact with them. A complete understanding of all the terms and concepts defined in this 12 | tutorial is necessary before proceeding to connect the IoT devices to the Context Broker via a real IoT Agent. 13 | 14 | The tutorial uses [cUrl](https://ec.haxx.se/) commands throughout, but is also available as 15 | [Postman documentation](https://www.postman.com/downloads/). 16 | 17 | # Start-Up 18 | 19 | ## NGSI-v2 Smart Supermarket 20 | 21 | **NGSI-v2** offers JSON based interoperability used in individual Smart Systems. To run this tutorial with **NGSI-v2**, use the `NGSI-v2` branch. 22 | 23 | ```console 24 | git clone https://github.com/FIWARE/tutorials.IoT-Sensors.git 25 | cd tutorials.IoT-Sensors 26 | git checkout NGSI-v2 27 | 28 | ./services create 29 | ./services start 30 | ``` 31 | 32 | | [![NGSI v2](https://img.shields.io/badge/NGSI-v2-5dc0cf.svg)](https://fiware-ges.github.io/orion/api/v2/stable/) | :books: [Documentation](https://github.com/FIWARE/tutorials.IoT-Sensors/tree/NGSI-v2) | [Postman Collection](https://fiware.github.io/tutorials.IoT-Sensors/) | ![](https://img.shields.io/github/last-commit/fiware/tutorials.IoT-Sensors/NGSI-v2) 33 | | --- | --- | --- | --- 34 | 35 | 36 | ## NGSI-LD Smart Farm 37 | 38 | **NGSI-LD** offers JSON-LD based interoperability used for Federations and Data Spaces. To run this tutorial with **NGSI-LD**, use the `NGSI-LD` branch. 39 | 40 | ```console 41 | git clone https://github.com/FIWARE/tutorials.IoT-Sensors.git 42 | cd tutorials.IoT-Sensors 43 | git checkout NGSI-LD 44 | 45 | ./services create 46 | ./services start 47 | ``` 48 | 49 | | [![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.08.01_60/gs_cim009v010801p.pdf) | :books: [Documentation](https://github.com/FIWARE/tutorials.IoT-Sensors/tree/NGSI-LD) | [Postman Collection](https://fiware.github.io/tutorials.IoT-Sensors/ngsi-ld.html) | ![](https://img.shields.io/github/last-commit/fiware/tutorials.IoT-Sensors/NGSI-LD) 50 | | --- | --- | --- | --- 51 | 52 | --- 53 | 54 | ## License 55 | 56 | [MIT](LICENSE) © 2018-2024 FIWARE Foundation e.V. 57 | -------------------------------------------------------------------------------- /services: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | # 3 | # Command Line Interface to start all services associated with the Tutorial 4 | # 5 | 6 | set -e 7 | 8 | echo -e "Checkout the \033[1;36mNGSI-v2\033[0m branch of this repository to run the Smart Supermarket tutorial.\n" 9 | echo -e "Checkout the \033[1;31mNGSI-LD\033[0m branch of this repository to run the Smart Farm tutorial.\n" 10 | --------------------------------------------------------------------------------