Pysor is a Python library for the simulation of various sensors. It is designed to be used with an MQTT broker of your choice, providing an easy and flexible way to simulate sensor data for IoT applications.
Installation
Pysor is available on PyPi. You can install it via pip:
pip install pysorQuickstart
Here's a quick example showing how to simulate a temperature sensor using Pysor:
from sensor_simulation import MqttClient, SensorManager
from sensor_simulation.sensors import TemperatureSensor
if __name__ == '__main__':
mqtt_client = MqttClient('your.broker.org')
temperature_sensor = TemperatureSensor(mqtt_client, 'sensor/temperature')
sensor_manager = SensorManager()
sensor_manager.add_sensor(temperature_sensor)
try:
sensor_manager.run()
except KeyboardInterrupt:
sensor_manager.stop_all()Available Sensors
Pysor comes with a variety of pre-built sensor simulations:
- TemperatureSensor
- HumiditySensor
- LightIntensitySensor
- WaterLevelSensor
- PhSensor
All sensors have parameters to set the mqtt client, the topic and the interval at which the sensor should publish messages.
Example of parameters for HumiditySensor
class HumiditySensor(BaseSensor):
"""
Humidity sensor class.
Min and max humidity values are in percentage.
"""
def __init__(self,
mqtt_client: MqttClient,
topic: str,
interval: float = 120.0,
min_humidity: int = 30,
max_humidity: int = 80,
humidity_change: float = 1.0,
current_humidity: float = None
) -> None:
...Custom Sensors
Extend the BaseSensor class and implement the 'generate_data' method. This method should return the data to be published.
class MyCustomSensor(BaseSensor):
def generate_data(self) -> Any:
# Your custom data generation logic here
...SensorManager
The SensorManager class is used to run the sensors. It has a method to add sensors and a method to run the sensors.
sensor_manager = SensorManager()
sensor_manager.add_sensor(temperature_sensor)
sensor_manager.add_sensor(humidity_sensor)
sensor_manager.add_sensor(water_level_sensor)
sensor_manager.add_sensor(light_intensity_sensor)
try:
sensor_manager.run()
except KeyboardInterrupt:
sensor_manager.stop_all()MqttClient
The MqttClient class is used to publish messages to the broker. It uses the Paho MQTT library to communicate with the broker.
mqtt_client = MqttClient('your.broker.org')License
Pysor is licensed under the MIT License. See the LICENSE file for more details
