!!! GETTING STARTED with Cisco IOx

Version 137

    In this documents, it will trying to provide you overall picture in the IOx Community and IOx DevNet site.

     

    If you are trying to develop apps on IOx, you may simply go to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart directly which includes all the details for IOx such as Introduction, Getting Started, Platforms, App Development, SDK, and FAQ for IOx developers.


     

    Cisco IOx Development Guide

     

    Cisco IOx DevNet home page is https://developer.cisco.com/site/iox/. It covers the technical overview of IOx and how to develop applications for IOx. For details, please check the following ones.


    1. Why IOx:

    Please refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=fog

     

    2. What is IOx:

    Please refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=overview.


    3. Get started with application development for IOx:

    Please refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart. It covers all the details for IOx introduction, IOx Quick start, IOx SDK, IOx applications development guide and examples, ioxclient tool, Troubleshooting, FAQ, etc. Please make sure to read all the documents before you start to develop applications for Cisco IOx.

     

    4. IOx application development lifecycle:

    IOx App Dev Lifecycle.png

     

    5. Video of Getting Started with Cisco IOx:

    The video show you how to get started with Cisco IOx. It covers the below topics.

    • how to check IR829 to support IOx,
    • how to install Fog Director and IOx SDK,
    • how to develop and deploy IOx applications with IOx SDK and Fog Director.
    • And Hello World is provided as an example for your reference.

    Please refer to [VIDEO] Getting Started with Cisco IOx for details.

     

    6. IOx 1.1 and 1.2 Downloads:

    Go to https://developer.cisco.com/site/iox/downloads/ or IOx Downloads Links from CCO . It includes all the related links for IOx 1.1/1.2 such as IOS Bundle, IOXVM, Fog Director, ioxclient, IOx SDK, etc. Please notify you need a CCO account to download the related software. If you have no CCO, please send mail to "ivsg-devnet-support@@@cisco.com" and "iox-support@@@cisco.com" for request so that we could provide you a specific space from devnet.

     

     

     

     

    Cisco IOx Nodes

     

    For Cisco IOx Industrial Routers, mainly there are ISR 819(C819), CGR1120/1240, and IR829/809. Here list the main OS and hardware(CPU, Memory, Flash storage) information for them.

    • ISR819(C819) uses a PowerPC processor,
    • CGR1120/1240 use an Intel X86 32bit processor,
    • IR829/809 use an Intel X86 64bit dual-core processor,
    • IE4000 use a PowerPC processor.

    Please see the details from the post of Cisco IOx Nodes (ISR819/CGR1120/1240/IR829/809/IR910) Hardware and Software Specification

    For the detailed Supported Platforms of Cisco IOx, go to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart, and go to “Supported Platforms” on the left panel. Or go to the URL of https://developer.cisco.com/media/iox-dev-guide-3-10-16/platforms/supported-platforms/ directly.

     

     

     

    Cisco IR829/809

     

    1. IR829/809 Hardware Installation Guide:

    Cisco 829 Industrial Integrated Services Routers have a compact form factor, integrated 9-32 VDC power input, and multimode 3G and 4G LTE wireless WAN and WLAN connections. With it, you can rapidly deploy a wide variety of Internet of Things (IoT) solutions, including fleet management, mass transit, and remote asset monitoring. IR829 and IR809 are using the same architecture. The main difference between IR829 and IR809 is the support of WiFi, POE, the number of GE ports, etc. For the Hardware Installation Guide, please refer to Cisco IR829 Industrial Integrated Services Router Hardware Installation Guide - Cisco. For how to connect Console and the DC power, please refer to the below links in Hardware Installation Guide.

    Connecting a Terminal or PC to the Console Port

    Connecting to DC Power

     

    2. IR829/809 IOx Installation and Configuration:

    Before you install or upgrade your bundle image, you need to configure IR829 for network access. For detailed IOx configuration guide, please refer to the post: https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart (Go to Platforms --> IR 8xx Platforms) or IOx Configuration on IR829

    For the image install or upgrade, you may get the new bundle from Cisco Systems CCO IR829 (you need the CCO account to download them.).  Here are the steps for installing IR829 new bundle as an example:

    IR800# copy scp://userid@scpServerIp/ir800-universalk9-bundle.SPA.156-1.T1.bin flash:

    IR800# bundle install flash:ir800-universalk9-bundle.SPA.156-1.T1.bin

    IR800# write memory

    IR800# reload

     

    3. IR829/809 Guest OS Installation and Upgrade

    There is the Guest OS installed by default. You don't need to install a new one. However if you have to install a new one, you may get the new Guest OS image from Cisco Systems CCO IR829 or Cisco Systems CCO IR809 for example and put it to the flash of IR829/809. Here are the steps as an example.

    IR800# copy scp://userid@scpServerIp//ir829/ir800-ioxvm-1.0.0.4-T.bin flash:

    IR800# guest-os 1 stop

    IR800# guest-os 1 image uninstall

    IR800# guest-os 1 image install flash:ir800-ioxvm-1.0.0.4-T.bin verify

    IR800# guest-os 1 start

    It is also possible to install the Guess OS image from the bundle with the option of "exclude HV-IOS". For example: "bundle install flash:ir800-universalk9-bundle.SPA.156-3.M1.bin exclude HV-IOS".

     

    4. IR829/809 IOx PaaS Application Development and Deployment:

    IR829/809 is using a dual-core Intel processor with X86 architecture (64bit). It has 2GB DDR3 memory, and 8GB flash memory (4GB usable). Cisco provides the IOx SDK and IOx Sandbox for application development. IR829/809 IOx and IOx Sandbox support the PaaS and Container Style applications including Java, Python, LXC applications. Please refer to Cisco DevNet IOx Develop Guide for details.

    Cisco provides the IOx Sandbox to simulate the IOx environment if you have no physical IR829, and IOx SDK for IOx application development. Please make sure to use the same version of 1.1.0 for IOx SDK, Fog Director, and IOx Sandbox, or there may be some non-compatibility for some older version.

    Once the applications are development and its packages are created, Cisco provides the IOx Local Manager or Fog Director for applications installation. IOx Local Manager is for the specific IOx node while IOx Fog Director is central management for applications and devices.

    Here are the application development examples for IOx, and it covers all the above details as example:

     

    5. LXC Application Development On IR829/809 IOx:

    Please refer to LXC Applicaton Development on Cisco IR829 IOx.pdf. It needs the new version (1.1 and later) of IOx SDK and IR829 IOx images. And you may refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart (Go to App Development) for PaaS, LXC, and Docker application development as well.

     

    6. Docker Application Development on IR829/809 IOx:

    From the version of IOx 1.2, Cisco IOx supports Docker. Please refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart (Go to the tab of "App Development", and go to "Docker Apps" or "Docker Demo Apps"). Please note it may need to add the TAG for the specific images when you are trying to package docker apps. For details, please refer to ioxclient : error packaging docker style apps when tag is omitted..


    7. IR829/809 Serial Interface Configuration:

    From the version of 15.6, IR829 could support serial interfaces. Please make sure to upgrade your IR829 to version of formal version of 15.5.3M0a first before upgrading it to 15.6. (The early version of 15.5.2 or others could NOT be upgraded to 15.6 directly or there is some issue.)

    The serial interface configuration for IR829/809 is quite similar with CGR1000. For details, please refer to the post of Accessing Serial Interface on IR829 through GOS. Here is an example for RS232 configure the first serial interface of IR829.

    interface Async0

      no ip address

      encapsulation relay-line

    line 1

      transport preferred none

      transport input all

      stopbits 1

      speed 115200

    relay line 1 1/5

    For RS485, you need to set the media-type as rs485 for the SERIAL 0. Please note, the SERIAL 0 supports RS-232 and RS-485 (DCE), and SERIAL 1 supports RS-232 (DTE) only.

    interface Async0

    no ip address

    encapsulation relay-line

    half-duplex

    media-type rs485

     

     

     

    Cisco ISR 819 (C819)

     

    1. C819 IOx Supported Model:

    Only the C819 with 4G supports IOx, and the C819 with WiFi (without 4G) does not support IOx as to the different processor. For the list of all the supported platforms of C819, it is listed in Page 2 of Cisco IOx Local Manager User Guide.pdf in detail.

    C819 is using a PowerPC processor, and all the applications will be running on the PowerPC architecture. The C819 IOx SDK provides all the tool chains for the applications development.

     

    2. C819 IOx Install and Upgrade:

    To install or upgrade C819 IOx version, get the IOx Image from Cisco CCO: Cisco C819 Universal IOx 15.5 or https://software.cisco.com/download/special/release.html?config=5d86ddfef03e0be6da411eb08d75cfd7 (15.6) first. And then put it to C819 IOS through SCP, TFTP, FTP, or HTTP. Here are the steps to boot with the new version of C819 IOx image. How to upgrade the IOS image on C819

    819#copy scp://devnet@10.74.69.101//home/devnet/steve/c800-universalk9_iox-mz.SPA.155-3.M.bin flash:

    819#conf t

    819(config)#boot system flash c800-universalk9_iox-mz.SPA.155-3.M.bin

    819(config)#end

    819#write memory

    819#reload

     

    3. C819 IOx Configuration:

    Go to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=overview and click "ISR 8xx Platforms" of "IOx Enabled Devices (=Platforms)" to see the details.

     

    4. C819 IOx Application Development:

    Use the IOx SDK to generate VM packaged applications. For PaaS style applications, currently C829 IOx only support Python. Java is not supported yet due to the license issue for PowerPC platform. For details, please refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=overview.

    Please make sure to use an English version Chrome instead of non-English version one. Re: localmanager UI not starting, some js not found

     

    5. C819 Modbus RTU Client Application:

    C819 IOx supports Modbus by default. Here is an example to get the temperature from the sensor over serial interface with Modbus standard. It covers all the details for the hardware environment, configuration, sample codes, etc. C819 IOx Modbus RTU Client Application Setup Guide.pdf. And the document also provide how to configure the serial interface for Guest OS accessing (in Chapter 3.2).

    interface Serial0

      physical-layer async

      no ip address

      encapsulation raw-tcp

    !

    line 7

      raw-socket tcp client 192.168.3.2 32000


    6. How to set the static IP address for PaaS/LXC/Docker style applications?

    Please refer to the post of How to set Static IP address to PaaS/LXC.

     

     

     

    Cisco IE4000

     

    1. Cisco IE4000 Hardware Installation Guide:

    Please refer to Cisco IE 4000 Switch Hardware Installation Guide - Cisco

     

    2. Cisco IE4000 IOx support:

    Cisco IE4000 supports IOx now. You may download the related package (such as "IOX COMPUTE PLATFORM FIRMWARE WITH IOS BUNDLE") from CCO. And you may refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart (Go to Platforms --> IE4K Platforms) for how to enable/configure IOx on IE4000.

     

    3. Application Develop on Cisco IE4000 IOx:

    Please refer to https://developer.cisco.com/site/iox/documents/developer-guide/?ref=quickstart (Go to Platforms --> IE4K Platforms for how to enable/configure IOx on IE4000, and go to App Development --> Native Demo Apps --> Build and Install (Select the target machine to build this application for "YOCTO_MACHINE ?= isr4k-qemu") for IE4000 IOx app development).

     

     

     

    Cisco CGR1120/1240

     

    1. CGR1120/1240 IOx FAQs:

    See the post of Frequently Asked Questions (FAQs) for the CGR1120/1240 IOx FAQs. It covers all the general questions for below items.

    Please notify, the CGR1120/1240 is using an Intel processor. All the applications will be running on the X86 architecture (32bit). Cisco does not provide cross-compiling tools for the Yocto Linux environment.  It is a 32-bit x86 Linux with kernel 3.8 and standard libraries. Any 32-bit binary compiled on a similar Linux version should work on Yocto as well (for example, Ubuntu 14.04.1 32bit).  And you may install the applications or packages with RPM in the CGR1120/1240 Guest OS.

     

    2. CGR1120/1240 Connected Grid Solution and Connected Grid Endpoint related:

    Here we list the related topics for CGR and CGE though it is not specific for IOx. Basically CGR1120 is for indoors while CGR1240 is for outdoors. Please refer to Content Migration Guide from CDN Portal to DevNet Communities Portal

     

    3. Migrate CGR from CG-OS to IOx, or Downgrad CGR from IOx to CG-OS:

    You can download the IOx or CG-OS images from Cisco CCO. Cisco CGR IOS or Cisco CGR CG-OS

    For Migrate CGR from CG-OS to IOx: Migrate CGR from CG-OS to IOx

    For Downgrade CGR from IOx to CG-OS: Downgrade from IOx to NXOS(CG-OS)

     

    4. CGR1120/1240 IOx Application Development

    The docucument of CGRAppDeveloperGuide.pdf covers how to develop application for CGR1120/1240. You may aslo refer to CGR1000 IOx Application Development Cook Book.pdf which aslo provides the C/C++, Java, Python, and related samples of Modbus, MQTT, CoAP and other applications for CGR1120/1240 IOx.

     

     

     

    Cisco Fog Director and IOx Local Manager

     

    IOx Local Manager comes once the Cisco IOx device is installed and configured successfully. It only applies for the device itself. For Fog Director, it could manage the IOx applications and many IOx devices including ISR819, IR829/809, etc in the same time, and you need to install it separately in a server.


    1. Fog Director Installation and Configuration:

    Download the OVA version of Fog Director 1.1.0 from Cisco Systems. Please refer to Cisco Fog Director Reference Guide, Release 1.1 - Cisco for how to install, configure and use Fog Director (formerly App Manager).


    2. IOx Local Manager User Guide:

    Please refer to Cisco IOx Local Manager Reference Guide, Release 1.1 - Cisco. It may apply for both IR829 IOx and IOx Sandbox.

    To access the Local Manager of IR829/809 and ISR819, you need to configure  the user in Cisco IOS with "privilege 15". For example, "username cisco privilege 15 password 0 cisco".


    3. Use English version of Chrome to access IOx Local Manager:

    To access the Local Manager of C819 or IR829, the Local Manager UI may not be prompted successfully due to a non-English version of Chrome. Please try to use an English version of Chrome to access Local Manager. You may set Chrome to ENGLISH version as following setting.

    Settings -> Show advanced settings -> Language and inputs settings -> Add English (United States) -> Display Google Chrome in this language

    For details, please refer to: Re: localmanager UI not starting, some js not found.

     

    4. ioxclient:

    ioxclient is a tool for the developer. Please go to "IOxclient Reference" of "Cisco DevNet IOx Develop Guide" for details.

    To access IR829/809 and ISR819, you need to configure  the user in Cisco IOS with "privilege 15". For example, "username cisco privilege 15 password 0 cisco".

     

     

     

    Miscellaneous

     

    1. MQTT and CoAP, IoT Protocols:

    MQTT and CoAP are two of most promising IoT Procotols for small devices. You may refer to the post of MQTT and CoAP, IoT Protocols for more details. And you may build the applications or libraries with the specific tool chain and deploy them in IOx of C819, CGR1120/1240, and IR829/809.

    In document of CGR1000 IOx Application Development Cook Book.pdf, Chapter 3.2.2 and 3.2.3 covers how develop the MQTT applications for CGR1000 IOx. For IR829/809, it is some similar. You may use LXC or Docker container style applications. For details, please refer to  (Go to App Development --> Native Demo Apps or Docker Demo Apps --> C, C++ Simple App).

    For MQTT Broker, you may use mosquitto. For the MQTT client, you may use paho for the client in C, Python, Java, etc. language.

     

    2. Modbus RTU Client applications:

    In the document of C819 IOx Modbus RTU Client Application Setup Guide.pdf, it covers all the details for how to develop Modbus RTU Client applications for C819.

    And in the document of CGR1000 IOx Application Development Cook Book.pdf, Chapter 3.2.1 covers how to develop Modbus RTU Client application for CGR1000.

    For IR829/809, you may use PaaS(Python), LXC, or Docker container style app. For C language, it should be compiled with the X86 64bit gcc with the open source project of "libmodbus". For Python, it needs to add the modules of "pyserial" and "MinimalModbus".

     

    3. Configure SSH in IOS:

    Please refer to the post:  Configure SSH in IOS. For details, please visit Configuring Secure Shell on Routers and Switches Running Cisco IOS - Cisco

    It works for all devices of C819, CGR1120/1240, and IR829/809.


    4. Serial Interfaces for CGR1240 and IR829:

    C819 and CGR1120 are using DB9 serial interfaces. But CGR1240 and IR829 are using RJ45 interface for their serial ports. Please make sure to use the RJ45-to-DB9 serial cable following the EIA-561 standard. The Cisco RJ45-to-DB9 Serial Console Cable does not follow the EIA-561 standard, and is not compatible with CGR1240 and IR829 RJ45 serial ports.

    You may make the adapter of "RJ45 to DB9 Straight Connector" for IR829 by your own with the guide of RJ45_DB9_Assembeling_Guide

    Please notify, for IR829, there are two serial interfaces. The SERIAL 0 supports RS-232 and RS-485 (DCE), and SERIAL 1 supports RS-232 (DTE) only.


    5. Modbus and DNP3 Communication Protocols:

    Modbus and DNP3 are two of most popular communication protocols between components in process automation systems. Please refer to the post of Modbus and DNP3 Communication Protocols for details.