Sensor-data-bridge - Revision history

Bertrik Sikken at 22:17, 10 March 2024

2024-03-10T22:17:25Z

← Older revision		Revision as of 22:17, 10 March 2024
Line 23:		Line 23:
	* Forwards measurement data to https://sensor.community		* Forwards measurement data to https://sensor.community
	* Forwards measurement data to https://opensensemap.org, you can configure the opensense-id by adding a device attribute in TheThingsNetwork console		* Forwards measurement data to https://opensensemap.org, you can configure the opensense-id by adding a device attribute in TheThingsNetwork console
	* Forwards measurement data to https://cayenne.mydevices.com, you configure the username/password/clientid by adding a device attribute in TheThingsNetwork console		* -Forwards measurement data to https://cayenne.mydevices.com, you configure the username/password/clientid by adding a device attribute in TheThingsNetwork console-
	* Supports Cayenne payload format for the data encoding, a custom payload format for SPS30 data (includes particle counts)		* Supports Cayenne payload format for the data encoding, a custom payload format for SPS30 data (includes particle counts)
	* Supports JSON payload format for the data encoding, you can specify in the config file which JSON fields are used		* Supports JSON payload format for the data encoding, you can specify in the config file which JSON fields are used
	* Handles particulate matter data (PM10, PM4.0, PM2.5, PM1.0), temperature, humidity, barometric pressure		* Handles particulate matter data (PM10, PM4.0, PM2.5, PM1.0), temperature, humidity, barometric pressure
	* Handles sound/noise data (LA EQ, and min/max value)		* Handles sound/noise data (LA EQ, and min/max value)
	* Can be run as a systemd service, so it automatically restarts in case the software would crash		* Can be run as a systemd service, so it automatically restarts in case the software would crash, server is restarted, etc

	=== Next steps ===		=== Next steps ===
	* add support for geolocation through a scan of surrounding WiFi access-points and a geolocation service (google, mozilla)~~, see h~~		* add support for geolocation through a scan of surrounding WiFi access-points and a geolocation service (google, mozilla)
	* add support for NB-IOT modem with t-mobile backend, see my [[Sim7020]] project		* add support for NB-IOT modem with t-mobile backend, see my [[Sim7020]] project
	* add support for other backends, e.g. feinstaub-app?		* add support for other backends, e.g. feinstaub-app?
Line 38:		Line 38:
	You need the following:		You need the following:
	* a server that is always on and connected to the internet, can be Linux or Windows		* a server that is always on and connected to the internet, can be Linux or Windows
	* a Java installation (<b>JDK</b> to compile), at least version 8		* a Java installation (<b>JDK</b> to compile), at least version 17
	* some configuration on TheThingsNetwork side		* some configuration on TheThingsNetwork side
	* some configuration of my application (YAML file)		* some configuration of my application (YAML file)

	== Compilation ==		== Compilation ==
			(not needed if you use the docker image)
	To compile the software:		To compile the software:
	* clone the software from my github archive		* clone the software from my github archive
Line 60:		Line 61:

	== Installation ==		== Installation ==


	=== run as docker/podman container ===		=== run as docker/podman container ===
	How to run in docker/podman:		How to run in docker/podman:
Line 180:		Line 179:

	== Development ==		== Development ==

	~~== Running with docker / podman ==~~
	~~(experimental)~~

	~~How to run in docker:~~
	* Install docker and docker-compose and add your user account to the 'docker' group (Linux):
	~~sudo apt install docker-ce docker-compose~~
	~~sudo usermod -aG docker <username>~~
	* Get the code from github:
	~~git clone https://github.com/bertrik/sensor-data-bridge~~
	* Enter the 'docker' directory and pull the docker image from github:
	~~cd sensor-data-bridge~~
	~~cd docker~~
	~~docker-compose pull~~
	* Edit the config files with your own settings:
	~~vi sensor-data-bridge.yaml~~
	* Start the container:
	~~docker-compose up~~

	== Forwarding noise data ==		== Forwarding noise data ==

Bertrik Sikken: /* run as docker container */

2024-03-10T22:14:34Z

run as docker container

← Older revision		Revision as of 22:14, 10 March 2024
Line 62:		Line 62:


	=== run as docker container ===		=== run as docker/podman container ===
	~~TODO~~		How to run in docker/podman:
			* Install docker and docker-compose and add your user account to the 'docker' group (Linux):
			sudo apt install docker-ce docker-compose
			sudo usermod -aG docker <username>
			* Get the code from github:
			git clone https://github.com/bertrik/sensor-data-bridge
			* Enter the 'docker' directory and pull the docker image from github:
			cd sensor-data-bridge
			cd docker
			docker-compose pull
			* Edit the config files with your own settings:
			vi sensor-data-bridge.yaml
			(or use nano, gedit, whatever)
			* Start the container:
			docker-compose up

	=== installation from raw tar ===		=== installation from raw tar ===

Bertrik Sikken: /* Installation */

2024-03-10T22:13:05Z

Installation

