General

Browser Support

Signing up as a user

Password Security

Orders

Shipping

Provisioning and Setup

Device Provisioning Processes and States

Firmware

Hardware

Software

Partners

Support

     

     

    General

    What countries are supported?

    The following countries are approved for developer kit use and are supported by the Itron Developer Program:

    Asia Pacific
    Europe & The Middle East
    North America

    Australia

    Singapore

    Albania

    Austria (IoT Router Only)

    Belgium (IoT Router Only)

    Bulgaria (IoT Router Only)

    Croatia (IoT Router Only)

    Cyprus (IoT Router Only)

    Czech Republic (IoT Router Only)

    Denmark

    Estonia

    Finland

    France (IoT Router Only)

    Germany (IoT Router Only)

    Greece (IoT Router Only)

    Hungary

    Iceland

    Ireland

    Italy (IoT Router Only)

    Latvia (IoT Router Only)

    Liechtenstein (IoT Router Only)

    Lithuania (IoT Router Only)

    Luxembourg

    Malta (IoT Router Only)

    Moldova

    Netherlands (IoT Router Only)

    Norway

    Poland (IoT Router Only)

    Portugal

    Romania (IoT Router Only)

    Slovakia (IoT Router Only)

    Slovenia

    Spain (IoT Router Only)

    Sweden

    Switzerland

    Turkey (IoT Router Only)

    United Arab Emirates

    United Kingdom

    United States

    Canada

    Jamaica

     

    Browser Support

    What web browsers does the Dev Portal support?

    The Developer Portal supports

    • Internet Explorer (V11 and above)
    • Firefox (V52 and above)
    • Chrome (V58 and above)
    • Safari (V10.1 and above)

     

    What web browsers does Starfish Studio support?

    Starfish Studio supports

    • Internet Explorer (V11 and above)
    • Firefox (V52 and above)
    • Chrome (V58 and above)
    • Safari (V10.1 and above)

     

    Signing up as a user

    What are the benefits of creating a user account?

    Creating a user account gives you access to the following benefits and features:

    • Purchase Developer Kits
    • Access to our developer support desk
    • Additional resources, reference material and tools
    • Ability to participate in online developer community forums

     

    What are the rules I need to keep in mind while choosing a username?

    While choosing a username, please keep in mind the following rules:

    • Usernames can contain letters (a-z), numbers (0-9), dashes (-), underscores (_), periods (.), and plus sign (+).
    • Usernames must start and end with only alphanumeric characters
    • Usernames must be a minimum of 3 and maximum of 45 characters.
    • Usernames are not case sensitive

     

    Password Security

    What should be the minimum length for my account password?

    Your password should be a minimum of 8 characters in length.

    What are the complexity requirements for my account password?

    Your account password should contain at least one of the following characters:

    • Lowercase letter
    • Uppercase letter
    • Number

    Additionally,

    • Your password should not contain part of your username
    • Your password should not be the same as your last 20 passwords

     

    How can I reset my password?

    Non Itron domain users:

    1. Select Sign-In from https://developer.itron.com
    2. In the lower part of the window select Need Help Signing In then Forgot Password
    3. In the pop-up enter your email address associated with your username and submit
    4. You will receive an email from the OKTA authentication system with a link to reset your password. Select that link and reset.

     

    forgot password

     

    Itron employee domain account users: this is your Itron Domain account so reset your password from the corporate intranet IT service desk

     

    Orders

    How do I place an order?

    Create an account in the DevPortal and authenticate your email. Once authenticated sign in to the DevPortal and select Dev Kits from the top menu. Select one of the Dev Kits from the available catalog and select the "Request To Purchase" button. Fill out the information and you will be approved to order.  Once approved the products found at Dev Kits have an "Add To Cart" button enabled. Select the Dev Kits you would like to purchase and identify the country and network you will deploy them. Once all items have been added to your cart proceed to Checkout. You will be asked for shipping information and payment information to complete the order.

    What methods of payment can I use to place an order?

    You can use Visa, MasterCard, DISCOVER, AMEX, eCHECK or PayPal as the possible payment methods on the Developer Portal.

    How do I request a replacement for a faulty device?

    Go to the Account Overview area Devices and Orders tab. Scroll to the right in the table of devices and select the "RMA" button. Confirm you wish to return the item. An email will be sent to Itron fulfillment to replace the item. 

    How do I return an item or order and get a refund?

    Refunds can be requested up to 30 days after order is received. To request a refund. Submit a support ticket explaining you would like to return items ordered for a refund.

     

    Shipping

    When will I receive my order?

    Shipping typically takes five business days.

    How can I track my order?

    Go to the Account Overview area Devices and Orders tab. Scroll to the right in the table of devices and note the Shipping Company name and the shipment tracking number. Please visit the website of the Shipping Company to track your order directly.

    How do I know if my order has been shipped?

    Go to the Account Overview area Devices and Orders tab. Scroll to the right in the table of devices to check the status of your order. A status of FULFILLMENT_PENDING means it has not been shipped.  Any other status means it has been shipped. 

     

    Provisioning and Setup

    What is the device provisioning process?

    The following steps describe how a device is provisioned:

    1. Fulfillment enters device unique ID (Mac ID for Milli and MiniAP, Serial number for IOT Router) in Developer Portal (status=FULFILLED)
    2. Device is is provisioned to Data Platform with MacID (itronMacAddress), DeviceType (itronNetworkDeviceType) in the users tenantID.  (status=SFDP_CREATED) The following devices are provisioned to the data platform:
      1. Milli Dev Kit
      2. IoT Edge Router
      3. miniAP
    3. Data Platform assigns DeviceID
    4. Device provisioned on the network with deviceID, MacID, tenantID, and device type if the device is a miniAP or Milli Dev Kit (ZTP_PROVISIONED)

    How do I confirm that my device has been properly provisioned on the data platform?

    Go to the My Accounts page -> Devices and Orders tab. If the status of the device you have purchased is ZTP_PROVISIONED and the device is a miniAP or Mill Dev your device is provisioned. For an IoT Edge Router the device status should be SFDP_CREATED.

    How do I confirm that my device has been properly provisioned on the network?

    Go to the My Accounts page -> Devices and Orders tab. If the status of the device you have purchased is ZTP_PROVISIONED and the device is a miniAP or Mill Dev your device is provisioned. For an IoT Edge Router the device status should be SFDP_CREATED.

    How long does it take for the MiniAP to configure itself at first connection?

    The call home process that configures the MiniAP typically takes 20-30 minutes but can take up to 90 minutes.

     

    Device Provisioning and States

    What are the various processes that a device goes through during its life cycle?

    A device available for purchase on the Developer Portal goes through the following processes:

    • ORDER PROVISIONING
    • ORDER FULFILLMENT
    • ORDER DEPROVISIONING

    What are the various states that a device goes through during its life cycle?

    A device available for purchase on the Developer Portal goes through the following states:

    • A device that has a valid Mac address or Serial number must be provisioned in the SFDP. When successfully provisioned, the device shall enter the SFDP_CREATED state.
    • Once the entry is created in SFDP, the device shall undergo ZTP provisioning. Post provisioning it goes to the ZTP_PROVISIONED state.
    • A device that has an entry in SFDP and is also ZTP Provisioned shall transition to FULFILLED state.
    • If the device is ZTP Provisioned, it is deprovisioned and moves to ZTP DEPROVISIONED state.
    • Post ZTP Deprovisionng, the device undergoes SFDP Deprovisioning and goes to SFDP_DEPROVISIONED state.
    • Post SFDP DeProvisioning, the device is deleted from SFDP and goes to SFDP_DELETED state.
    • If device is to be Retired, it goes to RETIRED state.

    What are the error states that a device could reach during its life cycle

    A device could possibly enter the following error states during its life cycle:

    • MISSING_MAC_ID: A new device to be provisioned that does not have a MAC id enters this state.
    • MISSING_TENANT_IN_USER_RECORD: A device who's owner has a missing tenant id enters this state.
    • SFDP_CREATION_FAILED: A device who's provisioning fails in SFDP enters this state.
    • ZTP_PROVISION_FAILED: A device who's ZTP provisioning fails enters this state.
    • ZTP_DELETION_FAILED: A device who's ZTP deprovisioning fails enters this state.
    • SFDP_DELETION_FAILED: A device who's SFDP deprovisioning fails enters this state.

     

    Firmware

    How do I update firmware on the Milli Dev Kit v1.0?

    Refer to this page.

    How do I update firmware on the IOT Edge Router?

    Firmware is updated OTA on the IOT Router using Itron's Network Platform. Please contact your Itron representative for getting a firmware update on your IOT Router platform.

     

    Hardware and Setup

    What physical interfaces are available with the IOT Router?

    The IOT Edge Router has the following physical interfaces Ethernet 10/100, HDMI, and two ports for USB 3.0).

    What to do if I get "Service Unavailable" response from a milli Dev Kit v1.0?

    When you are bringing up a new Dev Kit, it will return "Service Unavailable" until you connect a usb cable to the native usb port (on a Arduino M0 Pro) and either connect a terminal app (on your PC) or open the serial monitor window in the Arduino IDE. Once you do this, you can get to sensor data (via CoAP). Once you see debug output, you can disconnect the usb cable and the HDK continues to work. I have also noticed that the HDK continues to work across power cycles. It appears the first time is critical. Note that you need to do this after the Dev Kit connects to the network.

    The miniAP only comes with 1 antenna. Is it for the NAN or WAN?

    The miniAP ships with a 3G cellular antenna for WAN connectivity. See: https://developer.itron.com/miniap-v1-getting-started-guide.

     

    Software

    How can I get an API key (ClientID and Secret)?

    Your client ID and Secret can be obtained from your the Account Settings tab in the My Account area on the DevPortal. On the Account Settings tab select the "ClientID/Secret" label near the top. Click Create New ClientID/Secret. Record these somewhere safe. You can also download the pair.

    What protocols can I use when integrating a sensor with the Milli Dev Kit?

    You can use CoAP protocol to integrate a sensor with the Milli Dev Kit.

    What protocols can I use with the IOT Router?

    This is a list of common connection protocols supported, however nearly any protocol that can be connected through the interfaces provided with the IOT Edge Router can be used (e.g. USB dongle).

    • IPV4/IPV6
    • RS 232/485
    • BLE, BT4.0
    • 802.11 (800/900MHz, 2.4GHz)
    • 802.15.4 (6LowPan/Zigbee/Thread)
    • Cellular

     

    Partners

    How can I become an Itron partner?

    You can apply to be an Itron Technology Partner by filling out the application form here. To be a Channel Partner, please fill out the application form here.

     

    Support

    How can I get technical support developing my solution?

    You can submit a support ticket once you create an account here in the Developer Portal and login. From the Support Tickets tab of the My Account area or from the Support drop-down navigation menu near the top of the Developer Portal pages select Submit a Ticket. Your ticket will be handled by our Developer Support team. Your ticket will be addressed within one business day with most issues being resolved  within one to three business days.