Milli Setup Checklist

For the Milli Developer Kit to function on the network, you must correctly set up the hardware and complete the provisioning process to allow the Milli Shield to communicate with the Iton Starfish network. The following tasks must be performed during to complete setup:

1. Set up the Milli Shield hardware for provisioning and communication with the Arduino board.
2. Power up your Milli Shield.
3. Upgrade firmware to the most recent supported version.
4. Provision your Milli Shield with the network ID and country code.
5. Personalize your Milli Shield with the appropriate performance profile.

Set up the Milli Hardware

To set up the Milli Developer Kit, complete the following: 

1. Stack the Milli Shield from your kit on top of the Arduino board you have chosen to use as an application processor.
2. Set the Mili Shield SW3 switch inwards (toward the middle of the shield). This configures the Milli Shield to use Arduino hardware UART pins 0 and 1.
   
   1. Pin 0 on the Shield transmits to Pin 0 on the Arduino
   2. Pin 1 on the Shield receives from Pin 1 on the Arduino

​

3. Attach the mini antenna to the SMA right-angle connector on the Millishield SMA. 
4.  Connect the Milli Shield to your computer or laptop using the 3-pin USB/TTL console cable. Use the image below for reference. 
   
   1. Connect the 3-pin USB/TTL console cable to the Milli Shield in the following order: 
      
      1. Yellow to TX at the edge of the shield
      2. Orange to RX at the middle of the shield
      3. Black to GND at inside of the shield

   2.  Connect the USB end of the 3-pin USB/TTL console cable to the computer

Power Up the Milli Shield

1. Attach one end of the Micro USB cable to the USB Port of the Adafruit M0 Express board and the other end to your computer.
2. As an alternative, you can attach an external power supply to the Adafruit Metro M0 Express board (using a 2.1mm barrel standard power plug with an allowed voltage range of 7-9 volts).
3. The Adafruit Metro M0 Express board will draw power from the power source (computer or battery or adapter) and provides power to the Milli Shield. 

Milli Firmware Upgrade

1. It is recommended that you upgrade to the latest supported version of Milli firmware to benefit from potential bug fixes or new functionalities. 

2. You can find the latest supported version of Milli firmware in the Document Center. 
3. The steps for upgrading Milli firmware are located on the Firmware Upgrade page.

Provision the Network ID and Country Code

You must perform the provisioning step in order for your Milli to reach the network.

1. The Milli Shield will not communicate with the Itron Starfish network until the Country Code and Network ID have been correctly set and the standard operational firmware image is executing.
2. Milli Developer Kits purchased through the Itron Developer Program are intended for use on the Itron Starfish network and should be provisioned with Network ID 1711 and a Country Code that is appropriate for your country.  
3. Country code and Network ID are set using sysvar values as part of personalizing Milli configuration settings.

Personalization of Milli Configuration Settings

1. Personalization of Milli configuration settings is done via writing a pre-defined set of sysvar values (profile) to the Milli over a serial connection.
2. To personalize your Milli Shield for use on Itron Starfish network it is recommended that you start with the settings from the following profiles:
   • Milli Developer Aggressive MQTT Profile
3. The instructions for personalizing millis are detailed in the Configuration Steps on the Milli Personalization page.

Boot to Operational Firmware Image

If you followed either procedure above to update fimware or set the Milli configuration settings then your Milli Dev Kit is ready to use. However, if you did not do either of those then you will need to set the Milli to the operational firmware image by following the instructions here. 

Next Steps

It is recommended that you proceed next to setting up the Milli Dev Kit Reference Application. This will give you solid foundation and reference source code to modify for your solution.