In Circuit Spy ICS32sx

Nawigacja

You are hereIn Circuit Spy Orders Server

In Circuit Spy Orders Server

Rozkazy aplikacji Serwer

   Rozkazy aplikacji serwer wykonują się na komputerzez PC na którym uruchomiono aplikację ics_client.exe. Ich podstawową cechą jest to, że wywoływane są zdalnie z poziomu aplikacji Klient. Oznacza to, że wymagają połączenia Klient-Serwer.
W skład rozkazów wchodzą:

  • sys_server_software_version Zwraca informacje o wersji oprogramowania ics_server.exe

  • sys_ping Testuje połączenie z serwerem

  • sys_config_buffer Konfiguruje bufory systemowe po stronie serwera

  • sys_crc_buffer Wylicza sumę kontrolną CRC dla zadanego obszaru bufora systemowego

  • sys_close_socket Zamyka połączenie Klient-Serwer

  • sys_client_wr_rd_buffer Kopiuje dane z poziomu aplikacji klienckiej do buforów aplikacji serwera

  • sys_server_wr_rd_buffer Kopiuje dane z poziomu aplikacji serwera do buforów aplikacji serwera

  • sys_application_open Uruchamia aplikację określoną parametrem będącym ścieżką dostępu do pliku wykonywalnego

  • sys_application_close Zamyka okno programu o nazwie określonej w parametrze

  • sys_server_close Zamyka uruchomioną aplikację serwera

sys_server_close

    Funkcja zamyka wskazany serwer.

  Rozkazy  
  • Brak dodatkowych rozkazów

Opis rozkazów

  Podstawowa funkcjonalność  

Składnia

ics_client.exe --sys_server_close IP TCP
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera

Poprawna odpowiedź

O. code
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • code Kod wykonania rozkazu. Powinien wynosić '0'

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • W przypadku pracy z wieloma urządzeniami pracującymi na odległych maszynach dobrą praktyką jest powołanie instancji serwera odpowiedzialnej jedynie za zarządzanie innymi serwerami. Dzięki temu możliwe będzie uruchamianie i zamykanie innych serwerów dla różnych urządzeń

sys_server_wr_rd_buffer

    Funkcja wykonuje dwie podstawowe operacje. Kopiuje plik z poziomu aplikacji serwera do bufora systemowego serwera oraz pobiera dane z bufora systemowego serwera i kopiuje je do pliku również po stronie aplikacji serwera
Funkcja dostępna jest dla trybu pracy serwera privilaged lub supervisor

  Rozkazy  
  • --wr_s. Synchronicznie kopiuje dane z pliku po stronie serwera do wskazanego bufora znajdującego się na serwerze. Ilość przekopiowanych danych równa jest wielkości pliku
  • --rd_s. Synchronicznie kopiuje dane z wskazanego bufora znajdującego się na serwerze do pliku po stronie aplikacji serwera.

Opis rozkazów

  --wr_s  

Składnia

ics_client.exe --sys_server_wr_rd_buffer IP TCP --wr_s buffer address file
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • --wr_s Słowo klucz
  • buffer Numer bufora systemowego serwera. Numerowanie rozpoczyna się od '0'
  • address Adres w buforze od którego rozpocznie się zapis
  • file Ścieżka dostępu do pliku i jego nazwa

Poprawna odpowiedź

O. progress progress_f
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • progress Liczba całkowita oznaczając procentowy postęp wykonania operacji. Powinna wynosić 100
  • progress_f Liczba z przecinkiem oznaczająca procentowy postęp wykonania operacji. Powinna wynosić 100.0
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • Kopiowanie danych może zająć długi okres czasu. W tym czasie aplikacja kliencka nie zwraca informacji o postępie kopiowania danych
  • UWAGA. Rozkaz wymaga pracy serwera w trybie supervisor. Konfiguracja ta ze względu na bezpieczeństwo powinna być używana bardzo ostrożnie
  --rd_s  

Składnia

