Setup
Please check the First Boot Guide if you setup the eManager for the first time.
Apps
Due to space constraints, Apps are only available for eManager-Pro.
The eManager Pro provides three IoT Stacks (ChirpStack, TICK, and MING) based on Docker containers via Docker Compose that can be managed using Webadmin. Once you log in, the Apps
section will appear, as shown below.
If you do not know the IP of your device, you can access Webadmin as it is explained here.
Please, do not modify the provided stacks. If those stacks does not suit your needs we recommend you to create your own stack using Docker.
Node-RED app is already installed in your eManager natively so, it is not dockerized.
For each stack you have three different actions:
- Start/Install (Play button): If the stack is already installed, pressing the play button will start the stack. Otherwise, first it will install it and then it will be started. The first time you start a stack, the eManager Pro will try to download and install the corresponding docker images. Make sure the eManager has stable Internet connection. It may take several minutes.
- Stop (Stop button): If the stack is started, once you press the stop button it will be stopped.
- Remove (Trash button): This will remove the installation of the selected stack for your eManager-Pro.
ChirpStack
This stack includes the following services:
Service | Port |
---|---|
chirpstack |
58080 |
chirpstack-gateway-bridge |
1700 (UDP) |
chirpstack-gateway-bridge-basicstation |
3001 |
chirpstack-rest-api |
8090 |
chirpstack_postgres |
- |
chirpstack_redis |
- |
chirpstack_mosquitto |
1883 |
TICK Stack
This stack includes the following services:
Service | Port |
---|---|
tickstack_influxdb |
8086 / 8082 / 8089 (UDP) |
tickstack_telegraf |
- |
tickstack_kapacitor |
9092 |
tickstack_chronograf |
8888 |
MING Stack
This stack includes the following services:
Service | Port |
---|---|
ming_mqtt |
51883 (MQTT) / 59001 (HTTP-WebSocket) |
ming_influxdb |
58086 |
ming_grafana |
3000 |
Network settings
Ethernet, WiFi and Modem configurations can be modified using Webadmin. First you need to log in and then click Network
section. You will see different sections to configure each network interface.
If you do not know the IP of your device, you can access Webadmin as it is explained here.
Ethernet
Ethernet can be configured as
- DHCP: eManager IP address is assigned by an external DHCP server.
- Static: choose a fixed IP address in network segment.
- Shared: eManager acts as a router and is able to assign IP addresses to other devices connected to the Ethernet port.
By default, it is configured as DHCP.
WiFi
WiFi can be configured as Access Point (DHCP or Static) or Station Mode. By default, it is configured as Access Point.
Modem
The SIM modem can be configured in the third tab under the Network
section. The APN field is mandatory and the other parameters can be skipped depending on your SIM contract. By default this interface is disabled.
IP Forwarding/Metrics network tools
The Tools
tab under the Network
section provides some elementary tooling to deal with routing/metrics.
Network priority
By default, the eManager will only try to reach Internet via the top-most available interface.
Not completely adaptative
The eManager will only utilize a secondary interface if the top-most interface connection is broken, meaning either the interface is already disabled or there is no Ethernet/WiFi router available. See the connectivity check switch for a possible solution.
Under the hood, this is achieved by assigning static metrics to each interface accordingly.
As an example, let's consider the configuration above.
- If an Ethernet cable is connected between a router and the eManager, it will use Ethernet connection for every Internet connection. If the router stops being able to reach the Internet, the eManager won't be able to access Internet even if Modem o WiFi interfaces provide Internet.
- In this example, the eManager will only use the Modem interface to reach the Internet if no Ethernet cable is connected and the Modem is UP.
Connectivity check
Tip
Enable this switch when relying on secondary interfaces for emergency Internet access.
This switch allows the eManager to dynamically assign metrics to interfaces, so that if there is no ping to Internet via the top-most interface, the next available interface is used instead.
IP forwarding
Security issues
When this switch is enabled, if Ethernet is in Shared mode, or if WiFi is in hotspot mode, the eManager will act as an Internet router. For legal reasons, ensure that no external undesired users can access the eManager Ethernet port or WiFi hotspot. This could be economically harmful when using a SIM card as an Internet source, as malicious users could increase data usage and bills.
This switch enables IP forwarding.
This can be handy in some situations. For example, when enabled, the eManager will forward IP traffic from the Ethernet interface to the WiFi Access Point.
Please reboot the eManager for changes on the IP forwarding switch to take effect.
RS232/RS485 configuration
Serial ports communication can be achieved through the following devices
- RS485: /dev/ttymxc4.
- RS232: /dev/ttymxc5.
Leds configuration
You have two RGB LEDs available so you can configure according to your needs. They are mapped in the /sys/class/leds/
directory.
Timezones configuration
You can check available commands related with timezones configuration here.
Flash partition safe to system updates
Only available in eManager Pro.
To protect the data against system updates and prevent accidental loss, a 5GB /data
partition has been reserved. Therefore, the permanent data we want to keep should go in this partition.
Factory reset
You can perform a factory reset in your eManager device by pressing the reset button. The factory reset implemented are the following:
- Soft reset: The reset button needs to be pressed at least during 3 seconds. It sets all network configurations (Ethernet, Wi-Fi, mDNS, NTP, etc.) by the ones defined by default and it restores user credentials.