README.md

   1
   2 1. suanzi-support: a MQTT client, is a daemon running on remote embedded devices for remote debugging through ssh
   3 2. sztool : a local tool, help to get the forwarding port to be used to connect to remote device
   4
   5 ## Install
   6 - On embedded device
   7     - run `./add-user.sh` to create a user, used for remote ssh, named debug, and its password is suanzikeji
   8     - run `./install.sh` to install the daemon and service file
   9
  10 ## Usage
  11 To connect to remote embedded device, your should know the device's MAC address.
  12
  13 1. run `./sztool -i 2acdeb93b285`
  14
  15 where `2acdeb93b285` is the MAC address of rpdzkj board, which you want to
  16 connect.
  17
  18 2. If it succeed, it will return the forwarding port on `autossh.suanzi.ai`
  19
  20 here is a sample
  21 ```
  22 debian@[~/project/remote-ssh]>> ./sztool -i 2acdeb93b285
  23 Connected with result code 0
  24 2acdeb93b285-response 32171
  25 port is 32171
  26 run ssh debug@autossh.suanzi.ai -p 32171 to connect to  2acdeb93b285 device
  27 ```
  28
  29 3. run `ssh debug@autossh.suanzi.ai -p 32171`, then you can ssh to remote
  30    device. The password is 'suanzikeji', create in file `add-user.sh`
  31
  32
  33 ## Note
  34 - After the port is generated, the ssh session alive time is 5 min (defined by ALIVE_TIME in suanzi-support).
  35 It means after you get the forwarding port, but not run ssh to connect in 5 minutes. this ssh session will terminate.