> For the complete documentation index, see [llms.txt](https://portal-integracao.intelbras.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portal-integracao.intelbras.com.br/mip-1000-ip/configuracoes-do-dispositivo/configurar-labels.md).
# Configurar Labels
O comando configurar alguns labels do sistema (CL) é utilizado para realizar as operações de RU (acrônimo de Read Update) nos dados de alguns labels do sistema. O valor para identificar o comando CL é `0x10`. Esse comando é utilizado sempre que algum dispositivo desejar alterar ou buscar dados no MIP sobre as configurações de alguns labels do sistema.
As manutenções referentes a atualizar e buscar configurações de alguns labels do sistema podem ser realizadas através de qualquer dispositivo com acesso ao MIP. Esse comando é complementado através de flags de apoio que sinalizam a opção desejada, ou seja, através do campo "flag" é sinalizado a operação que se deseja realizar com a configuração de alguns labels do sistema, alteração (`ALTERAR_RECURSO`) ou busca dos dados (`BUSCAR_RECURSO`).
A flag de busca (flag `BUSCAR_RECURSO`) necessita que, ao ser enviada para o MIP 1000 IP, o campo "dados" deste comando seja um e consequentemente o campo "tamanho do campo de dados" será de `0x01 00`. A informação a ser enviada no campo de dados é a descrita abaixo:
| Identificador do label |
| ---------------------- |
| 1 Byte |
**Descrição dos campos do comando:**
| Campo | Descrição |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Identificador do label | Número único que identifica o label a ser alterado. Os valores possíveis são: 0 – Apartamento; 1 – Nível 1; 2 – Nível 2; 3 – Nível 3; 4 – Nível 4; (5 – Bloco; 6 – Andar)\*Não implementado; |
Este comando com a flag de `BUSCAR_RECURSO` tem como resposta o datagrama padrão enviado pelo MIP e com o campo de dados zerado se for encontrado ou houver algum problema sinalizado pelas flags abaixo, exceto `SUCESSO`.
| Flag | Descrição |
| ------------ | ------------------------------------------------------------ |
| SUCESSO | Enviado caso a operação tenha sido realizada com sucesso. |
| FALHA | Sinaliza falha na execução da operação solicitada. |
| ERRO\_CHKS | Enviado se ocorreu um erro de CHKS na conferência dos dados. |
| COMANDO\_INV | Sinaliza o recebimento de um comando inválido, desconhecido. |
Caso o comando tenha sido executado com sucesso o datagrama retornará com a flag `SUCESSO` e com o campo de dados com os seguintes dados com seu tamanho dado em bytes:
| Identificador do label | Label |
| ---------------------- | ---------------------------------------------------- |
| 1 Byte | 4 bytes – para Apto
10 Bytes – para níveis
|
**Descrição dos campos do comando:**
| Campo | Descrição |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Identificador do label | Número único que identifica o label a ser alterado. Os valores possíveis são: 0 – Apartamento; 1 – Nível 1; 2 – Nível 2; 3 – Nível 3; 4 – Nível 4; (5 – Bloco; 6 – Andar)\*Não implementado; |
| Label | Campo que contém o nome do label com caracteres no formato ASCII. Os dados desse campo possuem o seguinte formato: exemplo para o Nome: Paulo => MSB `0x50 61 75 6C 6F 00 ... 00` LSB. As posições (bytes) restantes do campo que não serão utilizados devem ser completadas com `0x00`. |
Este comando com a flag de `ALTERAR_RECURSO` ao ser enviado para o MIP 1000 IP, permite com que a configuração de alguns labels do sistema seja editada. Neste caso o datagrama a ser enviado para o MIP 1000 IP deve ter no seu campo de dados as seguintes informações abaixo com o preenchimento obedecendo a tabela acima. O campo de dados deve ficar assim:
| Identificador do label | Label |
| ---------------------- | ---------------------------------------------------- |
| 1 Byte | 4 bytes – para Apto
10 Bytes – para níveis
|
Com o uso desta flag de alteração, o MIP 1000 IP pode retornar todas as flags abaixo, mostrando se o comando foi efetivo ou não. O datagrama terá o tamanho padrão com as flags:
| Flag | Descrição |
| ------------ | ------------------------------------------------------------ |
| SUCESSO | Enviado caso a operação tenha sido realizada com sucesso. |
| FALHA | Sinaliza falha na execução da operação solicitada. |
| ERRO\_CHKS | Enviado se ocorreu um erro de CHKS na conferência dos dados. |
| COMANDO\_INV | Sinaliza o recebimento de um comando inválido, desconhecido. |
---
# 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://portal-integracao.intelbras.com.br/mip-1000-ip/configuracoes-do-dispositivo/configurar-labels.md?ask=&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.