Differences

This shows you the differences between two versions of the page.

--- en:mervis-ide:30-communication-protocols:10-sscp [2017/06/19 14:41]
m.chlupac [SSCP protocol]
+++ en:mervis-ide:30-communication-protocols:10-sscp [2017/11/22 10:56] (current)
@@ Line 3: / Line 3: @@
 Mervis controllers support full configuration and communication via SSCP protocol. Detail description of this protocol is available in: {{:cs:mervis-ide:sharkprotocolspecification_user_2017_05_30.pdf|SSCP description}}.
-===== Základní charakteristiky =====
+===== Basic features =====
-  * Protokol specifikován především na aplikační úrovni
+  * Protocol is defined on application layer
-      * V PLC je nyní implementován přenos po TCP a seriové lince. Částečně pak po UDP pro účely autodetekce a přenosu konfigurace.
+      * TCP and serial bus implementations are currently available. UDP is used for autodetection and configuration.
-  * Jednoduchá struktura přenosového rámce.
+  * Simple structure of communicated data packets
-      * Bezpečně lze vypočítat délku rámce z hlavičky.
+      * Easy to calculate packet size from header.
-      * Pro různé fyzické vrstvy lze přidat hlavičky a patičky, vnitřní struktura zůstává stejná.
+      * Extra headers and suffixes can be added for different communication layers - inner structure stays untouched.
-      * Každý telegram (kromě broadcastových) s sebou nese informaci o adrese cílového zařízení (8 bit slave ID). Pouze PLC s odpovídajícím ID na telegram odpovídá.
+      * Each data packet (except broadcast packets) carries information about destination address (8 bit slave ID). Only controller with that address is expected to respond.
-  * Využití pro veškerou komunikaci s PLC
+  * SSCP can be used for any and all communication tasks
-      * Přenos statistik a nastavení, detekce PLC, přenos hodnot, vzdálené ladění PLC programu.
+      * Communication of statistics, configuration, PLC detection, communication of values, remote debugging etc.
-  * Umožňuje vyjednání délky přenosových bufferů mezi jednotlivými stranami, vyžaduje při jinicializaci komunikace ověření.
+  * Communication buffer size can be negotiated by client
-  * Podpora Mervis Proxy.
+  * Client authentication is required.
-  * Protokol je verzován. Novější verze vždy podporuje i předchozí funkce, ale je silně doporučeno nevyužívat funkce označené jako "zastaralé".
+  * [[en:mervis-proxy:00-start|Mervis Proxy]] support.
+  * Protocol versioning is supported. Newer version is backward compatible with previous version but usage of deprecated and obsolote methods is not recommended.
-===== Přenos hodnot proměnných =====
+===== Communication of Values =====
-  * Protokol podporuje přenos dlouhých bloků paměti. Pokud se hodnota proměnné nevejde do vyjednaných bufferů, přenese se pomocí stavového přenosu delších dat.
+  * SSCP protocol supports long memory blocks. If the size of the buffer is not sufficient - multiple reads can be made and atomicity of the operation is guaranteed.
-  * Každá proměnná je identifikována komunikačním ID. ID se může měnit (vývojové prostředí ho změní) v případě, že u proměnné dojde ke změně typu nebo jména.
+  * Every variable is identified by its communication ID.
-  * Přenos hodnot je implementován jako přenos paměťové oblasti, kde je proměnná uložena. Lze definovat offset od začátku hodnoty proměnné a její délku. To je vhodné pro případy, kdy se například mění pouze jedno číslo ve složitější struktuře (pole, struktura, funkční blok).
+  * Value is communicated as a block of memory. Offset and length can be used to read part of the larger data structure (array, struct, function block, ...)
-      * Je nutné znát layout paměti. Ten se řídí standardními pravidly o zarovnávání proměnných dle paměťové náročnosti typu (1-8 bajtové zarovnání).
+      * Memory data layout follows standard rules of data alignment (1-8 bytes)
+===== .NET SDK =====
+  * There is a SDK with .NET libraries. You can download it {{ :en:mervis-ide:30-communication-protocols:netsscpsdk.zip |here}}.