Unipi technology Knowledge Base cs:sw:01-mervis

Mervis IDE

anonymous@undisclosed.example.com (Anonymous) — Fri, 06 Aug 2021 12:03:37 +0000

@@ -3,22 +3,22 @@
  
-   * připojit se k PLC a to i vzdáleně skrze internetové spojení
-   * spravovat konfigurace kontrolérů včetně aktualizace běhového prostředí[[cs:sw:01-mervis:02-mervis-rt| Mervis RT]]
+   * připojit se k jednotkám a to i vzdáleně skrze internetové spojení
+   * spravovat konfigurace jednotek včetně aktualizace běhového prostředí[[cs:sw:01-mervis:02-mervis-rt| Mervis RT]]
    * vytvářet programy metodou [[cs:automation:02-glossary:iec61131-3-hidden#metoda_funkcnich_bloku_fbd|funkčních bloků (FBD)]] či [[cs:automation:02-glossary:iec61131-3-hidden#strukturovany_text_st|ve strukturovaném textu (ST)]] podle [[cs:automation:02-glossary:iec61131-3-hidden|IEC61131-3]]
    * vytvářet funkční knihovny a Modbusová zařízení pro jejich snadné pozdější využití v jiných projektech
    * vytvářet webová uživatelská rozhraní (HMI)
    * vytvářet projekty pro [[cs:sw:01-mervis:05-mervis-scada|Mervis SCADA]] - prostředí pro vzdálený management instalací
-   * propojovat kontroléry s [[cs:hw:05-sensors:1-wire|1-Wire]] senzory a [[cs:hw:04-extensions|rozšiřujícími moduly Unipi]]
+   * propojovat jednotky se [[cs:hw:05-sensors:1-wire|1-Wire]] senzory a [[cs:hw:04-extensions|rozšiřujícími moduly Unipi]]
    * nahrávat a ladit výsledná řešení skrze [[cs:sw:01-mervis:02-mervis-rt|Mervis RT]]
    * ... a mnoho dalšího
  
- Projekt v Mervis IDE se označuje jako **řešení**. Jedno **řešení** se pak skládá z parametrů připojení Vašeho kontroleru či kontrolérů, jejich konfigurace, programů, knihoven a rozhraní HMI. 
+ Projekt v Mervis IDE se označuje jako **řešení**. Jedno **řešení** se pak skládá z parametrů připojení Vaší jednotky či několika jednotek, jejich konfigurace, programů, knihoven, rozhraní HMI, atd... 
  
  Na následujícím snímku vidíme typické uživatelské rozhraní Mervis IDE
  
  {{ :en:sw:01-mervis:mervis-ide-introduction-01-workspace.png?direct |}}
  
- V **levém panelu** Sestava lze vidět rozbalený strom kontroléru, obsahující seznam nakonfigurovaných komunikačních kanálů (1-Wire, Modbus) a skrze ně připojených zařízení. V záložce **Spustitelné projekty** se nachází všechny Vaše programy a funkční knihovny. V záložce **HMI projekty** pak máte přístup ke všem Vašim HMI rozhraním.
+ V **levém panelu** Sestava lze vidět rozbalený strom jednotky (PLC), obsahující seznam nakonfigurovaných komunikačních kanálů (1-Wire, Modbus) a skrze ně připojených zařízení. V záložce **Spustitelné projekty** se nachází všechny Vaše programy a funkční knihovny. V záložce **HMI projekty** pak máte přístup ke všem Vašim HMI rozhraním.
  
  V **hlavním okně** můžete vidět [[cs:automation:02-glossary:iec61131-3-hidden#metoda_funkcnich_bloku_fbd|FBD]] program v módu ladění. Levý sloupec pracovního okna je určen pro **vstupy** programu. Pravý sloupec pracovního okna slouží pro umístění **výstupů** programu. Na plochu mezi nimi se pak umisťují funkční bloky (FB), kdy každý funkční blok představuje předem vytvořený kód plnící určitou funkci. Jak bylo řečeno výše, program je momentálně v módu ladění, ve kterém lze snadno sledovat hodnoty jednotlivých proměnných na vstupech a výstupech a případně je ručně přepisovat. Tyto hodnoty se zobrazují v malých šedých boxech vedle příslušného vstupu/výstupu. Mód ladění Vám také umožňuje zobrazit aktuální hodnoty formou grafu - viz sekce pod **hlavním oknem** na snímku. 
  
  Panel **Vlastnosti** na pravém okraji obrazovky představuje kompletní seznam všech vlastností a hodnot pro daný objekt. Na vzorovém snímku se zobrazují parametry pro vstup ''office_thermometer_temperature''. /* FIXME vyměnit obrázek za CZ verzi a změnit název na: kancelar_teplomer_teplota */

Mervis RT

anonymous@undisclosed.example.com (Anonymous) — Mon, 28 Apr 2025 14:27:18 +0000

@@ -3,7 +3,13 @@
  
- <WRAP center round tip 60%>
+ <WRAP group center round box 95%>
+ {{ :files:img_warning-line_b.png?nolink |}}
+ <WRAP half column 13%>
+ {{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
+ </WRAP>
+ <WRAP half column 83%>
+ **Poznámka:** \\
  Pro jednotky Unipi poskytujeme obrazy s operačním systémem GNU/Linux a předinstalovaným běhovým prostředím Mervis RT. Více informací naleznete v [[cs:sw:01-mervis:06-tutorials|tutoriálech]].
- 
+ </WRAP>
  </WRAP>

Mervis DB

anonymous@undisclosed.example.com (Anonymous) — Tue, 17 Jun 2025 10:58:11 +0000

@@ -3,12 +3,12 @@
  
- Mervis DB je vysoce optimalizovaná databáze určená pro dlouhodobé ukládání dat z jednotek, aplikací a mnoha jiných zařízení, které využívají otevřeného API databáze. 
+ Mervis DB je vysoce optimalizovaná databáze určená pro dlouhodobé ukládání dat z jednotek, aplikací a mnoha jiných zařízení.
  
  Hlavní využití s jednotkami Unipi je ukládání historických dat a jejich analýza pomocí [[cs:sw:01-mervis:05-mervis-scada|Mervis SCADA]]. 
  
  Standardním způsobem použití Mervis DB je varianta cloudové služby. Přístupové údaje k Mervis DB jsou vygenerovány **společně s projektem Mervis SCADA** a jsou určeny pro všechny PLC, jenž jsou k tomuto SCADA projektu připojeny.
  
- Pro nasazení Mervis DB společně s Mervis SCADA pokračujte návodem [[cs:sw:01-mervis:mervis-scada-project-hidden|]].
+ Pro nasazení Mervis DB pokračujte návodem [[cs:sw:01-mervis:mervis-scada-project-hidden|]].
  
  <WRAP group center round box 95%>
  {{ :files:img_warning-line_b.png?nolink |}}
  <WRAP half column 13%>
@@ -19,9 +19,9 @@
  Při smazání projektu Mervis SCADA nebo při zablokování účtu je automaticky zastaveno i ukládání do Mervis DB.
  </WRAP>
  </WRAP>
  
- 
+ /*
  ===== Migrace a správa dat =====
  V rámci placené služby nabízíme také několik variant správy dat:
    * Přesun dat mezi účty Mervis DB, včetně možné úpravy časové značky
    * Import dat z Excelového, nebo CSV souboru
@@ -31,595 +31,5 @@
  V případě zájmu o některou z výše zmíněných služeb kontaktujte naše [[info@unipi.technology|obchodní oddělení]].
  
  \\
  {{cs:sw:01-mervis:migrace_mervis-db_cz.png?direct|}}
- 
- 
- ===== Mervis DB Viewer =====
- K prohlížení ukládaných dat z cloudové instance Mervis DB na serverech Unipi lze využít Mervis DB Viewer. Jedná se o on-line aplikaci, která se spojí s databází a zobrazí dle zadaných parametrů (např. časového rozmězí) data která obsahuje. 
- 
- URL adresa: [[https://db.unipi.technology/viewer]].
- 
- {{cs:sw:01-mervis:db-mervis-info-viewer.png?direct|}}
- 
- 
- ===== API =====
- Mervis DB nabízí otevřené rozhraní protokolu SOAP. Odpovídající WSDL je k ke stažení:
- 
-   * {{:cs:sw:01-mervis:mervisdb_wsdl-2017-07-12.zip|}}
- 
- Pro speciální použití existují i další rozhraní pro komunikaci s Mervis DB - pro jejich použití a popis kontaktujte prosím [[cs:contact:00-start|technickou podporu]].
- 
- ==== Seznam základních podporovaných funkcí ====
- 
- ^ Funkce                                      ^ Popis                                                                                                                                                 ^
- | SaveData                                    | Uloží jeden, nebo více záznamů z jedné nebo více proměnných.                                                                                          |
- | GetData/GetDataAsync                        | Přečte jeden, nebo více záznamů z jedné nebo více proměnných.                                                                                         |
- | GetParticularData/GetParticulatDataAsync    | Optimalizovaná metoda pro čtení „speciálních“ dat - poslední hodnota, poslední hodnota po určitém časovém okamžiku atd.                               |
- | GetVariables                                | Získá seznam proměnných.                                                                                                                            |
- | GetAllVariables                             |                                                                                                                                                       |
- | ServerAlive                                 | Zastaralé                                                                                                                                             |
- | DeleteVariables                             |                                                                                                                                                       |
- | DeleteData                                  |                                                                                                                                                       |
- | EnsureVariables                             |                                                                                                                                                       |
- | GetTransformedData/GetTransformedDataAsync  | Metoda čtení agregovaných výsledků s daným časovým obdobím, agregace může být min, max, integrál, vážený průměr, první, poslední a medián   |
- | GetServerVersion                            |                                                                                                                                                       |
- | GetVariableStats                            | Zastaralé                                                                                                                                             |
- | GetVariableStatsAsync                       | Zastaralé                                                                                                                                             |
- | CheckCredentials                            |                                                                                                                                                       |
- 
- 
- ==== Vlastnosti objektu ====
-   * (UTC)TimeStamp - UTC časová značka záznamu
-   * GoodThrough - UTC časová značka konce platnosti konkrétního záznamu 
-   * Interval - časová perioda (v sekundách), kdy má být zaznamenána další hodnota 
- 
- 
- ==== Příklady použití ====
- 
- === C# ===
- 
- {{cs:sw:01-mervis:mervis_db_csharp.png?direct|}}
- 
- <html><span class="kbBlueText">Příklady ke stažení:</span></html> \\
-   * {{cs:sw:01-mervis:mervisdb_getdata_example.zip|}}
-   * {{cs:sw:01-mervis:mervisdb_savedata_example.zip|}}    
-     
- <html><span class="kbBlueText">Příklad kódu:</span></html> \\
- 
- <code csharp| MervisDB_GetData_Example.cs>
- using System;
- using System.Linq;
- using System.Threading.Tasks;
- using MervisDb_GetData_Example.MervisDbService;
-  
- namespace MervisDb_GetData_Example {
-  class Program {
-   static void Main(string[] args) {
-    //
-    // Demo of asynchronous methods.
-    //
-    var task = Task.Run(async() => {
- 	//
- 	// Create access to the real server.
- 	// Without SSL connections, you have to remove binding parameters "<security mode="Transport"/>" in the App.config.
- 	// The client is automatically generated from the WSDL file available here: https://kb.mervis.info/doku.php/en:mervis-db:10-api
- 	//
- 	using(HistoryDbAccessClient client = new HistoryDbAccessClient("HistoryAccess", "http://db.unipi.technology/dbaccess")) {
- 	 // Authentication credetials in the database.
- 	 Credentials credentials = new Credentials {
- 	  Name = "XXXX", Password = "YYYY"
- 	 };
-  
- 	 // Specification of the variables through Key-Value.
- 	 // Here we use 2 variables.
- 	 KeyValuePair[][] keys = new KeyValuePair[][] {
- 	  new KeyValuePair[] {
- 		new KeyValuePair {
- 		 Key = "DPGuid", Value = "338E2882-D72B-4D17-A241-73E8BC30F458"
- 		}, new KeyValuePair {
- 		 Key = "StationName", Value = "AAABBB"
- 		}
- 	   },
- 	   new KeyValuePair[] {
- 		new KeyValuePair {
- 		 Key = "DPGuid", Value = "CC80211D-3D29-4CC2-91A2-F69483D566B5"
- 		}, new KeyValuePair {
- 		 Key = "StationName", Value = "AAABBB"
- 		}
- 	   }
- 	 };
-  
- 	 // From-To dates. The dates must be specified in the UTC time zone.
- 	 DateTime utcTo = DateTime.UtcNow;
- 	 DateTime utcFrom = DateTime.UtcNow.AddDays(-1);
-  
- 	 // Retrieving the data goes through cycling of values and variables. The server returns recommended values needed for the the next cycle.
- 	 int variableOffset = 0; // the offset of the variable
- 	 int variableCount = 10; // maximal number of variables returned in one request
- 	 int valueOffset; // the offset of the value
- 	 int valueCount = 1000; // maximal values in on request
-  
- 	 Console.WriteLine("Reading values...");
-  
- 	 do {
- 	  valueOffset = 0;
- 	  do {
- 	   // Execute the request.
- 	   var result = await client.GetDataAsyncAsync(credentials, keys, utcFrom, utcTo, variableOffset, variableCount, valueOffset, valueCount);
-  
- 	   // Check the return code. "0;OK" is what we want.
- 	   if (!result.ReturnCode.StartsWith("0;")) {
- 		Console.WriteLine("Error on reading: {0}", result.ReturnCode);
- 	   }
-  
- 	   // Cycle through the data and print it out.
- 	   foreach(var valRecord in result.Data) {
- 		Console.WriteLine("Variable: {0}", String.Concat(valRecord.Keys.Select((i) => {
- 		 return String.Format("{0}={1}; ", i.Key, i.Value);
- 		})));
-  
- 		foreach(var value in valRecord.Vals) {
- 		 Console.WriteLine("{0}->{1} [{2}] {3}", value.Ts, value.Gt, value.Hvt, value.Dv /* Use value type according to the Hvt (History Value Type) */ );
- 		}
- 	   }
-  
- 	   valueOffset = result.NextValueOffset;
- 	   variableOffset = result.NextVariableOffset;
- 	  }
- 	  while (valueOffset != -1);
- 	 }
- 	 while (variableOffset != -1);
- 	}
-    });
-  
-    Console.WriteLine("DB communication is running in background");
-  
-    try {
- 	task.Wait();
-    } catch (Exception exc) {
- 	Console.WriteLine("Exception: {0}", exc.ToString());
-    }
-  
-    Console.WriteLine("DB communication finished");
-  
-    Console.ReadLine();
-   }
-  }
- }
- </code>
- 
- <code csharp| MervisDB_SaveData_Example.cs>
- using System;
- using System.Collections.Generic;
- using System.Threading.Tasks;
- using MervisDb_SaveData_Example.MervisDbService;
-  
- namespace MervisDb_SaveData_Example
- {
- 	class Program
- 	{
- 		static void Main(string[] args)
- 		{
- 			//
- 			// Demo of asynchronous methods.
- 			//
- 			var task = Task.Run(async () =>
- 			{
- 				//
- 				// Create access to the real server.
- 				// Without SSL connections, you have to remove binding parameters "<security mode="Transport"/>" in the App.config.
- 				// The client is automatically generated from the WSDL file available here: https://kb.mervis.info/doku.php/en:mervis-db:10-api
- 				//
- 				using (HistoryDbAccessClient client = new HistoryDbAccessClient("HistoryAccess", "http://db.unipi.technology/dbaccess"))
- 				{
- 					// Authentication credetials in the database.
- 					Credentials credentials = new Credentials { Name = "XXXX", Password = "YYYY" };
-  
- 					// Adding records...
- 					List<ValueRecord> records = new List<ValueRecord>();
-  
- 					DateTime utcTimeStamp = new DateTime(2018, 1, 1, 12, 0, 0, DateTimeKind.Utc);
-  
- 					// Each value is stored in a ValueRecord structure
- 					ValueRecord rec = new ValueRecord();
-  
- 					rec.UtcTimeStamp = utcTimeStamp;                // time stamp of the value, UTC date time must be used
- 					rec.HistoryValueType = HistoryValueType.Double; // type of the value
- 					rec.DoubleValue = 23.4;                         // value itself
- 					rec.Interval = 60.0;                            // sampling period in seconds. When the difference of timestamps of subsequent values if greater than 1.1 multiple of the interval, the data should be considered incomplete.
- 					rec.Keys = new KeyValuePair[]										// identification of the variable. At least one key-value pair must be "IsKey" to identify a variable.
- 					{
- 						new KeyValuePair { IsKey = true, Key = "Root", Value = "Building A"},
- 						new KeyValuePair { IsKey = true, Key = "Level1", Value = "Floor 1"},
- 						new KeyValuePair { IsKey = true, Key = "Level2", Value = "Room 7"},
- 						new KeyValuePair { IsKey = true, Key = "Level3", Value = "Temperature"},
- 						new KeyValuePair { IsKey = false, Key = "Description", Value = "Temperature in the room 7"},
- 						new KeyValuePair { IsKey = false, Key = "Unit", Value = "°C"},
- 					};
-  
- 					records.Add(rec);
-  
- 					// Save data method returns the number of stored records					
- 					int recordsSaved = await client.SaveDataAsync(credentials, records.ToArray());
-  
- 					Console.WriteLine("Records saved: {0}", recordsSaved);
- 				}
- 			});
-  
- 			Console.WriteLine("DB communication is running in background");
-  
- 			try
- 			{
- 				task.Wait();
- 			}
- 			catch (Exception exc)
- 			{
- 				Console.WriteLine("Exception: {0}", exc.ToString());
- 			}
-  
- 			Console.WriteLine("DB communication finished");
-  
- 			Console.ReadLine();
- 		}
- 	}
- }
- </code>
- 
- 
- <code csharp| MervisDb_GetTransformedData_Example.cs>
- using System;
- using System.Linq;
- using System.Threading.Tasks;
- using MervisDb_GetTransformedData_Example.MervisDbService;
-  
- namespace MervisDb_GetTransformedData_Example
- {
- 	class Program
- 	{
- 		static void Main(string[] args)
- 		{
- 			//
- 			// Demo of asynchronous method.
- 			//
- 			var task = Task.Run(async () =>
- 			{
- 				//
- 				// Create access to the real server.
- 				// Without SSL connections, you have to remove binding parameters "<security mode="Transport"/>" in the App.config.
- 				// The client is automatically generated from the WSDL file available here: https://kb.mervis.info/doku.php/en:mervis-db:10-api
- 				//
- 				using (HistoryDbAccessClient client = new HistoryDbAccessClient("HistoryAccess", "http://db.unipi.technology/dbaccess"))
- 				{
- 					// Authentication credentials in the database.
- 					Credentials credentials = new Credentials { Name = "XXXXX", Password = "YYYYY" };
-  
- 					// Specification of the variables through Key-Value.
- 					// Here we use 2 variables.
- 					KeyValuePair[][] variableKeys = new KeyValuePair[][] {
- 						new KeyValuePair[] {
- 							new KeyValuePair (false, /*Key*/ "DPGuid", /*Value*/ "338E2882-D72B-4D17-A241-73E8BC30F458"),
- 							new KeyValuePair (false, /*Key*/ "StationName", /*Value*/ "AAABBB")
- 						},
- 						new KeyValuePair[] {
- 							new KeyValuePair (false, /*Key*/ "DPGuid", /*Value*/ "CC80211D-3D29-4CC2-91A2-F69483D566B5"),
- 							new KeyValuePair (false, /*Key*/ "StationName", /*Value*/ "AAABBB")
- 						}
- 					};
-  
- 					// Aggregation request
- 					var aggregation = new AggregationRequest();
- 					aggregation.Types = new AggregationType[] { AggregationType.Last };
- 					aggregation.Interpolation = InterpolationType.None;
- 					//aggregation.MaxNeighborDistance = ..only for interpolation;
- 					aggregation.IsoPattern = new string[] { "PT15M" }; // 15 min period (ISO 8601 duration pattern)
- 					aggregation.From = new DateTime(2018, 11, 24, 0, 0, 0, 0, DateTimeKind.Unspecified);
- 					aggregation.To =   new DateTime(2018, 11, 25, 0, 0, 0, 0, DateTimeKind.Unspecified);
- 					aggregation.TimeZone = @"Europe/Prague";
-  
- 					// Retrieving the data goes through cycling of intervals and variables. The server returns recommended intervals needed for the the next cycle.
- 					int variableOffset = 0; // the offset of the variable
- 					int variableCount = 10; // maximal number of variables returned in one request
- 					int intervalOffset;       // the offset of the interval
- 					int intervalCount = 1000; // maximal values in on request
-  
- 					Console.WriteLine("Reading values...");
-  
- 					do
- 					{
- 						intervalOffset = 0;
-  
- 						do
- 						{
- 							// Execute the request.
- 							var result = await client.GetTransformedDataAsyncAsync(credentials, aggregation, variableKeys, variableOffset, variableCount, intervalOffset, intervalCount);
-  
- 							// Check the return code. "0;OK" is what we want.
- 							if (!result.ReturnCode.StartsWith("0;"))
- 							{
- 								Console.WriteLine("Error on reading: {0}", result.ReturnCode);
- 							}
-  
- 							// Cycle through the data and print it out.
- 							if (result.Data != null)
- 							{
- 								foreach (VariableAggregate vag in result.Data)
- 								{
- 									Console.WriteLine("Variable: {0}", String.Concat(vag.Keys.Select((i) => { return String.Format("{0}={1}; ", i.Key, i.Value); })));
-  
- 									foreach (Interval value in vag.Data)
- 									{
- 										Console.Write(" {0}->{1} quality: {2:0.00} ", value.Begin, value.End, value.DataQuality);
-  
- 										if (value.Last != null)
- 										{
- 											Console.Write(" Last Value: {0} (stamp {1}, origin {2})", value.Last.Value, value.Last.Stamp, value.Last.Origin);
- 										}
-  
- 										Console.WriteLine();
- 									}
- 								}
- 							}
-  
- 							variableOffset = result.NextVariableOffset;
- 							intervalOffset = result.NextIntervalOffset;
-  
- 						} while (intervalOffset != -1);
-  
- 					} while (variableOffset != -1);
- 				}
- 			});
-  
- 			Console.WriteLine("DB communication is running in background");
-  
- 			try
- 			{
- 				task.Wait();
- 			}
- 			catch (Exception exc)
- 			{
- 				Console.WriteLine("Exception: {0}", exc.ToString());
- 			}
-  
- 			Console.WriteLine("DB communication finished");
-  
- 			Console.ReadLine();
- 		}
-  
- 	}
- }
- </code>
- 
- 
- === Matlab ===
- 
- {{cs:sw:01-mervis:mervisdb_matlab_api.png?direct|}}
- 
- == Podporované funkce: ==
- ^ Funkce                 ^ Popis                                                          ^
- | SaveData               | Uloží jeden, nebo více záznamů z jedné nebo více proměnných.   |
- | GetData                | Přečte jeden, nebo více záznamů z jedné nebo více proměnných.  |
- | GetDataUnmerged        | Přečte jeden, nebo více záznamů z jedné nebo více proměnných. Umožňuje nastavit více možností než funkce GetData. |
- | GetDataOrigin          | Přečte data přesně tak, jak jsou uložena v databázi.           |
- | DeleteVariable         | Smažte celou proměnnou nebo určitý interval.                   |
- | GetRequiredTimestamp   | Získej časovou značku v závislosti na nastavení vstupu.        |
- 
- == Toolbox ==
- Pro komunikaci Matlabu s Mervis DB potřebujete nainstalovat toolbox: 
-   * {{cs:sw:01-mervis:mervisdb_matlabtoolbox.zip|}}
-   * Zobrazení nápovědy ke každé z funkcí je možné: <code matlab>
- help MervisDatabse.supported_function_name
- </code>
- 
- == Kód ==
- <code matlab| MervisDB_GetData_example.m>
- % Instance of Mervis DB 
- mervisDB = MervisDatabase('username', 'password', 'dbUrl');
-  
- % Time interval definition
- from = localMatlab2utcMatlab(datenum(2017, 1, 1)); %1.1.2017 in utc
- to = localMatlab2utcMatlab(datenum(2017, 31, 1)); %31.1.2017 in utc
- samplePeriod = 5*60; % 5 minutes
- outputTimeZone = 'Local'; % possible 'Local' or  'Utc' parameter;
-  
- % Specifying varibles to download
- varKeys1 = {'DPGuid', '338E2882-D72B-4D17-A241-73E8BC30F458';...
-             'StationName', 'XXXXXXX'}; % Keys definition of first variable
- varKeys2 = {'DPGuid', 'CC80211D-3D29-4CC2-91A2-F69483D566B5';...
-             'StationName', 'YYYYYYY'}; % Keys definition of second variable
-  
- variable1 = MervisDbVariable(varKeys1); % Create MervisDbVariable object from defined keys
- variable2 = MervisDbVariable(varKeys2);
-  
- arrayOfVarKeys = [variable1; variable2]; % array of MervisDbVariables objects
-  
- % help for function getData
- help MervisDatabase.getData 
-  
- % Download required data
- [data, time] = mervisDB.getData(arrayOfVarKeys, from, to, samplePeriod, outputTimeZone);
-  
- % Get all variables with defined keys
- allVaribales = mervisDB.getAllVars(varKeys1);
- </code>
- 
- === PHP ===
- 
- == Kód ==
- <code php| MervisDB_GetData_example.php>
- <?php
- /*
- Mervis DB PHP example - getdata
  */
