hurocon 0.1.0

Command line interface tool for interacting with Huawei LTE routers

Hurocon

Hurocon (huawei router control) - command line interface tool for interacting with Huawei LTE routers

Features

• Device Control
  • Reboot
• SMS Control
  • Send

Planned:
Device Control - Information/Stats, Signal Level, LED Control;
SMS Control - List, View;
Connection Control - WiFi Settings/Switches, Cellular Settings/Switches;

Supported Devices

Full list of supported devices is available on this link.

Installation

Currently this tool can only be installed with pip on python >= 3.7. You can install it from PyPi:

pip install hurocon

Or directly from this Github repo:

pip install git+https://github.com/maximilionus/hurocon.git

Built executable mode (pyinstaller-based) is planned but no ETA yet

Quickstart

Intro

After successful installation of this tool it can be accessed in shell using the following commands:

$ hurocon
# OR
$ python -m hurocon

You can also view a list of all root commands with:

$ hurocon --help

Each command in this tool has a special --help flag to display detailed information about it

Authentification

First of all, you need to specify the authorization and connection data so that this tool can access the router in the future. You do it in two ways.

• In interactive mode:

  $ hurocon auth login
  

• Manually, by running:

  # Initialize local configuration file
  $ hurocon config init
  
  # Show path to local configuration file
  $ hurocon config path
  

  And then manually editing the json file with any text editor. It has a human-readable structure, so every part of it is exactly what you think it is.

Testing Connection

After auth details successfully specified you can test your connection with router by running

$ hurocon auth test

# Returns
# Success: Successful Authentification
# Failure: Auth failed, reason: "..."

Conclusion

That's it, you're ready to go. And remember - no matter how deep you go, --help flag is always here to help 👍

Special

Big thanks to Adam Schubert for his amazing huawei-lte-api package, that made this whole thing possible.