Milli Developer Kit and Provisioning Setup 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 Millishield to communicate on the network. The following tasks must be performed during initial setup: 

  1. Set up the Millishield hardware for provisioning and communication with the Arduino board.
  2. Power up your Millishield.
  3. Provision your Millishield with the network ID and country code.
  4. Upgrade firmware to the most recent supported version.

 

Set up the Milli Hardware

To set up the Milli hardware, complete the following: 

  1. Stack the Millishield from your kit on top of the Arduino board you have chosen to use as an application processor.
  2. Set the Milishield SW3 switch inwards (toward the middle of the shield). This configures the Millishield 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 Millishield 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 Millishield 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 Millishield

Attach one end of the Micro USB cable to the Native Port of the Arduino board and the other end to your computer. 

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).

The Arduino board will draw power from the power source (computer or battery or adapter) and provide power to the Milli Shield. 

 

Provision the Network ID and Country Code

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

With your Millishield connected to a computer, you can perform the necessary configuration and provisioning. The Millishield will not communicate with the network until the Country Code and Network ID have been set and the standard operational firmware image is executing. To set the Network ID and Country Code, launch and follow the instructions as described in the application: Milli Provisioning App

When the application opens, you will be directed to select your country code.

The Milli Provisioning App interrogates all available COM ports and identifies the ones that appear to be connected to a Milli. If a number of COM ports are connected, it may take a long time to examine each port. Please be prepared to wait. 

Mac users need to enable access to serial port(over USB) by executing the following commands from a terminal:

  • # sudo mkdir /var/lock
  • # sudo chmod a+rw /var/lock

 

The FTDI USB Driver may need to be installed prior to execution.

Developer kits purchased through the Itron Developer Program are provisioned on the Itron Stage network and should be provisioned with Network ID 1711.

 

Country Codes

Use the Country Code in the CC column from the following table. These are based on the ISO Country Codes.

 NAN1 BAND 
 CC* 
 HW 
 FREQUENCY BAND (MHz)
 COUNTRIES
 AUS
36
2
 915-928
Australia
 USA
840
1
 902-928
Canada, Jamaica, United States
 EU873 
826
3
 870-873
Estonia, Finland, GBR, Hungary, Iceland, Ireland, Luxembourg, Portugal, Sweden, Switzerland, United Kingdom
 EU876 
208
3
 870-875.6
Albania, Denmark, Moldova, Norway, Slovenia
 SGP
702
2
 920-925
Singapore

* The CC is the "country code" that will be used to configure the device for the proper country frequency band.

 

Milli Firmware Upgrade

If you received your Milli Dev Kit before March 1, 2019 it is recommended that you upgrade to the latest release of Milli firmware found in Document Center. If you received the Dev Kit after March 1, 2019, the dev kit was preloaded with firmware and there should be no need to update.

Once you have provisioned the Network ID and Country Code you can upgrade the firmware for the Millishield to the most recently posted version.  The steps for that are located here: Firmware Upgrade.

 

Milli Configuration Settings Personalization

If you received your Milli Dev Kit before March 1, 2019, it is recommended that you update the configuration to the recommended settings for responsive performance and the use of  MQTT.  If you received the Dev Kit after March 1, 2019, there should be no need to update the configuration settings.

To update the configuration it is recommended to use the settings from the Leaf Node Aggressive (Dev Kit) MQTT Ref App or Leaf Node Aggressive (Dev Kit) MQTT Ref App EU profiles and update it per the Milli personalization instuctions.

 

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 setup the Milli Dev Kit Reference Application. This will give you solid foundation and reference source code to modify for your solution.