ics_client.exe --sys_server_wr_rd_buffer IP TCP --rd_s buffer address size file
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • --rd_s Słowo klucz
  • buffer Numer bufora systemowego serwera. Numerowanie rozpoczyna się od '0'
  • address Adres w buforze od którego rozpocznie się zapis
  • size Rozmiar danych do skopiowania
  • file Ścieżka dostępu do pliku i jego nazwa

Poprawna odpowiedź

O. progress progress_f
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • progress Liczba całkowita oznaczając procentowy postęp wykonania operacji. Powinna wynosić 100
  • progress_f Liczba z przecinkiem oznaczająca procentowy postęp wykonania operacji. Powinna wynosić 100.0
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • Kopiowanie danych może zająć długi okres czasu. W tym czasie aplikacja kliencka nie zwraca informacji o postępie kopiowania danych
  • UWAGA. Rozkaz wymaga pracy serwera w trybie supervisor. Konfiguracja ta ze względu na bezpieczeństwo powinna być używana bardzo ostrożnie

sys_application_close

    Funkcja w trybie pracy serwera supervisor zamyka aplikację po stronie serwera.

  Rozkazy  
  • --app_name. Zamyka aplikację o określonej nazwie po stronie serwera

Opis rozkazów

  --app_name  

Składnia

ics_client.exe --sys_application_close IP TCP --app_name name
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • --app_name Słowo klucz
  • name Nazwa okna programu. W przypadku gdy okno aplikacji w nazwie zawiera spacje, całość nazwy należy ująć w " ". Przykładowo uruchomiono kalulator, którego nazwa okna to Kalkulator. Zamknięcie kalkulatora wymaga więc wywołania polecenia
    ics_client.exe --sys_application_close IP TCP --app_name Kalkulator

Poprawna odpowiedź

O. code name
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • code Kod wykonania rozkazu. Powinien być '0'
  • name Nazwa okna do zamknięcia przekazana w rozkazie przez użytkownika
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • UWAGA. Rozkaz wymaga pracy serwera w trybie supervisor. Konfiguracja ta ze względu na bezpieczeństwo powinna być używana bardzo ostrożnie

sys_application_open

    Funkcja w trybie pracy serwera supervisor uruchamia aplikację po stronie serwera. Aplikację tą można uruchomić z parametrami.

  Rozkazy  
  • --app_name. Uruchamia aplikację po stronie serwera o określonej nazwie

Opis rozkazów

  --app_name  

Składnia

ics_client.exe --sys_application_open IP TCP --app_name file
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • --app_name Słowo klucz
  • file Ścieżka dostępu do pliku wraz z nazwą pliku lub sama nazwa pliku. Dodatkowo programowi można przekazać parametry. W tym celu należy ścieżkę dostępu, nazwę pliku i parametry ująć w "". Przykładowo notatnik można wywołać poprzez polecenie
    ics_client.exe --sys_application_open IP TCP --app_name "netepad.exe przykladowy_plik.txt"

Poprawna odpowiedź

O. code file
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • code Kod wykonania rozkazu. Powinien być '0'
  • file Parametr file przekazany w rozkazie przez użytkownika
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • UWAGA. Rozkaz wymaga pracy serwera w trybie supervisor. Konfiguracja ta ze względu na bezpieczeństwo powinna być używana bardzo ostrożnie
  • Rozkaz ten służy przede wszystkim do uruchamiania i zamykania instancji serwera dla współbieżnej pracy wielu urządzeń na odległym komputerze. Dzięki temu tworząc jeden serwer pracujący w trybie supervisor można zarządzać innymi serwerami poprzez otwieranie nowych instancji lub zamykanie już istniejących. Zamknięcie aplikacji wykonuje się za pomocą rozkazu sys_application_close

sys_crc_buffer

    Funkcja oblicza sumę kontrolną wskazanego obszaru Systemowego Bufora Serwera.

  Rozkazy  
  • Brak dodatkowych rozkazów

Opis rozkazów

  Podstawowa funkcjonalność  

Składnia

ics_client.exe --sys_crc_buffer IP TCP buffer address size
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • buffer Numer bufora systemowego serwera. Numerowanie rozpoczyna się od '0'
  • address adres początkowy od którego rozpocznie się obliczanie sumy kontrolnej CRC
  • size rozmiar obszaru który zostanie przeliczony

