https://github.com/johnwalicki/iot-assettracking-perishable-network-blockchain
Use an IoT Asset Tracking device to record environmental sensor conditions to a Hyperledger Blockchain Perishable Network
https://github.com/johnwalicki/iot-assettracking-perishable-network-blockchain
Last synced: 21 days ago
JSON representation
Use an IoT Asset Tracking device to record environmental sensor conditions to a Hyperledger Blockchain Perishable Network
- Host: GitHub
- URL: https://github.com/johnwalicki/iot-assettracking-perishable-network-blockchain
- Owner: johnwalicki
- License: apache-2.0
- Created: 2018-02-18T21:26:49.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-02-03T07:54:48.000Z (about 3 years ago)
- Last Synced: 2025-03-23T22:43:22.196Z (about 1 month ago)
- Language: JavaScript
- Size: 22.3 MB
- Stars: 68
- Watchers: 7
- Forks: 117
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
*Read this in other languages: [日本語](README-ja.md).*
# IoT Asset Tracking using a Hyperledger Blockchain
## Introduction
This repository contains three sections which assemble an **IoT Asset Tracking device**, **Hyperledger Blockchain** and a **Node-RED Dashboard** to implement a perishable network supply chain. This example can be used to track environmental conditions for a food safety supply chain, refrigerated medical supplies, garden plant shipments or any perishable shipment that are temperature / humidity / vibration / time sensitive. If a cargo needs to be delivered within safe environmental parameters and time, the use of an IoT Asset Tracking device that combines environmental sensors, calculates its location via GPS, triangulation or beacons, and then reports its location via Cellular, 5G, Sub1GHz, SigFox, WiFi networks is extremely valuable. When multiple participants - farms, manufacturers, processing plants, trucks, ports, ships, distribution centers, consumer retail outlets - are involved in the safe shipment and payment of the cargo, a Hyperledger Blockchain can be used to record immutable transactions as the cargo shipment progresses through its delivery journey.
## Workshop
I've arranged this git repository to be read as an **[IBM Code Pattern](https://developer.ibm.com/code/)** [workshop tutorial](Workshop/README.md). Follow the steps in the [Workshop directory](Workshop/README.md) to learn how to build one yourself!
## Section Overviews
The first [section](ParticleElectron/README.md) details how to set up a **Particle Electron Asset Tracker v2** to send environmental sensor data and location to the cloud. This implementation uses a [Particle Electron](https://docs.particle.io/datasheets/kits-and-accessories/particle-shields/#electron-asset-tracker-v2) but many other IoT Asset Tracking devices that can transmit location and data can be substituted with similar results. Subsequent revisions of this workshop tutorial will add other IoT Asset Tracking boards so check back in the future.
The second [section](Blockchain/README.md) implements a **Perishable Business Network** using [Hyperledger](https://www.hyperledger.org/) Fabric, Hyperledger Composer, Hyperledger Composer REST APIs running in the [IBM Cloud Container Service](https://www.ibm.com/cloud/container-service) managed by a [Kubernetes cluster](https://console.bluemix.net/docs/tutorials/scalable-webapp-kubernetes.html#deploy-a-scalable-web-application-on-kubernetes) in the IBM Cloud.
In the third [section](Node-RED/README.md), the power of **Where, What and When** is best visualized in a dashboard that plots the geo location path, the environmental sensor data and can control triggers and alerts. I use **[Node-RED](https://nodered.org/)** and a Node.js server running in an IBM Cloud hosted Cloud Foundry application to receive the IoT Asset Tracking data and write it to the Hyperledger Fabric using Hyperledger Composer REST APIs. I also use a **Node-RED Dashboard** to plot the shipment on a map.
Enjoy! Give me feedback if you have suggestions on how to improve this tutorial.
## License
This code pattern is licensed under the Apache Software License, Version 2. Separate third party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer [Certificate of Origin, Version 1.1 (“DCO”)] (https://developercertificate.org/) and the [Apache Software License, Version 2]( (http://www.apache.org/licenses/LICENSE-2.0.txt).
ASL FAQ link: http://www.apache.org/foundation/license-faq.html#WhatDoesItMEAN