Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/smacken/mqttbridge
Mqtt Broker bridge - bridge between mqtt brokers one-way/two way sync
https://github.com/smacken/mqttbridge
iot iot-gateway mqtt mqtt-brokers mqtt-client mqtt-connector
Last synced: 3 days ago
JSON representation
Mqtt Broker bridge - bridge between mqtt brokers one-way/two way sync
- Host: GitHub
- URL: https://github.com/smacken/mqttbridge
- Owner: smacken
- License: other
- Created: 2020-04-03T00:03:48.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-07-20T17:17:06.000Z (over 3 years ago)
- Last Synced: 2024-11-14T11:11:57.625Z (2 months ago)
- Topics: iot, iot-gateway, mqtt, mqtt-brokers, mqtt-client, mqtt-connector
- Language: C#
- Homepage:
- Size: 63.5 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MQTT Bridge
Bridge two MQTT Brokers to pass topic messages between them. Acts as a client on both brokers
rather than broker-broker bridge ala Mosquitto.
The idea is to bridge between physical-physical brokers or physical-cloud brokers.
Bridge can be one-way (primary > secondary) or two-way with sync between brokers.
Topics can be filtered for each broker for messages bridged.
## Getting Started
1. Run the app by entering the following command in the command shell:
```console
dotnet run -- --config=config.json
```
2. CLI - Can configure cli via config file in yaml/json. Or by passing values directly
```console
MqttBridge.exe --config=config.json
```
```console
MqttBridge.exe --primary=localhost:1883 --secondary=localhost:1884
```
3. Library - Bridge can be configured with primary & secondary brokers.
```c#
var primaryOptions = new MqttClientOptionsBuilder()
.WithClientId("Primary")
.WithTcpServer("localhost", 1883)
.WithCleanSession();
var bridgeOptions = new BridgeOptions
{
PrimaryOptions = primaryOptions.Build(),
SecondaryOptions = secondaryOptions.Build(),
PrimaryFilters = new TopicFilter[] {new TopicFilterBuilder().WithTopic("primary/topic").Build()}
SecondaryFilters = new TopicFilter[] {new TopicFilterBuilder().WithTopic("secondary/topic").Build()}
SyncMode = true
};
var bridge = new Bridge(bridgeOptions);
await bridge.ConnectAsync(CancellationToken.None);
```
### Prerequisites
Install the following:
- [.NET Core](https://dotnet.microsoft.com/download).
### Installing
MqttBridgeCli.exe from releases
Nuget MqttBridge from packages
## Running the tests
xUnit testing
```bash
dotnet test
```
### Break down into end to end tests
Testing templates being used
```
dotnet test
```
### And coding style tests
Editor.config
```
Editor.config
```
## Deployment
```
dotnet publish
```
## Built With
* [MqttNet](https://github.com/migueldeicaza/gui.cs) - MqttNet
## Contributing
Please read [CONTRIBUTING.md](https://gist.github.com/PurpleBooth/b24679402957c63ec426) for details on our code of conduct, and the process for submitting pull requests to us.
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/your/project/tags).
## Authors
* **Scott Mackenzie** - *Initial work* - [Smacktech](https://github.com/smacken)
See also the list of [contributors](https://github.com/smacken/templated/contributors) who participated in this project.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## Acknowledgments
* mmm