Milli Developer Kit Setup and Provisioning Instructions

Build Your Own Network of Sensors. Order a Developer Kit
In order for the kit to communicate with the network, you must have a properly installed kit that has been provisioned with the network.

Milli Setup Checklist

For the 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 on the network. The following tasks must be performed during initial 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 hardware, 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

If this switch is not set correctly, you will not receive CoAP responses from the connected Arduino board. 


  1. Attach the mini antenna to the SMA right-angle connector on the Millishield SMA. 
  2.  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 Native Port of the Arduino board and the other end to your computer. 
  2. As an alternative, you can use the micro USB cable to connect the Arduino board to an AC-to-DC adapter or battery (using a 2.1mm barrel standard power plug with an allowed voltage range of 5-20 volts).
  3. The Arduino board will draw power from the power source (computer or battery or adapter) and provide 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. 
If you received your Milli Dev Kit before March 1, 2019 it is necessary that you upgrade your Milli firmware to the latest supported version.
  1. You can find the latest supported version of Milli firmware in the Document Center. 
  2. 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 Stage network until the Country Code and Network ID have been correctly set and the standard operational firmware image is executing.
  2. Developer kits purchased through the Itron Developer Program are intended for use on the Itron Stage 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 Stage network it is recommended that you start with the settings from the following profiles:
  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.