TIDUE59A May   2018  – September 2020

 

  1.   Description
  2.   Resources
  3.   Features
  4.   Applications
  5. 1System Description
    1. 1.1 Key System Specifications
  6. 2System Overview
    1. 2.1 Block Diagram
    2. 2.2 Design Considerations
    3. 2.3 Highlighted Products
      1. 2.3.1 CC3220
      2. 2.3.2 CC2640R2F
      3. 2.3.3 DRV8837
    4. 2.4 System Design Theory
      1. 2.4.1 CC3220S to CC2640R2F Interface
      2. 2.4.2 CC3220S to DRV8837 Interface
      3. 2.4.3 Software Architecture
      4. 2.4.4 Network Connection Management
      5. 2.4.5 Provisioning
        1. 2.4.5.1 AP Provisioning and SmartConfig™
        2. 2.4.5.2 Wi-Fi Provisioning Over BLE
      6. 2.4.6 Sending and Receiving Messages Through Cloud
        1. 2.4.6.1 Message Queue Telemetry Transport Protocol
        2. 2.4.6.2 MQTT Client Implementation
      7. 2.4.7 Over-the-Air Updates
        1. 2.4.7.1 HyperText Transfer Protocol
      8. 2.4.8 Security Enablers
        1. 2.4.8.1 Secure Boot
        2. 2.4.8.2 Secure Sockets
          1. 2.4.8.2.1 Hardware Accelerators
          2. 2.4.8.2.2 Simple Network Time Protocol
        3. 2.4.8.3 File System Security
          1. 2.4.8.3.1 Failsafe Files and Bundle Protection
      9. 2.4.9 Low-Power Consumption
  7. 3Hardware, Software, Testing Requirements, and Test Results
    1. 3.1 Required Hardware and Software
      1. 3.1.1 Hardware
        1. 3.1.1.1 CC3220S LaunchPad™ Development Kit
        2. 3.1.1.2 CC2640R2F LaunchPad™ Development Kit
        3. 3.1.1.3 Sensor BoosterPack™ Connections (BMI160)
        4. 3.1.1.4 DRV8837EVM Modifications and Connections
        5. 3.1.1.5 Assembling EVMs
      2. 3.1.2 Software
        1. 3.1.2.1 Getting Started With Software
          1. 3.1.2.1.1 Build simple_np Application and Flash CC2640R2F
          2. 3.1.2.1.2 Use Premade UniFlash ImageCreator Project
          3. 3.1.2.1.3 Importing Project Source Files Into CCS
        2. 3.1.2.2 User Files
        3. 3.1.2.3 Run Wi-Fi® Doorlock Demo
          1. 3.1.2.3.1 Connect CC3220 to Network
          2. 3.1.2.3.2 Networking Functions
            1. 3.1.2.3.2.1 Get Current Date and Time (SNTP)
            2. 3.1.2.3.2.2 Send and Receive Messages (MQTT)
            3. 3.1.2.3.2.3 Perform Software Update Using Dropbox (OTA Update)
    2. 3.2 Testing and Results
      1. 3.2.1 Pass or Fail Tests
      2. 3.2.2 Power Measurements
      3. 3.2.3 Test Setup
        1. 3.2.3.1 CC3220S
        2. 3.2.3.2 CC2640R2F
        3. 3.2.3.3 DRV8837
      4. 3.2.4 Test Results
      5. 3.2.5 Battery Life Estimate
  8. 4Design Files
  9. 5Software Files
  10. 6Related Documentation
    1. 6.1 Trademarks
  11. 7Terminology
  12. 8About the Author
  13. 9Revision History

MQTT Client Implementation

The TIDC-01005 leverages the MQTT client library from the SimpleLink Wi-Fi CC3220 device SDK, to communicate with the cloud. When building an application based on the MQTT library, two software threads are responsible for implementing the MQTT client functionality: an overall MQTT Thread and an MQTT Client Thread. The overall MQTT Thread configures the parameters of the MQTT connection, establishes the connection with the MQTT broker, spawns the MQTT Client Thread, and then handles all messages received through the MQTT client callbacks. The MQTT Client Thread runs a task that is implemented in the MQTT library and is dedicated to receiving incoming messages from the MQTT connection, then passing the messages to the MQTT client callback.

In the TIDC-01005, the MQTT client task is implemented as a state machine that waits for the system to be connected to a local network and then attempts to connect to an MQTT broker. When the system is connected to the local network and the broker, the MQTT task runs the main loop to handle received messages. The main loop of the MQTT Thread (MQTT Client Connected state) is intended to be customized by the developer, based on the application needs. Figure 2-8 shows a diagram of the MQTT client task state machine.

GUID-BE95502D-9839-48D3-A508-6F6237272CB8-low.gifFigure 2-8 MQTT Thread Main Loop

When the system successfully enters the MQTT Connected state, the MQTT client task in the TIDC-01005 acts as an interface, for the user to access the electronic smart lock through the cloud. In the TIDC-01005, the client task uses multiple MQTT topics and messages to enable remote control of the system.

The messages received by the client are handled according to the decision tree shown in Figure 2-9.

GUID-ED584442-1E3B-47F6-B961-856E11FD7138-low.gifFigure 2-9 MQTT Message Handling