github.com/waziup/wazigate-system
The list of APIs can be found here: https://waziup.github.io/wazigate-system/
Source code documentation: https://pkg.go.dev/github.com/Waziup/wazigate-system
Wazigate system composed of two main modules: APIs and Controllers.
/api/routers.go defines the API routes and the functions to be called for each of them.
For a better organization we group the related functions in relevant files which are listed below:
This component takes care of all docker related APIs. Listed below:
/docker/docker/:cId/docker/:cId/:action/docker/:cId/:action/docker/:cId/logs/docker/:cId/logs/:tailTo serve these APIs we are required to communicate the docker service running on the host.
Therefore, we have to either call docker APIs on its socket mapped to a file on the guest (wazigate-system) container or run docker shell commands on the host directly. In the current version of the code we call execOnHost(cmd) function which executes a given command on the host and returns the result.
all the code is stored in /api/docker.go file.
This component takes care of all time and timezone related APIs. Listed below:
/time/timezones/timezone/auto/timezone/timezone/timezoneThe code is stored in /api/time.go.
/usage API is part of /api/health.go and provides the CPU, RAM and Storage (e.g. Disk) usage.
This component serves all network related APIs, they listed below and all stored in /api/network.go:
/net/net/wifi/internet/net/wifi/scanning/net/wifi/ap/net/wifi/mode/apTo serve these APIs we use shell commands and tools such as nmcli, ipandiw. In order to switch to Access point mode, we run a the text-ui, stored in /var/lib/wazigate/tools/text-ui.sh, on the host. This script uses cmds like: nmcli c up $(nmcli -f NAME,UUID -p c | grep WAZIGATE-AP | sed 's/WAZIGATE-AP//' | xargs)`.
In order to connect to a WiFi router, just use the text-UI, displayed on startup, after boot.
System operations are stored in /api/system.go they cover the following APIs and some other functions:
/blackout/conf/shutdown/rebootNote: the /blackout API handler is stored in /api/blackout.go
/oled API is to write a message on the OLED display and it is stored in /api/oled.go file.
Read and Write into the configuration can be done through calling /conf API which is stored in /api/system.go.
A Controller refers to a piece of code usually running within a GoRoutine and takes care of a specific task. The controllers that we currently have in wazigate-system are listed below:
LEDsTimezoneBlackoutNetworkButtonsOLED DisplayFanThis controller is initiated by calling LEDsLoop() function and constantly checks the status of the Gateway and updates the LEDs accordingly on the new WaziHat that we just produced. The full behavior of the LED indicators are explained at the end of this document. The code is stored in /api/leds.go.
It is initiated via calling TimezoneInit().
The code is stored in /api/time.go.
This controller is initiated via calling BlackoutLoop() and it constantly checks if a blackout has occurred and if so, it initiates a quick shutdown. Obviously, if the WaziHat does not have a blackout protection circuit, this controller exists.
The code is stored in /api/blackout.go.
Network controller is initiated via calling NetworkLoop(). Its main objective is to keep the WiFi connection stable. It checks the WiFi connectivity periodically and takes proper action if the state changes.
In order to avoid conflict with /net/* API set, we use a Mutex Lock on the operation.
The code is stored in /api/network.go.
On WaziHATs we have two buttons for power and WiFi control. The controller for these buttons is initiated by calling ButtonsLoop(). It runs two GoRoutines, one per button, and trigger proper action once the user pushes the buttons.
The code is stored in /api/buttons.go.
OLED Display controller is initiated by calling OledLoop(). It checks the status of the gateway and shows it on the display. It collects docker container status, internet connectivity, WiFi and Ethernet status and shows messages on reboot and shutdown. It also receives custom messages from the API.
The code is stored in /api/oled.go.
Fan controller is designed to keep the gateway cooled down in case its temperature goes beyond a specific threshold. It is initiated by calling FanLoop(). Obviously, user can determines the threshold in the dashboard and it is saved in the config file.
It uses vcgencmd tool to get the temperature of the CPU.
The code is stored in /api/fan.go.
The recent version of WaziGate has two status LEDs on board and wazigate-system indicates the connectivity status via those LEDs.
LED 1 indicates the status of Internet connectivity and has two states:
_______________________________.............LED 2 indicates the WiFi status and it has 3 states:
__ __ __ __ _________________________________. . . . . . . . . . . . ..............FAQs
Unknown package
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.
Security News
Research
Socket researchers found a malicious Maven package impersonating the legitimate ‘XZ for Java’ library, introducing a backdoor for remote code execution.