Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ciscodevnet/csmp-agent-lib
OpenCSMP: CiscoDevNet Opensource CSMP-Agent Library (Formerly CSMP-Agent)
https://github.com/ciscodevnet/csmp-agent-lib
cisco coap csmp embedded fnd ieee-802154 iiot iot ipv6 mesh mesh-networks silabs wireless
Last synced: about 14 hours ago
JSON representation
OpenCSMP: CiscoDevNet Opensource CSMP-Agent Library (Formerly CSMP-Agent)
- Host: GitHub
- URL: https://github.com/ciscodevnet/csmp-agent-lib
- Owner: CiscoDevNet
- License: apache-2.0
- Created: 2021-11-23T08:52:15.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-13T05:28:12.000Z (2 months ago)
- Last Synced: 2024-09-13T16:51:05.212Z (2 months ago)
- Topics: cisco, coap, csmp, embedded, fnd, ieee-802154, iiot, iot, ipv6, mesh, mesh-networks, silabs, wireless
- Language: C
- Homepage: https://github.com/CiscoDevNet/csmp-agent-lib
- Size: 58.8 MB
- Stars: 5
- Watchers: 17
- Forks: 3
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
## Overview
CoAP Simple Management Protocol (CSMP) is a device lifecycle management protocol optimized for resource constrained devices deployed within large-scale, bandwidth constrained IoT networks.
These instructions describe the build/run process for a C implementation of a sample CSMP Agent which incorporates the Cisco CSMP library `csmp-agent-lib`.
## Building The CSMP Agent Sample and CSMP Agent Library
These instructions have been verified to work on Ubuntu 20.10 Desktop 64bit (RPi4 build and target platform).
It is assumed a snapshot of the CSMP agent's source repository has been acquired and placed on the build platform via Github repository https://github.com/CiscoDevNet/csmp-agent-lib.
Change your default directory to the root of the CSMP Agent directory structure.
1. Install build tools.
Install build-essential package (gcc compiler, make, etc.) as described here ... https://help.ubuntu.com/community/InstallingCompilers
2. Confirm build target platform
If you are going to build for a different target platform, please set the correct gcc compiler for your target platform by modifying the line "CC=gcc" in "Makefile".
3. Build
> chmod 777 build.sh
> ./build.sh
If everything goes well, you should see "CsmpAgentLib_sample" executable in "sample" directory.
4. clean
If you want to clean the build files prior to a subsequent build ...
> ./build.sh clean
5. Additional debug output is enabled by modifying Makefile to include the line 'CFLAGS += -DPRINTDEBUG'
## Running CSMP Agent Sample
1. Run "CsmpAgentLib_sample" to start CSMP agent either with:
> ./CsmpAgentLib_sample -d
Or provide full comamnd line parameter set to configure FND server's IPv6 address, agent's registration interval (in seconds), EUI of the Agent (example) ...
>./CsmpAgentLib_sample -d 2020::2020 -min 10 -max 100 -eid 00173B1122334455
NOTE: a valid FND IPv6 address must be supplied.
2. Once "csmpsagent" is started, it will begin registration attempts with the FND server.
## Decoding CSMP Agent Messaging with Wireshark
Wireshark network analyzer may be used to observe CSMP messaging exchanged between the CSMP Agent and the FND instance. Note that this is a partial decode of the CoAP messaging and does not yet include decode of the TLV message payloads.
### Install Wireshark
Follow the instructions here ... https://itsfoss.com/install-wireshark-ubuntu/. As of this writting, version 3.2.7 is installed.
### Configure Wireshark for CSMP decoding.
Wireshark `Menu` -> `Analyze` -> `Decode As...` `+` -> `Field : UDP port` -> `value : 61628` -> `Current : CoAP` -> `OK`
### Sample CSMP PCAP files.
Test your Wireshark install by opening and observing the contents of the sample PCAPs provided in the folder `test/*.pcap`.
## TLV Support
CSMP messaging implements RESTful idioms with payloads encoded as Type/Length/Value tuples Value is encoded using Google Protocol Buffers.
The Protocol Buffer definitions of CSMP TLVs are contained in the .proto file located in the src/csmpagent/tlvs folder.
See 'src/csmpagent/csmpagent.c' for TLVs supported by the agent GET and POST methods.
Additions to the TLV set require ...
1. modification of the .proto file TLV definitions
2. compilation of the .proto file into .c and .h TLV files
3. rebuild of the agent (to use the new TLV files).
Use `protoc-c` (1.3.3 or later) to compile *.proto file into *.c and *.h files used during the agent build.
### Install protoc-c
> sudo apt-install protobuf-c-compiler
Go to src/csmpagent/tlvs/ and `make` to verify protoc-c is operating successfully.
### Add TLVs
1. Assign new TLV ID XXX in 'src/csmpagent/csmp.h'
2. Add new TLV definition in `src/csmpagent/tlvs/CsmpTlvs.proto` and make to generate new CsmpTlvs.pb-c.c/CsmpTlvs.pb-c.h
### Modify sample agent
1. Add desired GET or POST method dispatch for the new TLV XXX within 'src/csmpagent/csmpagent.c'.
2. Add required GET or POST implementations following the examples in folder 'src/csmpagent/'.
## Further Information for Developers
A CSMP Developer Guide can be found in the /docs folder. This guide describes how to install, build, and run the CSMP agent which will register and report metrics to an instance of Cisco Field Network Director.