> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/myrspoven-docs/docs-us-cs/integrace/overview/bms-integrations/siemens.md).

# Siemens

Integrace Siemens pokrývá dvě platformy. **Siemens Building X (BPCloud)** je cloudová platforma a doporučená cesta pro nové lokality — podrobnosti níže. **Siemens Desigo CC** je starší on-premise platforma, stále podporovaná, ale vyžadující ruční nastavení virtuálních signálů v BMS; shrnuto na konci. Tyto dvě cesty nemají žádné předpoklady společné.

## Siemens Building X (BPCloud)

### Co integrace dělá

myCoreAI se připojuje k tenantovi Building X přes jeho veřejné JSON:API, aby zjistil zařízení a body, četl aktuální i historické hodnoty a zapisoval číselné žádané hodnoty, kde je to povoleno. Zjišťování automaticky mapuje zařízení, přístroje a body Building X na systémy, komponenty a signály Myrspoven.

* **Styl API:** JSON:API přes HTTPS
* **Autentizace:** přihlašovací údaje klienta OAuth2
* **Základní URL:** `https://api.bpcloud.siemens.com/`

### Požadavky na přístup

Myrspoven potvrzuje požadovaný rozsah přístupu během onboardingu. Přístup pro čtení podporuje analýzu a reporting. Přístup pro zápis je vyžadován pouze tehdy, když myCoreAI řídí žádané hodnoty.

### Zjišťování

Zjišťování importuje dostupná zařízení a body. Myrspoven je během onboardingu mapuje na požadované systémy, komponenty a signály.

### Skupiny bodů a strategie zálohy

Skupiny bodů Building X přiřazují body k zařízením. Myrspoven toto přiřazení používá během zjišťování.

### Čtení a zápis hodnot

myCoreAI čte aktuální i historické hodnoty. Zapisuje číselné žádané hodnoty, kde je to povoleno, a watchdog aktualizuje až po úspěšném zápisu.

### Podporovaná zařízení a typy signálů

Mapování signálů používá typy zařízení a sémantické štítky.

| Rodina zařízení                  | Systém Myrspoven       | Příklad umístění signálů                                                 |
| -------------------------------- | ---------------------- | ------------------------------------------------------------------------ |
| Vzduchotechnická jednotka (AHU)  | Větrání                | Teplota přívodního/odtahového vzduchu, tlak, průtok, CO₂, žádané hodnoty |
| Koncová jednotka (VAV/CAV)       | Větrání                | Řízení zóny, komfortní veličiny, poloha klapky                           |
| Hydronický okruh                 | Vytápění               | Teploty přívodu/odvodu, žádané hodnoty, poloha ventilu, stav čerpadla    |
| Chlazení (chiller, chladicí věž) | Chlazení               | Teploty chilleru, voda v kondenzátoru, signály chladicí věže             |
| Výměník tepla                    | Topení / Chlazení      | Polohy ventilu přívodu/odvodu, bypassu a uzavíracího ventilu             |
| Měřič energie                    | Energie                | Body spotřeby energie                                                    |
| Pozorovatelné senzory            | Pozorovatelné veličiny | Počasí, komfort v místnosti, CO₂, obsazenost                             |

Zařízení mimo tento seznam stále dokončí zjišťování. Myrspoven během onboardingu prověří nespárované body.

### Kontrolní seznam onboardingu

* Udělejte schválený přístup pro čtení a případně i pro zápis.
* Koordinujte přístup s Myrspoven prostřednictvím dohodnutého kanálu.

## Starší verze: Desigo CC (on-premise)

Starší nasazení Siemens používají místo Building X lokální Desigo CC. Model integrace se zásadně liší: namísto cloudového API se strukturovanými metadaty zařízení komunikuje myCoreAI prostřednictvím virtuálních signálů vytvořených přímo v samotném BMS.

Tato cesta je stále podporována, ale pro nové lokality už není doporučována. Lokality Desigo CC se onboardují případ od případu s Myrspoven, protože přesné rozvržení virtuálních signálů závisí na tom, které signály se čtou a které zapisují.

Obecné kroky:

1. Spusťte zjišťování vůči BMS, aby se vypsaly dostupné signály.
2. Vyberte signály pro čtení a zápis.
3. Vytvořte požadované virtuální signály přímo v BMS (jednorázové ruční nastavení pro každou budovu).
4. Spusťte zjišťování znovu, aby se načetly virtuální signály.
5. Potvrďte výslednou strukturu v Myrspoven.

Rozvržení složek virtuálních signálů, zpracování watchdogu a záložní chování jsou koordinovány případ od případu s Myrspoven, aby nedošlo k narušení provozu živého BMS.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myrspoven.com/myrspoven-docs/docs-us-cs/integrace/overview/bms-integrations/siemens.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.