- try {
-  
-   $soapClient = new SoapClient('./wsdl/singlewsdl.xml', array(
- 	'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
- 	'trace' => 0,
- 	'features' => SOAP_SINGLE_ELEMENT_ARRAYS
-   ));
-   $soapClient->__setLocation('http://db.unipi.technology/dbaccess');
-  
-   $credentials = array(
- 	'Name' => 'XXXXXXX',
- 	'Password' => 'YYYYYYY'
-   );
-  
-   $utcTZ   = new DateTimezone('UTC'); //all time realted values are expected in UTC
-   $utcFrom = new DateTime('-120minutes', $utcTZ); //
-   $utcTo   = new DateTime('now', $utcTZ); //
-  
-   $valOffset = 0;
-   $valCount  = 20; //how many values should be returned in one request at most. Recommended value: 5000
-   $varOffset = 0;
-   $varCount  = 4; //how many variable should be returned in on request at most
-  
-   $variablesKey = array(
- 	array(
- 	  array(
- 		'IsKey' => true,
- 		'Key' => 'DPGuid',
- 		'Value' => '338E2882-D72B-4D17-A241-73E8BC30F458'
- 	  ),
- 	  array(
- 		'IsKey' => true,
- 		'Key' => 'StationName',
- 		'Value' => 'AAAAAAAAAA'
- 	  )
- 	),
- 	array(
- 	  array(
- 		'IsKey' => true,
- 		'Key' => 'DPGuid',
- 		'Value' => 'CC80211D-3D29-4CC2-91A2-F69483D566B5'
- 	  ),
- 	  array(
- 		'IsKey' => true,
- 		'Key' => 'StationName',
- 		'Value' => 'BBBBBBB'
- 	  )
- 	)
-   );
-  
-   echo "Reading values from: {$utcFrom->format('c')} to: {$utcTo->format('c')}\n\n";
-  
-   $counter = 0;
-  
-   do {
- 	$response  = null;
- 	$valOffset = 0;
- 	do {
- 	  $response  = $soapClient->GetData(array(
- 		'credentials' => $credentials,
- 		'variablesKey' => $variablesKey,
- 		'utcFrom' => $utcFrom->format('Y-m-d\TH:i:s\Z'),
- 		'utcTo' => $utcTo->format('Y-m-d\TH:i:s\Z'),
- 		'valueOffset' => $valOffset,
- 		'valueCount' => $valCount,
- 		'variableCount' => $varCount,
- 		'variableOffset' => $varOffset
- 	  ));
- 	  $valOffset = $response->nextValueOffset;
- 	  $varOffset = $response->nextVariableOffset;
-  
- 	  foreach ($response->GetDataResult->Mvr as $varArray) {
- 		foreach ($varArray->Keys->KeyValuePair as $kvp) //the set of keys depends on the source of the data
- 		  {
- 		  if ($kvp->Key == 'DPName') {
- 			echo "\n{$kvp->Value}\n";
- 			$counter++;
- 		  }
- 		}
-  
- 		if (isset($varArray->Vals->I)) {
- 		  foreach ($varArray->Vals->I as $val) {
- 			echo "  t: {$val->Ts}   Interval: {$val->Ivl}  {$valOffset} {$varOffset}\n";
- 		  }
- 		} else {
- 		  echo "empty\n";
- 		}
-  
- 	  }
-  
- 	} while ($response->nextValueOffset != -1); //-1 - no more data available
-   } while ($response->nextVariableOffset != -1); //-1 - no more data available
- }
- catch (Exception $e) {
-   print_r($e);
- }
- ?>
- </code>
- 
- 
- /*
- ===== Excel Exporter =====
- K dispozici je také nástroj pro příkazovou řádku s názvem Excel Exporter, který může z vašich dat v Mervis DB vytvořit plně přizpůsobitelný soubor aplikace Microsoft Excel.
- 
- Jeho základem je šablona XLSX souboru, ve kterém můžete pomocí speciální syntaxe umisťovat data z Mervis DB.
- 
- ==== Příklad: ====
- V tomto příkladu si ukážeme, jak exportovat jednu proměnnou z Mervis DB do Excelového souboru.
- 
-     Obrázek
- 
- === Soubor s konfigurací ===
- Nejprve je třeba vytvořit konfigurační soubor XML, kde se definuje mapování mezi sadou klíčů popisujících jednotlivé proměnné Mervis DB a některými názvy proměnných, které budou použity později v šabloně aplikace Excel.
- 
- Můžete také definovat název výstupního souboru a také zda má být soubor pouze aktualizován nebo přepsán. 
- 
- <code xml| ExcelDemo.xml>
- <?xml version="1.0" encoding="utf-8"?>
- <RcWareDbExporterVariableTemplateFile>
- 	 <exportTemplate>exceldemo.xlsx</exportTemplate>
- 	 <exportOutput>exceldemo_[yyyy-MM-dd_HH-mm].xlsx</exportOutput>
- 	 <fillIncrementaly>false</fillIncrementaly>
- 	 <variables>
- 		  <variable name="OutsideTemperature">
- 			   <keyValuePairs>
- 					<keyValuePair key="DPGuid" value="338E2882-D72B-4D17-A241-73E8BC30F458" isId="true" />
- 					<keyValuePair key="StationName" value="ENERGO" isId="true" />
- 			   </keyValuePairs>
- 		  </variable>
- 		  <variable name="HereCouldBeSomeOtherVariable">
- 			   <keyValuePairs>
- 					<keyValuePair key="DPGuid" value="338E2882-D72B-4D17-A241-73E8BC30F458" isId="true" />
- 					<keyValuePair key="StationName" value="ENERGO" isId="true" />
- 			   </keyValuePairs>
- 		  </variable>
- 	 </variables>
- </RcWareDbExporterVariableTemplateFile>
- </code>
- 
- === Excelová šablona ===
- Pomocí jednoduchého jazyka šablony můžete definovat, které hodnoty z Mervis DB se maji umístit na jaké místo ve výstupním souboru aplikace Excel. 
- 
- <code>
- [YEAR:2016|MONTH:1|DAY:15|HOUR:12|MINUTE:0|VARIABLE:OutsideTemperature]
- </code>
- 
- Libovolnou z hodnot definujících čas lze vynechat a bude nahrazena aktuálním datem, časem nebo hodnotami předanými prostřednictvím parametrů příkazového řádku. 
- 
-     obrázek
- 
- 
- === Spuštění exportéru ===
- <code | runExcelDemo.bat>
- .\ESG.RcWareDb.DataExporter\ESG.RcWareDb.DataExporter.exe tmpPath:"ExcelDemo.xml" srvUrl:"http://db.unipi.technology/dbaccess" srvUser:"exceldemo" srvPsw:"pfi4cj4qrj" timeTolerance:300 toleranceType:before
- </code>
- 
- Pro více informací spusťte:
- <code | runHelpInfo.bat>
- .\ESG.RcWareDb.DataExporter\ESG.RcWareDb.DataExporter.exe --help
- </code>
- 
- === Výstup ===
- Výstupní soubor je definován v konfiguračním souboru XML. Ukázkový výstup by měl vypadat následovně: 
- 
-     obrázek
- 
- === Celý příklad ke stažení: ===
- 
- Příklad: excelexporterdemo.zip
- */
- 
- 
-

