Skip to content
Examples for SDK of Hana
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
AVR
SBC added esp projects Apr 10, 2019
eADC added esp projects Apr 10, 2019
eI2C_a added esp projects Apr 10, 2019
eI2C_p dir reorganized Apr 5, 2019
eICSP/prog.avr misc update Feb 25, 2019
eSPI added nRF82640(BT840) support May 18, 2019
eXB added esp tools Apr 12, 2019
.gitignore ignore *.o for commit Apr 30, 2019
LICENSE Initial commit Feb 2, 2019
Makefile added esp projects Apr 10, 2019
README.md misc update Apr 3, 2019

README.md

HackIoT Hana

About Hana

Hana works as an IoT node in stand-alone mode forwarding data to remote partner device, and paried with a Raspberry Pi like SBC, it becomes IoT gateway device aggregating data from nodes and processing them for various applications.

Demo & Toolkit for SDK

This repository contains the demo projects and toolkit for the SDK of HackIoT Hana.

IMPORTANT: The project code here assumes the target SBC's specific H/W (e.g. RPi + Hana) and S/W environment prepared as docker images, and all the images introduced here are freely available readily to be pulled. (docker pull)

How Folders are Structured

Preparation

Assuming you are on Raspbian:

  1. Update the cmdline.txt and remove 'console=serial0,115200'

    sudo nano /boot/cmdline.txt
    
  2. Update the config.txt.

    sudo nano /boot/config.txt
    

    Copy-paste below at the very bottom (for overriding existing):

    dtparam=spi=on
    dtoverlay=enc28j60
    dtparam=i2c_vc=on
    dtparam=i2c_arm=on
    enable_uart=1
    dtoverlay=pi3-miniuart-bt
    
  3. add the 'i2c-dev' to /etc/modules

    sudo bash -c "echo 'i2c-dev' >> /etc/modules"
    
  4. Install docker and flat running the command:

    curl http://host.wednus.com/getflat | sh
    

    For more information: Getting flat

  5. Reboot

    sudo reboot
    

Getting SDK

This section explains how to obtain SDK with examples within docker container environment that everything is already configured.

For a quick video tutorial, watch Getting SDK for HackIoT Hana.

  1. Install Hana SDK

    1.1. Open docker-compose.yaml file

    nano ~/docker-compose.yaml
    

    1.2. Add the 'hackiot' block below in the 'services' section

    services:
    ...
    
      hackiot:
        container_name: hackiot
        image: wednus/hackiot-hana:sdk
        volumes:
          - /sys:/sys
          - /etc/localtime:/etc/localtime:ro
          - /home/pi/hackiot:/workspace
        devices:
          - /dev/mem
          - /dev/i2c-1
          - /dev/gpiomem
          - /dev/serial0
          - /dev/spidev0.1
        ports:
          - 80:80
        cap_add:
          - sys_rawio
          - sys_ptrace
        restart: always
    
     ...
    

    Note: The image 'wednus/hackiot-hana:sdk' contains SDK & this demo projects as well. For SDK without demos, use 'wednus/hackiot-hana' instead.

    1.3. Create hackiot container

    docker-compose up -d
    

    1.4. Open SDK from web browser

    http://[IP Address]/
    
  2. Check the other tutorials and subscibe for future updates:

    HackIoT Youtube Channel

SDK Updater

  1. In the SDK (cloud9) IDE, open 'RPi/flat.hana_upgrade' sub-project.
  2. Open README.md file and follow the instruction.

Getting Help

Links

Pinout

Pinout Diagram

Known Issues

SDK (web IDE) loading takes too long

One drawback of newer docker engines is they take longer init time. (i.e. 8 ~ 12 minutes w/ RPi0) There is nothing fundamentally we can do until the docker fix this or our SBC get much faster. There are, however, a couple of walkarounds to consider before reboot:

  • For faster IDE start
    • Do not close the SDK IDE browser tab and leave it open until it reconnects itself after reboot.
  • For easier wait
    • Run 'docker ps' command and wait until it returns result. (== ready)

      With this, at least, we get to know when the SDK is ready exactly without keep refreshing the browser tab.

Troubleshoot

During AVR upload

  • [ERROR] avrdude-hackiot: stk500_getparm(): (a) protocol error, expect=0x14, resp=0x00
    • Check /boot/cmdline.txt and make sure the removal of ‘console=serial0,115200’
  • [ERROR] avrdude-hackiot: stk500_getsync() attempt 1 of 10: not in sync: resp=0x00
    • cause: /dev/serial0 is not available
    • Make sure there's no program occupying serial0. (e.g. python scripts)

The Last Resort

If all your troubleshoot effort failed, you may want to start over from reflashing the micro SD card.

You can’t perform that action at this time.