SMSFall Embedded v.1.5 1. Wstęp 2. Instalacja skryptów PHP

SMSFall Embedded v.1.5
1. Wstęp
SMSFall Embedded to system informatyczny pełniący funkcję bramki SMS składający się z
urządzenia GSM (terminal GSM TC65) wyposażonego w oprogramowanie służące do
wysyłania i odbierania SMS-ów oraz ze skryptów PHP uruchamianych na zdalnym serwerze
HTTP. Skrypty PHP zarządzają procesem wysyłania i odbierania SMS-ów oraz zapisywaniem
tych danych do bazy MySQL. Protokołem komunikacyjnym pomiędzy urządzeniem a skryptem
PHP jest JSON.
System jest dostarczany w zestawie gotowym do uruchomienia, składającym się z:
– terminalu TC65 2G firmy Siemens wraz z zasilaczem i anteną,
– skryptów PHP (oraz skryptu SQL) do instalacji na serwerze HTTP użytkownika.
Do uruchomienia systemu SMSFall Embedded niezbędne są:
– karta SIM dowolnego operatora z internetem GPRS, umożliwiająca wysyłanie SMS-ów,
– serwer HTTP z instalacją PHP (ver. > 5.2.0),
– serwer MySQL (opcjonalnie).
2. Instalacja skryptów PHP
Pliki PHP oraz plik struktury bazy danych znajdują się w archiwum dostępnym pod adresem
smsfall.pl/download/embedded/PHPEmbedded_1_5.zip. Archiwum zawiera następujące pliki:
•
db.sql
•
dbConfig.php
•
getSettings.php
•
exchangeSMS.php
Instalacja:
1) Utworzyć nową bazę danych MySQL (sugerowana nazwa smsfall) i wykonać na niej
skrypt db.sql
2) Otworzyć w edytorze plik dbConfig.php i w 8 linii kodu ustawić prawidłowe połączenie
do bazy danych podając adres serwera, użytkownika, hasło oraz nazwę bazy.
3) Wszystkie skrypty PHP (*.php) przenieść do nowoutworzonego katalogu (sugerowana
nazwa smsfall) znajdującego się na Twoim serwerze HTTP.
4) Sprawdzić prawidłowość wykonanych czynności uruchamiając skrypt getSettings.php
w przeglądarce komputera. Wynik powinien być następujący:
{"settings":[{"key":"server","value":"http://twojserwer/"},
{"key":"scrt","value":"-"},{"key":"gs","value":"getSettings.php"},
{"key":"es","value":"exchangeSMS.php"},{"key":"sm","value":"1"},
{"key":"sl","value":"pl"},{"key":"cf","value":"10"}],"time":1406377696}
5) W edytorze bazy danych (np. PHPMyAdmin) w tabeli settings zmienić wartość
http://twojserwer/smsfall/ na rzeczywisty adres Twojego serwera oraz katalog z plikami PHP
(adres musi kończyć się znakiem '/').
3. Konfiguracja urządzenia
Konfigurację urządzenia przeprowadza się komendami wysyłanymi poprzez SMS-y. W
urządzeniu TC65 należy umieścić kartę SIM (niezabezpieczoną kodem PIN). Do urządzenia
podłączyć zasilanie. Urządzenie włączy się automatycznie i po ok. 60 sekundach jest gotowe do
pracy.
Konfigurację przeprowadza się z dowolnego telefonu komórkowego wysyłając SMS-y na
numer karty SIM znajdującej się w urządzeniu TC65.
Konfiguracja:
1) Logowanie hasłem domyślnym. SMS o treści: pass123
2) Ustawienie adresu serwera HTTP na którym znajduje się plik exchangeSMS.php (np.
http://smsfall.pl/smsfall/). SMS o treści: server=http://twojserwer/
3) Zmiana hasła administratora. Nowe hasło należy podać bez polskich znaków. SMS o treści:
pass=nowe_haslo
Wszystkie komendy administracyjne:
Komenda
Opis
Ustawienie domyślne
apt
Nośnik danych
gprs
ap
Punkt dostępu (APN)
internet
apu
Użytkownik
puste
app
Hasło
puste
server
URL do katalogu skryptów PHP
http://twojserwer/
gs
Skrypt ustawień dla urządzenia
getSettings.php
es
Skrypt wymiany SMS-ów
exchangeSMS.php
sm
Informacyjne komunikaty SMS
1
sl
Język komunikatów SMS (pl, en)
pl
cf
Częstość zapytań do serwera HTTP w sekundach
10
dr
Parametr niekonfigurowalny
0
dre
Parametr niekonfigurowalny
24h
config
Urządzenie odsyła SMS-em wybrane ustawienia
konfiguracyjne
-
config all
Urządzenie odsyła SMS-em wszystkie ustawienia konfiguracyjne
restart
Ponowne uruchomienie urządzenia
stop
Wyłącznie urządzenia (zastosowanie tej komendy wymaga ponownego 'fizycznego' dostarczenia
zasilania)
-
update
Wymuszenie sprawdzenia aktualizacji
oprogramowania
-
reload
Przeładowanie ustawień urządzenia z serwera
-
pass=nowe_haslo
Zmiana hasła administratora
pass123
pin=nowy_pin
Zmiana kodu PIN
puste
4. Bezpieczeństwo
Podstawowym zabezpieczeniem zabezpieczającym przed niepowołanym wykonaniem
skryptów PHP znajdujących się na serwerach klienta jest odkomentowanie bloku:
if($imei== "...") {
}
oraz podanie w miejsce … numeru IMEI znajdującego się na spodzie obudowy terminala TC65.
Odkomentowania w kodzie należy dokonać w skryptach:
•
getSettings.php
•
exchangeSMS.php