Follow these steps to get started with Percepio DevAlert on the Cypress PSoC® 64 Standard Secure–AWS Wi-Fi BT Pioneer Kit.

  1. Apply for the DevAlert evaluation package. After approval, you will receive an evaluation package valid for 90 days. This includes evaluation access to the DevAlert cloud service and the Tracealyzer desktop software with DevAlert integration. You can expect a reply within one business day, but you can proceed with steps 2-6 while waiting for the eval package.
  2. Get the DevAlert demo project for PSoC 64 from https://github.com/percepio/DevAlert. This project is based on the original Cypress PSoC 64/AWS demo project, with minor modifications for the DevAlert support. Instructions are found in the readme file.
  3. Configure the board and software for AWS connectivity by following the original getting started guide. Make sure to import the DevAlert demo project from step 2 instead of the original demo project. You should see a “DFM” folder under “aws_demos” in ModusToolbox.
  4. Start a terminal application and connect to the right COM port. It is usually the last COM port in the list. If you are using Windows, TeraTerm is a nice and reliable tool.
  5. Program the board and start it up. Make sure it gets an IP address and that no errors show up in the terminal.
  6. When you see the message “[iot_thread] Press BTN0 or swipe left to generate Alerts.”, DevAlert is operational on the device side. If you push BTN0, you should see a message in the terminal about the simulated error. However, since DevAlert is not yet configured in your AWS account, nothing else happens at this point. Note that the alerts are not visible in the normal MQTT message flow, since DevAlert uses AWS IoT Basic Ingest.
  7. After having received the DevAlert evaluation package:
    • Follow the instructions for setting up DevAlert in your AWS account.
    • Install the provided version of Percepio Tracealyzer on your development computer, launch it and enter the provided license key.
    • Follow the DevAlert Connection wizard in Tracealyzer to install the setting files. The wizard is accessible from the initial welcome screen.
  8. The DevAlert Dashboard should now appear on the Tracealyzer welcome screen.
  9. Generate an alert on the PSoC 64 board by pressing the CapSense button BTN0, found in the lower right corner. Check the terminal to ensure that the board has reacted. This button generates three types of simulated errors in sequence, so push it multiple times for different issues. Some issues will intentionally reset the device and upload the alert after restart.
  10. After about 10 seconds, alerts should appear in the DevAlert Dashboard on the Tracealyzer welcome screen.
  11. Click the links in the dashboard to view the traces in Tracealyzer. This will load the most recent trace for the selected issue. You may also see all individual alerts by selecting Cloud -> AWS -> AWS Dashboard.
  12. In Tracealyzer, scroll down to the end of the trace, where the alert was generated. Here you can see the software events that preceded the problem, where the cause is most likely found. You may need to zoom in to see all events.

To learn more about how to use DevAlert in practice, see the DevAlert Developer Quickstart.

Note that a web version of the DevAlert Dashboard is under development and will be available by the end of 2020 or early 2021.

Please contact support@percepio.com if you have any questions or issues getting started.