← Older revision		Revision as of 22:13, 10 March 2024
Line 61:		Line 61:
	== Installation ==		== Installation ==

	=== installation ~~for~~ raw tar ===
			=== run as docker container ===
			TODO


			=== installation from raw tar ===
	Unzip the distribution file somewhere on your system.		Unzip the distribution file somewhere on your system.
	I put it in my home directory, for example		I put it in my home directory, for example
	cd		cd
	tar xvf code/sensor-data-bridge/sensor-data-bridge/build/distributions/sensor-data-bridge.tar		tar xvf code/sensor-data-bridge/sensor-data-bridge/build/distributions/sensor-data-bridge.tar

	~~=== run as docker container ===~~
	~~TODO~~

	== Configuration ==		== Configuration ==

Bertrik Sikken: /* Configuration */

2024-02-22T16:07:39Z

Configuration

← Older revision		Revision as of 16:07, 22 February 2024
Line 164:		Line 164:
	* The mapping from TTN-id to boxid is refreshed by the forwarder once an hour, so within an hour the forwarding to opensensemap.org starts		* The mapping from TTN-id to boxid is refreshed by the forwarder once an hour, so within an hour the forwarding to opensensemap.org starts

	~~=== Cayenne myDevices ===~~		== Development ==
	* Go to https://cayenne.mydevices.com/ and log in
	** Add a new node, TODO
	* Go to TTN console and log in
	** Add attributes for the device, under 'General settings'
	*** attribute name = 'mydevices-username', value = MQTT username from cayenne mydevices dashboard
	*** attribute name = 'mydevices-password', value = MQTT password from cayenne mydevices dashboard
	*** attribute name = 'mydevices-clientid', value = Client ID from cayenne mydevices dashboard

	~~<nowiki>Insert non-formatted text here</nowiki>~~== Development ==

	== Running with docker / podman ==		== Running with docker / podman ==

Bertrik Sikken: /* Installation */

2024-02-12T13:05:33Z

Installation

← Older revision		Revision as of 13:05, 12 February 2024
Line 60:		Line 60:

	== Installation ==		== Installation ==

			=== installation for raw tar ===
	Unzip the distribution file somewhere on your system.		Unzip the distribution file somewhere on your system.
	I put it in my home directory, for example		I put it in my home directory, for example
	cd		cd
	tar xvf code/sensor-data-bridge/sensor-data-bridge/build/distributions/sensor-data-bridge.tar		tar xvf code/sensor-data-bridge/sensor-data-bridge/build/distributions/sensor-data-bridge.tar

			=== run as docker container ===
			TODO

	== Configuration ==		== Configuration ==

Bertrik Sikken: /* What is this */

2024-02-12T13:04:38Z

What is this

← Older revision		Revision as of 13:04, 12 February 2024
Line 16:		Line 16:

	Project on Github: https://github.com/bertrik/sensor-data-bridge		Project on Github: https://github.com/bertrik/sensor-data-bridge

			Unofficial sensor.community API documentation: https://api-sensor-community.bessarabov.com/

	=== Features ===		=== Features ===

Bertrik Sikken: /* What is this */

2024-02-12T12:49:14Z

What is this

← Older revision		Revision as of 12:49, 12 February 2024
Line 13:		Line 13:
	* http://sensor.community (formerly Luftdaten),		* http://sensor.community (formerly Luftdaten),
	* http://opensensemap.org and		* http://opensensemap.org and
	* https://cayenne.mydevices.com		* <s>https://cayenne.mydevices.com</s>

	Project on Github: https://github.com/bertrik/sensor-data-bridge		Project on Github: https://github.com/bertrik/sensor-data-bridge

Bertrik Sikken: /* Running with docker */

2023-04-08T12:14:39Z

Running with docker

← Older revision		Revision as of 12:14, 8 April 2023
Line 168:		Line 168:
	<nowiki>Insert non-formatted text here</nowiki>== Development ==		<nowiki>Insert non-formatted text here</nowiki>== Development ==

	== Running with docker ==		== Running with docker / podman ==
	(experimental)		(experimental)

Bertrik Sikken: /* Next steps */

2023-04-08T12:14:03Z

Next steps

← Older revision		Revision as of 12:14, 8 April 2023
Line 29:		Line 29:

	=== Next steps ===		=== Next steps ===
	* package the application so it can easily run in a docker container
	* add support for geolocation through a scan of surrounding WiFi access-points and a geolocation service (google, mozilla), see h		* add support for geolocation through a scan of surrounding WiFi access-points and a geolocation service (google, mozilla), see h
	* add support for NB-IOT modem with t-mobile backend, see my [[Sim7020]] project		* add support for NB-IOT modem with t-mobile backend, see my [[Sim7020]] project

Bertrik Sikken at 12:12, 28 July 2022

2022-07-28T12:12:56Z

← Older revision		Revision as of 12:12, 28 July 2022
Line 3:		Line 3:
	\|Picture=loraluftdatenforwarder.png		\|Picture=loraluftdatenforwarder.png
	\|Omschrijving=Collects sensor data, forwards it to sensor.community/opensense/etc		\|Omschrijving=Collects sensor data, forwards it to sensor.community/opensense/etc
	\|Status=~~In progress~~		\|Status=Completed
	\|Contact=bertrik		\|Contact=bertrik
	}}		}}