Poprawna odpowiedź

O. CRC
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • CRC Obliczona wartość sumy kontrolnej CRC
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem

sys_ping

    Funkcja sprawdza połączenie z serwerem. Aplikacja kliencka wysyła zapytanie do serwera, który zwraca liczbę każdorazowo zwiększaną o jeden po otrzymaniu rozkazu sys_ping.

  Rozkazy  
  • Brak dodatkowych rozkazów

Opis rozkazów

  Podstawowa funkcjonalność  

Składnia

ics_client.exe --sys_ping IP TCP
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera

Poprawna odpowiedź

O. number
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • number Licznik wywołań rozkazu dla danego serwera. Liczba całkowita
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem

sys_config_buffer

    Funkcja tworzy lub zwraca informacje o buforze danych serwera. Operacje wymiany danych pomiędzy urządzeniem - serwerem, pomiędzy serwerem - klientem odbywają się za pomocą bufora jakim jest w tym przypadku bufor systemowy. To w pewnym sensie nietypowe podejście wprawdzie narzuca na użytkownika konieczność obsługi dodatkowych poleceń jednak w przypadku połączenia z serwerem znajdującym się w dużej odległości od klienta w wielu przypadkach znacząco przyśpiesza pracę z urządzeniem. Dzięki temu można jednorazowo wgrać wszystkie pliki firmware na serwer, a następnie zlecać już tylko lokalnie na serwerze wgrywanie nowego oprogramowania do urządzenia.

  Rozkazy  
  • --config. Tworzenie bufora o zadanych parametrach. W przypadku gdy na serwerze utworzono już bufor, wówczas bufor ten jest usuwany a na jego miejsce powstaje nowy o parametrach przekazanych w poleceniu
  • --get_info. Zwraca informacje o buforze systemowym

Opis rozkazów

  --config  

Składnia

ics_client.exe --sys_config_buffer IP TCP --config number size
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • --config Słowo klucz
  • number Ilość buforów do utworzenia
  • size Rozmiar w bajtach każdego z buforów

Poprawna odpowiedź

O. number size
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • number Ilość utworzonych buforów
  • size Rozmiar w bajtach każdego z buforów
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • Wykonanie rozkazu zależy od rozmiaru i ilości definiowanych buforów. Ograniczeniem jest tu system operacyjny i ilość pamięci dostępnej dla użytkownika. Gdy system zwróci błąd wszystkie utworzone do tej pory bufory są usuwane
  --get_info  

Składnia

ics_client.exe --sys_config_buffer IP TCP --get_info
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera
  • --get_info Słowo klucz

Poprawna odpowiedź

  • jak dla rozkazu --config

Wystąpił błąd

  • jak dla rozkazu --config

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem
  • Rozkaz nie modyfikuje buforów. Zwraca jedynie informację o ich stanie. Pojawienie się błędu jest więc najprawdopodobniej spowodowane błędem połączenia

sys_server_software_version

   Funkcja zwraca informację o wersji oprogramowania typu serwer ics_server.exe.

  Rozkazy  
  • Brak dodatkowych rozkazów

Opis rozkazów

  Podstawowa funkcjonalność  

Składnia

ics_client.exe --sys_server_software_version IP TCP
  • IP Adres IP serwera
  • TCP Numer portu TCP serwera

Poprawna odpowiedź

O. type v0 v1 v2
I. comment
  • "O." Identyfikator poprawnego wykonania rozkazu
  • type Kod oprogramowania ics_server.exe. Powinno wynosić 0x0000
  • v0 Numer wersji. Numery wersji tworzą wersję której wartość wynosi v0.v1.v2
  • v1 Numer wersji
  • v2 Numer wersji
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Wystąpił błąd

E. code
I. comment
  • "E." Identyfikator błędnego
  • code Kod błędu
  • "I." Identyfikator komentarza
  • comment Komentarz dla użytkownika

Uwagi

  • Wywołanie rozkazu wymaga połączenia z serwerem

Szukaj