Mervis Proxy

anonymous@undisclosed.example.com (Anonymous) — Mon, 22 Sep 2025 10:33:39 +0000

@@ -15,10 +15,10 @@
  {{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
  </WRAP>
  <WRAP half column 83%>
  **Poznámka:** \\
- U jednotek Unipi Patron a Neuron je žádanka zahrnuta v ceně a je součástí balení jednotky. U jednotek Unipi 1.1 a Gate lze žádanku získat buď nákupem [[https://www.unipi.technology/cs/unipi-1-1-kompletni-sada-p123|kompletní sady]], případně nákupem [[https://www.unipi.technology/cs/mervis-p56|samostatného produktu]]
+ U jednotek Unipi Patron a Neuron je žádanka zahrnuta v ceně a je součástí balení jednotky. U jednotek Unipi 1.1, Edge a Gate lze žádanku získat buď nákupem [[https://www.unipi.technology/cs/unipi-1-1-kompletni-sada-p123|kompletní sady]], případně nákupem [[https://www.unipi.technology/cs/mervis-p56|samostatného produktu]]
  </WRAP>
  </WRAP>
  
  ==== Proxy URL ====
  Veškeré Proxy URL naleznete v odkazu: [[cs:sw:01-mervis:urls-hidden#mervis_proxy|Seznam URL pro Mervis]].

Mervis SCADA

anonymous@undisclosed.example.com (Anonymous) — Thu, 06 Mar 2025 08:54:16 +0000

@@ -15,10 +15,8 @@
  
    * URL: [[https://scada.unipi.technology#/login?username=demo]]
    * Login: demo
    * Heslo: demo
- 
- SCADA rovněž může fungovat v místní instalaci na Vašem vlastním serveru. Na vyžádání Vám poskytneme více informací. 
  
  
  === Chci si SCADA pořídit!  ===
  Služba Mervis SCADA je již veřejně dostupná. Na [[mervis-scada-project-hidden|tomto odkazu]] naleznete podrobný tutoriál k vytvoření SCADA projektu.

Návody

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jul 2026 15:10:59 +0000

@@ -1,7 +1,5 @@
- ~~NOCACHE~~
  ==%hide Návody ==  
- == ==
  ====== Návody pro Mervis ======      
  ~~NOTOC~~  
  <WRAP center round box>
  <html><span class="kbBlueText">YouTube návody:</span></html>

PlcTool

anonymous@undisclosed.example.com (Anonymous) — Mon, 05 May 2025 14:04:44 +0000

@@ -28,12 +28,15 @@
  
  ===== Ke stažení =====
  Po stažení vybrané varianty je **nutné** archiv rozbalit.
  
+ <WRAP center round box>
    * {{ :files:software:mervis:plctool:plctool-1.0.27-linux-arm64.zip |PlcTool - Linux ARM64 (1.0.27)}}
    * {{ :files:software:mervis:plctool:plctool-1.0.27-linux-arm.zip |PlcTool - Linux ARM32 (1.0.27)}}
    * {{ :files:software:mervis:plctool:plctool-1.0.27-linux-x64.zip |PlcTool - Linux x64 (1.0.27)}}
    * {{ :files:software:mervis:plctool:plctool-1.0.27-win-x64.zip |PlcTool - Windows x64 (1.0.27)}}
+ </WRAP>
+ 
  
  **Staré** verze:
  
    * {{ :files:software:mervis:plctool:2023-11-01_plctool_linux-x64.zip |PlcTool - Linux x64 (1.0.0)}}

Certifikace Mervis

anonymous@undisclosed.example.com (Anonymous) — Mon, 28 Apr 2025 15:36:41 +0000

@@ -3,7 +3,13 @@
  
- <WRAP center round info 60%>
+ <WRAP group center round box 95%>
+ {{ :files:img_warning-line_b.png?nolink |}}
+ <WRAP half column 13%>
+ {{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
+ </WRAP>
+ <WRAP half column 83%>
  Pokud patříte mezi zkušené uživatele Mervisu a máte za sebou dokončené projekty založené na Mervisu, pro získání certifikace nám stačí zaslat jeden z Vašich projektů.
+ </WRAP>
  </WRAP>
  
  ===== Řízení teploty a světel v místnosti =====
  Vaším úkolem je realizovat řízení vytápění a osvětlení v jedné místnosti. Veškeré HW