Skip to content

Latest commit

 

History

History
285 lines (234 loc) · 7.72 KB

README.md

File metadata and controls

285 lines (234 loc) · 7.72 KB
Raw

Temi-ROS

Project Web & System Monitor

Environment & Tools

  • Ubuntu 18.04
    • MQTT Broker
    • Redis DB Server
    • Redis Web GUI Console
    • NodeJS
    • Python
      • Sub MQTT & Write Data into Redis DB
  • Temi Robot
    • Java
      • MQTT Client

Installation

Ubuntu

  • MQTT

    • Broker 
      $ sudo apt update -y && sudo apt install -y mosquitto
      • Enable Service 
        $ sudo systemctl enable mosquitto
    • Client 
      $ sudo apt update -y && sudo apt install -y mosquitto-clients

  • Redis

    $ sudo apt update -y && sudo apt install redis-server -y
    • Enable Service 
      $ sudo systemctl enable redis-server.service
    • Config 
      $ sudo vim /etc/redis/redis.conf
      bind 0.0.0.0
# port (default 6379)
# requirepass <password>
stop-writes-on-bgsave-error no

  • NodeJS

    • Node & NPM 
      $ sudo apt update -y && sudo apt install nodejs -y

  • Python

    • Python v2.7 
      $ sudo apt install python -y
    • Python v3.6+
      • MQTT Client 
        $ pip3 install paho-mqtt
      • redis 
        $ pip3 install redis

Connect to Temi

  • Install Android Studio

  • Install ADB (Android Debug Bridge)

    • Windows
      1. Download SDK Platform-Tools
    • MacOS
      • Via Homebrew
        1. Make sure brew is installed
        2. $ brew cask install android-platform-tools
      • Mannual
        1. (Optional) If installed before, run this command $ rm -rf ~/.android-sdk-macosx/ to delete previous document
        2. Download SDK Platform-Tools https://developer.android.com/studio/releases/platform-tools
        3. Add environment variables
        $ echo 'export PATH=$PATH:~/.android-sdk-macosx/platform-tools/' >> ~/.bash_profile
$ echo 'export PATH="$PATH:<PWD>/platform-tools"' >> ~/.zshrc

# ex.
$ echo 'export PATH="$PATH:$HOME/development/platform-tools"' >> ~/.zshrc
        or change .bash_profile to the active shell config such as zsh config .zshrc 4. Source the rc file 
        $ source ~/.zshrc

  • Open Temi ADB Connection Port

    Settings -> temi Developer Tools -> ADB Port Opening

  • Connect

    # Default Port : 5555
$ adb connect ip:port

$ adb devices # check connection

$ adb logcat | grep D\ <TAG>

$ adb shell

$ adb disconnect

APIs

Database - RedisDB

  • Table [0] : Robot Utils & Status

    • Key : S/N
      • Value : Data JSON Format
    S/N Status Time MAC_Addr SSID IP Addr RSSI Battery_Info Charging_Status
    Boolean

  • Table [1] : Robot Status Log

    • Key : S/N
      • Field : Date, Time
        • Value : Data JSON Format

  • Table [2] : 櫃位引導(Brand Guide)

    Brand_ID Brand_Name Brand_URL Brand_Logo Brand_Description Brand_Location Ask_Counter
    URL

  • Table [3] : 活動列表(Activity List)

    Time Activity_Name Provider_ID ProviderName DM_Sources TTL
    List

  • Table [4] : Coupon List

    Time Coupon_Number Amount TTL

  • Table [5] : User Data

    UserID UserName UserPhone UserMail

Andriod (On Temi)

  • IDE : Android Studio (v4.0)
  • Language : Java
  • System Target : Android Version 6 Marshmallow (API 23)
  • Screen Spec : 10.1" inches, 1920x1200(px), 224dpi >> Officail Web Spec

How to send data periodly ?

// Make app running specified function in a period
// https://www.itread01.com/p/1358274.html

final int time = 1000  ; // set period time (ms)
final Handler handler = new Handler();
Runnable runnable = new Runnable(){
    @Override
    public void run() {
        // Add function(s) or something eles here

        handler.postDelayed(this, time);// time ms後執行this,即runable
    }
};
handler.postDelayed(runnable, time);// 開啟定時器,time ms後執行runnable操作

Getting Temi Util Info

  • Serial Number
  • Current Time
  • MAC Address
  • IP Address
  • SSID
  • RSSI (Connection Strength)
  • Memory
    • System Memory
      • totalMem
      • availMem
      • usedMem = totalMem - availMem
    • Runtime Memory
      • maxMemory
      • totalMemory
      • freeMemory
      • usedMemory = totalMemory - freeMemory
  • Battery
    • BatteryLevel
    • isCharging

Push the message to MQTT Server

public static void publishUtilTOMqtt(String content){ // Void function without return value (ex. string, int ...

        String broker = "tcp://ip:1883";
        String clientId = "Temi";
        MemoryPersistence persistence = new MemoryPersistence();
        String topic = "test/sub_topic"; // or "test/+" to subscribe the sub topic

        // Setting mqtt connection quaility
        // https://swf.com.tw/?p=1015
        int qos = 0;

        Log.d(TAG, "message: " + content);

        try {
            MqttClient sampleClient = new MqttClient(broker, clientId, persistence);
            MqttConnectOptions connOpts = new MqttConnectOptions();
            connOpts.setCleanSession(true);
            //Log.d(TAG, "Connecting to broker: " + broker);
            sampleClient.connect(connOpts);
            Log.d(TAG, "Connected");
            //Log.d(TAG, "Publishing message: " + content);
            MqttMessage message = new MqttMessage(content.getBytes());
            message.setQos(qos);
            sampleClient.publish(topic, message);
            Log.d(TAG, "Message published");
            sampleClient.disconnect();
            //Log.d(TAG, "Disconnected");
            //System.exit(0);
        } catch (MqttException me) {
            Log.e(TAG, String.valueOf(me));
            Log.d(TAG, "reason: " + me.getReasonCode());
            Log.d(TAG, "msg: " + me.getMessage());
            Log.d(TAG, "loc: " + me.getLocalizedMessage());
            Log.d(TAG, "cause: " + me.getCause());
            Log.d(TAG, "excep " + me);
            me.printStackTrace();
        }
    }

Python + MQTT + Redis

  • Connect to MQTT Server & Subcribe to Topic
  • Connect to Redis & I/O Data

Python + Redis >> Redis Admin Manage Webpage

Backend Server & Frontend

  • NodeJS
    • Install Node & NPM(Node Package Manager)

Realtime System Monitor

  • Connect to MQTT Server
  • Subscribe to Topic
  • Start a socket to communicate between server (backend) & webpage (frontend)

Domain Name

  • Apply from NCTU free domain : https://nctu.me/
    • No longer support !! (from 2020/10)

Ref

[1] https://oranwind.org/-edge-zai-ubuntu-an-zhuang-mosquitto-mqtt-broker-part-2/
[2] https://www.digitalocean.com/community/tutorials/how-to-install-and-secure-redis-on-ubuntu-20-04
[3] https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-20-04