tree: 3ae82886363c333bcd4ccd21fed82c3e49973368 [path history] [tgz]
  1. BUILD.gn
  2. chip_im_initiator.cpp
  3. chip_im_responder.cpp
  4. common.cpp
  5. common.h
  6. MockEvents.cpp
  7. MockEvents.h
  8. README.md
  9. RequiredPrivilegeStubs.cpp
src/app/tests/integration/README.md

CHIP Example IM Application Tutorial

Introduction

The CHIP IM example application shows you how to implement a CHIP application program using IM protocols.

CHIP Protocols are, essentially, implementations of specific protocols over the CHIP transport. Furthermore, when two CHIP nodes are exchanging messages of a particular CHIP protocol, they do so over a construct called a CHIP Exchange which is a description of a CHIP-based conversation over a CHIP protocol. A CHIP Exchange is characterised by the ExchangeContext object, and every CHIP node must create an ExchangeContext object before initiating a CHIP conversation.

After constructing a CHIP ExchangeContext, CHIP messages are sent and received using the ChipMessageLayer class which sends the CHIP message over a chosen transport (TCP, UDP, or MRP).

Example Applications Walk Through

As part of this example, we have a ChipImInitiator program that acts as the client and sends echo requests to a ChipImResponder program that receives InvokeCommandRequests and sends back InvokeCommandResponse messages.

Test a device over IP

To start the Server in echo mode, run the built executable.

$ ./chip-im-responder

To start the Client in echo mode, run the built executable and pass it the IP address of the server to talk to.

$ ./chip-im-initiator <Server's IPv4 address>

If valid values are supplied, it will begin to periodically send messages to the server address provided for three times.