README.md

Installation and Configuration

Installation

Installing required Dependencies

• python3

Dependencies

Ubuntu

sudo apt install build-essential libpython3-dev libdbus-1-dev

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0

sudo apt install libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev python3-venv

Arch

sudo pacman -S python-gobject gtk3

sudo pacman -S python cairo pkgconf gobject-introspection gtk3

Build and install

Clone the repository

git clone https://github.com/smswithoutborders/SMSWithoutBorders-Gateway-Client.git

cd SMSWithoutBorders-Gateway-Client

Create your config files

make

Install more dependencies

make install

Configuration

Your clusters require a server to communicate with, and you will need to point to this in your configuration files.

• Edit .configs/config.ini ref:link to example config file

• Follow these steps in order to get your Auth ID and Auth key

[OPENAPI]
API_ID=<insert your server username here (same as an Afkanerd developer Auth ID)>
API_KEY=<insert your server password here (same as an Afkanerd develper Auth Key)>

• Be sure to set your connection URL to point to the RabbitMQ server.

CONNECTION_URL=developers.smswithoutborders.com

Running as system service

Linux

make start

• To auto start on bootup

make enable

To view all running logs

tail -f src/services/logs/service.log

Running manually

Linux

• To run the outgoing (send out SMS messages)
  • Plug in your USB modem
  • Activate your virtual environment

  source venv/bin/activate

  • For outgoing OpenAPI messages:

  python3 src/main.py --log=DEBUG --module=outbound

  • To run the incoming (receive and process incoming messages)

  python3 src/main.py --log=DEBUG --module=inbound

Logs -

systemd

Inbound

journalctl -af -u swob_inbound.service

Outbound

journalctl -af -u swob_outbound.service

Sending out SMS messages Using OpenAPI

With OpenAPI, you can send out single and bulk SMS messages through the Gateway Client. After the gateway client as a system service or manually, you are good to start sending out SMS messages.

Setting up on Raspberry pi (tested on 4B)

Ubuntu Server

Refs

https://ubuntu.com/tutorials/how-to-install-ubuntu-on-your-raspberry-pi#4-boot-ubuntu-server
https://itsfoss.com/connect-wifi-terminal-ubuntu/