# Getting started with the Cypress CYW943907AEVAL1F Development Kit
<a name="getting_started_cypress_43"></a>

**Important**  <a name="archive-message"></a>
This is an archived version of the FreeRTOS User Guide for use with FreeRTOS release 202012.00. For the latest version of this document, see the [FreeRTOS User Guide](../../../latest/userguide/index.html).

This tutorial provides instructions for getting started with the Cypress CYW943907AEVAL1F Development Kit. If you do not have the Cypress CYW943907AEVAL1F Development Kit, visit the Amazon Partner Device Catalog to purchase one from our [partner](https://devices.amazonaws.com/detail/a3G0L00000AAPg0UAH/CYW943907AEVAL1F).

**Note**  
This tutorial walks you through setting up and running the coreMQTT Mutual Authentication demo. The FreeRTOS port for this board currently does not support the TCP server and client demos.

Before you begin, you must configure Amazon IoT and your FreeRTOS download to connect your device to the Amazon Cloud. See [First steps](freertos-prereqs.md) for instructions.

**Important**  
In this topic, the path to the FreeRTOS download directory is referred to as `{{freertos}}`.
Space characters in the `{{freertos}}` path can cause build failures. When you clone or copy the repository, make sure the path that you create doesn't contain space characters.
The maximum length of a file path on Microsoft Windows is 260 characters. Long FreeRTOS download directory paths can cause build failures.
As noted in [Downloading FreeRTOS](freertos-prereqs.md#freertos-download), FreeRTOS ports for Cypress are currently only available on [ GitHub](https://github.com/aws/amazon-freertos).

## Overview
<a name="overview-for-cypress-tutorial"></a>

This tutorial contains instructions for the following getting started steps:

1. Installing software on the host machine for developing and debugging embedded applications for your microcontroller board.

1. Cross compiling a FreeRTOS demo application to a binary image.

1. Loading the application binary image to your board, and then running the application.

1. Interacting with the application running on your board across a serial connection, for monitoring and debugging purposes.

## Setting up your development environment
<a name="cypress43-setup-env"></a>

### Download and install the WICED Studio SDK
<a name="cypress43-install-wiced-studio"></a>

In this Getting Started guide, you use the Cypress WICED Studio SDK to program your board with the FreeRTOS demo. Visit the [WICED Software](https://www.cypress.com/products/wiced-software) website to download the WICED Studio SDK from Cypress. You must register for a free Cypress account to download the software. The WICED Studio SDK is compatible with Windows, macOS, and Linux operating systems.

**Note**  
Some operating systems require additional installation steps. Make sure that you read and follow all installation instructions for the operating system and version of WICED Studio that you are installing.

### Set environment variables
<a name="cypress43-environment"></a>

Before you use WICED Studio to program your board, you must create an environment variable for the WICED Studio SDK installation directory. If WICED Studio is running while you create your variables, you need to restart the application after you set your variables.

**Note**  
The WICED Studio installer creates two separate folders named `WICED-Studio-{{m}}.{{n}}` on your machine where `m` and `n` are the major and minor version numbers respectively. This document assumes a folder name of `WICED-Studio-6.2` but be sure to use the correct name for the version that you install. When you define the `WICED_STUDIO_SDK_PATH` environment variable, be sure to specify the full installation path of the WICED Studio SDK, and not the installation path of the WICED Studio IDE. In Windows and macOS, the `WICED-Studio-{{m}}.{{n}}` folder for the SDK is created in the `Documents` folder by default.

**To create the environment variable on Windows**

1. Open **Control Panel**, choose **System**, and then choose **Advanced System Settings**.

1. On the **Advanced** tab, choose **Environment Variables**.

1. Under **User variables**, choose **New**.

1. For **Variable name**, enter **WICED\_STUDIO\_SDK\_PATH**. For **Variable value**, enter the WICED Studio SDK installation directory.

**To create the environment variable on Linux or macOS**

1. Open the `/etc/profile` file on your machine, and add the following to the last line of the file:

   ```
   export WICED_STUDIO_SDK_PATH={{installation-path}}/WICED-Studio-6.2
   ```

1. Restart your machine.

1. Open a terminal and run the following commands:

   ```
   cd {{freertos}}/vendors/cypress/WICED_SDK
   ```

   ```
   perl platform_adjust_make.pl
   ```

   ```
   chmod +x make
   ```

## Establishing a serial connection
<a name="cypress43-serial-connection"></a>

**To establish a serial connection between your host machine and your board**

1. Connect the board to your host computer with a USB Standard-A to Micro-B cable.

1. Identify the USB serial port number for the connection to the board on your host computer.

1. Start a serial terminal and open a connection with the following settings:
   + Baud rate: 115200
   + Data: 8 bit
   + Parity: None
   + Stop bits: 1
   + Flow control: None

For more information about installing a terminal and setting up a serial connection, see [Installing a terminal emulator](gsg-troubleshooting.md#uart-term).

## Build and run the FreeRTOS demo project
<a name="gsg-cypress43-build-and-run-example"></a>

After you set up a serial connection to your board, you can build the FreeRTOS demo project, flash the demo to your board, and then run the demo.

**To build and run the FreeRTOS demo project in WICED Studio**

1. Launch WICED Studio.

1. From the **File** menu, choose **Import**. Expand the `General` folder, choose **Existing Projects into Workspace**, and then choose **Next**.

1. In **Select root directory**, select **Browse...**, navigate to the path `{{freertos}}/projects/cypress/CYW943907AEVAL1F/wicedstudio`, and then select **OK**.

1. Under **Projects**, check the box for just the **aws\_demo** project. Choose **Finish** to import the project. The target project **aws\_demo** should appear in the **Make Target** window.

1. Expand the **WICED Platform** menu and choose **WICED Filters off**.

1. In the **Make Target** window, expand **aws\_demo**, right-click the `demo.aws_demo` file, and then choose **Build Target** to build and download the demo to your board. The demo should run automatically after it is built and downloaded to your board.

### Monitoring MQTT messages on the cloud
<a name="cypress43-monitor-mqtt"></a>

You can use the MQTT client in the Amazon IoT console to monitor the messages that your device sends to the Amazon Cloud.

**To subscribe to the MQTT topic with the Amazon IoT MQTT client**

1. Sign in to the [Amazon IoT console](https://console.amazonaws.cn/iotv2/).

1. In the navigation pane, choose **Test** to open the MQTT client.

1. In **Subscription topic**, enter **{{your-thing-name}}/example/topic**, and then choose **Subscribe to topic**.

## Troubleshooting
<a name="cypress43-troubleshooting"></a>
+ If you are using Windows, you might receive the following error when you build and run the demo project:

  ```
  : recipe for target 'download_dct' failed
  make.exe[1]: *** [download_dct] Error 1
  ```

  To troubleshoot this error, do the following:

  1. Browse to `{{WICED-Studio-SDK-PATH}}\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32` and double-click on `openocd-all-brcm-libftdi.exe`.

  1. Browse to `{{WICED-Studio-SDK-PATH}}\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1` and double-click on `InstallDriver.exe`.
+ If you are using Linux or macOS, you might receive the following error when you build and run the demo project:

  ```
  make[1]: *** [download_dct] Error 127
  ```

  To troubleshoot this error, use the following command to update the libusb-dev package:

  ```
  sudo apt-get install libusb-dev
  ```

For general troubleshooting information about Getting Started with FreeRTOS, see [Troubleshooting getting started](gsg-troubleshooting.md).