The Smart Territory Framework – STF – is an open-source framework that makes it easier and faster to create and operate interoperable platforms. STF supports the development and integration of smart and efficient solutions across multiple domains such as Smart Cities, Campuses and Regions; Energy and Utilities; Agriculture; Smart Building and Manufacturing.

The STF complies with the NGSI-LD open standard and leverages the NGSI-LD compliant Smart Data Models initiative that provides open-licensed data models for different domains such as Smart Cities, Smart Agrifood, Smart Environment, Smart Sensoring, Smart Energy, Smart Water, Smart Destination, Smart Robotics and Smart Manufacturing.

• Overview
  • FIWARE Context Broker
  • STF IoT module
  • Built on an open standard
• Smart Territory Framework Catalog
  • STF Core
  • Building Data Producers and Data Consumers
  • Data Producers
  • Data Consumers
• Additional Resources

Modular and built on open source and standards, the STF makes it easy to integrate existing solutions and add new capabilities and modules over time to its core. The core of the STF - STF Core - consists of two modules: the STF IoT module and the open-source FIWARE Context Broker.

The FIWARE Context Broker is an open source component that enables the connection and integration of different systems, applications, and services within an organization. Using the FIWARE Context Broker territories can assemble and store information from different systems, eventually belonging to different organisations, instead of having them perform in separate silos.

It provides geo-located queries capabilities as well as a subscription mechanism. This enables an independent module like a mobile application to query data filtered by geographical location but also to be notified with a given frequency or when changes on data take place (e.g., an air quality measurement is above a specified threshold value).

Built around the FIWARE Context Broker, the STF IoT module expands its capabilities enabling territories to ingest IoT data at scale from multiple and heterogeneous sources with advanced device management capabilities. For example, it includes a registry of all the devices and sensors deployed in the territory, regardless the operating model, the technology and the connectivity used.

The STF IoT module offers digital twin capabilities, enabling territories to store and retrieve the current state of every registered device in real-time. It also consists of an IoT data lake built on Amazon S3 that territories can use to query and generate insights about their IoT data but also to easily visualise them.

Built on an open standard, the Smart Territory Framework enables decoupling data producers from data consumers, to build scalable and interoperable solutions. The FIWARE Context Broker satisfies the NGSI specification (specified by the ETSI Industry Specification Group on Context Information Management – ETSI ISG CIM).

This specification provides an open API for managing and requesting information and an underlying information model based on Entities that are digital representations of real-world object having properties and relationships with other entities.

The STF leverages the Smart Data Models initiative that provides NGSI compliant open-licensed data models (more than 700 as of March 2022) for different industry domains such as Smart Cities, Smart Agrifood, Smart Environment and Smart Manufacturing

Using standardized and open API and data models help expand the capabilities of a platform based on the STF. Add new modules and capabilities, new data producers and consumers over time. Access a global market of standardized solutions facilitating the integration with your ecosystem of partners and solution providers.

Build shareable, replicable and reusable end-to-end solutions based on standardized module that you or your customers can easily deploy and update using the AWS Cloud Development Kit (AWS CDK), our open-source software development framework.

Start building your smart solutions leveraging the no-cost open-source catalog of modules and samples of solutions we offer below.

You can use this catalog to implement a platform based on the STF with the flexibility to deploy the complete solution or any of its independent module including the STF IoT module and the Context Broker.

The list below will be updated over time.

The core of the STF - STF Core - consists of two modules: the STF IoT module and the open-source FIWARE Context Broker.

We provide below a link to an AWS CDK application that enables you to deploy and provision the STF Core stack code and its supporting infrastructure.

• STF Core. Among the multiple implementations of the FIWARE Context Broker available, we have integrated the NEC Scorpio and the Orion-LD context brokers for this CDK application leveraging for both serverless services on AWS for automatic scaling, built-in high availability, and a pay-for-use billing model to increase agility and optimize costs. When deploying the STF, you can select the one you want to use.

When using the STF, Data Producers are decoupled from Data Consumers. You can build each of both independently as the information model is standardized and known in advance.

You can for example build a Grafana dashboard to visualise your data using Amazon Athena to query your IoT Data Lake.

You can build your Data Producers within hours as the only process needed to integrate a new source of data, is to transform the source data format into the data model relevant to the use case before sending the data to the STF IoT module.

The following video guides you through the implementation of a comprehensive solution using the STF including Data Producers and Data Consumers.

Below a reference architecture with examples of Data Producers and Data Consumers.

For each Data Producer, it is about using the right tool to ingest the data and route it to a Lambda function that will transform the source data format into an NGSI-LD entity and then publish it into the STF IoT Queue.

• LoRaWAN Sensors using AWS IoT Core for LoRaWAN. A CDK application that deploys a stack of a Data Producer using AWS IoT Core for LoRaWAN to ingest data from LoRaWAN sensors. This repository contains code to deploy the stack for multiple sensors (Bosch Parking Lot Sensor - PLS, Milesight AM103, Elsys ERS Sound, ...)

• STF Data Consumer using Amazon Athena. A CDK application of a Data Consumer using Amazon Athena that enables you to easily query and analyze your data in the STF IoT Datalake.
• STF Data Consumer using AWS IoT TwinMaker. A CDK application that provisions resources in AWS IoT TwinMaker to make it easy to build Digital Twins using the STF IoT Datalake as a data source..

This section provides links to additional resources that may help implement solutions based on the Smart Territory Framework:

• Build a Digital Twin using the Smart Territory Framework and AWS IoT TwinMaker
• FIWARE NGSI-LD Tutorial
• JSON-LD, NGSI-LD, Digital Twins and Smart Data Models
• Smart Data Models
• AWS CDK Workshop

See CONTRIBUTING for more information.

This library is licensed under the MIT-0 License. See the LICENSE file.