Jump to main content

# 1.1.4 PIC32MX Ethernet Starter Kit II: Building and Running the UDP Bootloader Applications

## Downloading and Building the Application

To clone or download this application from Github, go to the main page of this repository and then click Clone button to clone this repo or download as zip file. This content can also be download using content manager by following these instructions.

Path of the application within the repository is apps/udp_bootloader/.

To build the application, refer to the following table and open the project using its IDE.

### Bootloader Application

Project Name | Description
--- | ---
bootloader/firmware/pic32mx_eth_sk2.X | MPLAB X Project for PIC32MX Ethernet Starter Kit II

### Test Application

Project Name | Description
--- | ---
test_app/firmware/pic32mx_eth_sk2.X | MPLAB X Project for PIC32MX Ethernet Starter Kit II

## Setting Up PIC32MX Ethernet Starter Kit II

- Mount PIC32MX Ethernet Starter Kit II on the J1 connector of Starter Kit I/O Expansion Board
- Connect TX pin of USB UART Click to U2RX pin of J11 header on Starter Kit I/O Expansion Board
- Connect RX pin of USB UART Click to U2TX pin of J11 header on Starter Kit I/O Expansion Board
- Connect GND pin of USB UART Click to GND pin of J11 header on Starter Kit I/O Expansion Board
- Connect mini USB cable to the USB UART Click. This will enumerate the USB to UART port.
- For programming, connect mini USB cable to the Debug USB connector (J7) on the PIC32MX Ethernet Starter Kit II to the computer
- Establish a connection between Host PC and the device through the RJ45 Ethernet connector on the LAN8740 PHY daughter board using an Ethernet cable

## Running the Application

1. Open the test application project test_app/firmware/pic32mx_eth_sk2.X in the IDE.
2. Build the project to generate the binary (Do not program the binary).
3. Open the bootloader project bootloader/firmware/pic32mx_eth_sk2.X in the IDE.
4. Build and program the application using the IDE.
5. LED1 will be turned on once programming is completed and bootloader starts running.
6. Open the Terminal application (e.g., Tera Term) on the computer to get test application messages through UART once bootloaded.
7. Configure the serial port settings as follows:
   - Baud: 115200
   - Data: 8 Bits
   - Parity: None
   - Stop: 1 Bit
   - Flow Control: None
8. Configure the Host PC for setting up IP Address to communicate with the device.
   - Go to Control Panel/Network and Internet/Network Connections
   - Open Ethernet Properties
   - Double click the Internet Protocol Version 4 (TCP/IPv4)
   - Configure the IP Address as shown below:
     - IP address: 192.168.1.12
     - Subnet mask: 255.255.255.0
9. Launch the Unified Host application from below path:
   - <harmony3_path>/bootloader/tools/UnifiedHost-*/UnifiedHost-*.jar
10. Configure the Unified host application.
    - Select the Device Architecture and Protocol as shown below
    - Click the Configure button to configure UDP Port Number and IP Address
    - Load the test application hex file to be programmed using below option
      - <harmony3_path>/bootloader_apps_ethernet/apps/udp_bootloader/test_app/firmware/pic32mx_eth_sk2.X/dist/pic32mx_eth_sk2/production/pic32mx_eth_sk2.X.production.hex
    - Open the Console window of the host application to view application bootloading sequence
11. Click the Program Device button to program the loaded test application hex file on to the device.
12. Following figure shows output of successfully programming the test application.
13. If above step is successful then LED3 should start blinking and the user should see below output on the console.
14. Press and hold the Switch SW1 to trigger Bootloader from test application and the user should see below output.
15. Repeat Steps 11-13 once and jump to Step 16.
    - This step is to verify that bootloader is running after triggering bootloader from test application in Step 14
16. Press and hold the Switch SW1 and then Power cycle the device to force trigger bootloader at startup.
17. Repeat Steps 11-13 once.
    - This step is to verify whether bootloader is triggered by switch press at reset

## Additional Steps (Optional)

- To bootload any other application refer to the Application Configurations
- Once done, repeat the applicable steps mentioned in Running the Application

Rev: D