Skip to content

Latest commit

 

History

History
43 lines (28 loc) · 2.05 KB

README.node_inbound.md

File metadata and controls

43 lines (28 loc) · 2.05 KB

Gateway Client Incoming Module

  • Gateway clients receive and process incoming SMS messages.
  • Every USB modem connected to them acts as an independent Node capable of receiving and processing SMS messages.
  • Gateway clients are utilized by SMSWithoutBorders android app to receive and forward incoming messages online/offline servers.
  • USB modems connected to Gateway clients identify themselves by publishing their MSISDN after a duration to a Gateway server.
  • Nodes attain their phone numbers by sending a MSISDN request SMS message to seeder Gateway clients.
  • Gateway clients send ping messages after custom time periods to Gateway servers. This keeps the server from deleting the Gateway client.

By default Nodes do not know their own MSISDN (but can have their IMSI). MSISDN are required for Gateway Server's broadcasting to app users and publishing on the Available Gateway Clients dashboard.

Nodes acquire their MSISDN by sending an SMS to a seeder gateway which contains their IMSI. Gateway Clients acquire seeder addresses by querying a remote Gateway Server. They will use hard-coded seeder addresses in cases where remote Gateway Servers are not accessible (usually Client cannot connect online). Seeders respond to the Client with the received IMSI and MSISDN. IMSI and MSISDN are not stored on seeder gateways and any request for information from them requires the entire self introduction to proceed.

  • Seeders have the following:
    1. Seeder functionality turned on in the conf file (seeder = True)
    2. MSISDN and SMS present per seeding node
    3. SMS capability