Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/azure/azure-umqtt-c
General purpose library for communication over the mqtt protocol
https://github.com/azure/azure-umqtt-c
c mqtt mqtt-client mqtt-protocol
Last synced: 3 days ago
JSON representation
General purpose library for communication over the mqtt protocol
- Host: GitHub
- URL: https://github.com/azure/azure-umqtt-c
- Owner: Azure
- License: other
- Created: 2015-12-03T02:01:28.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-07-05T21:22:32.000Z (3 months ago)
- Last Synced: 2024-09-30T16:11:01.244Z (3 days ago)
- Topics: c, mqtt, mqtt-client, mqtt-protocol
- Language: C
- Size: 1010 KB
- Stars: 50
- Watchers: 59
- Forks: 51
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
- Security: SECURITY.MD
Awesome Lists containing this project
README
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
# Microsoft Azure MQTT
azure-umqtt-c is a C library for MQTT 3.1 protocol communication to Azure Cloud IoT Services.
## Dependencies
azure-mqtt client use the azure-c-shared-utility, which is a C library provisioning common functionality for basic tasks (like string, list manipulation, IO, etc.).
azure-c-shared-utility is available here: .
azure-c-shared-utility needs to be built before building azure-mqtt-c.
## Setup
### Build
- Clone azure-umqtt-c by:
```Shell
git clone https://github.com/Azure/azure-umqtt-c.git
cd azure-umqtt-c
git submodule update --init
```
- Create a folder cmake under azure-umqtt-c
- Switch to the cmake folder and run
```Shell
cmake ..
```
- Build
```Shell
cmake --build .
```
### Installation and Use
Optionally, you may choose to install azure-umqtt-c on your machine:
1. Switch to the *cmake* folder and run
```Shell
cmake -Duse_installed=ON ../
cmake --build . --target install
```
or install using the follow commands for each platform:
On Linux:
```Shell
sudo make install
```
On Windows:
```Shell
find_package(umqtt REQUIRED CONFIG)
target_link_library(yourlib umqtt)
```
_This requires that azure-c-shared-utility is installed (through CMake) on your machine._
_If running tests, this requires that umock-c, azure-ctest, and azure-c-testrunnerswitcher are installed (through CMake) on your machine._
### Building the tests
In order to build the tests use:
```Shell
cmake .. -Drun_unittests:bool=ON
```