> 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-equipamento/configurar-teclas.md).

# Configurar Teclas

O comando configurar tecla (CT) é utilizado para realizar as operações de RU (acrônimo de Read Update) nos dados das teclas. O valor para identificar o comando CT é `0x0B`. Esse comando é utilizado sempre que algum dispositivo desejar alterar ou buscar dados no MIP sobre as teclas de acionamento.

As manutenções referentes a atualizar e buscar configurações das teclas podem ser realizadas através de qualquer dispositivo com acesso ao MIP 1000 IP. 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 as teclas, 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 zero e consequentemente o campo "tamanho do campo de dados" será de `0x00 00`.

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 o ID não 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 da tecla | ID do dispositivo | Identificador da saída |
| ---------------------- | ----------------- | ---------------------- |
| 1 Byte                 | 4 Bytes           | 1 Byte                 |

**Descrição dos campos do comando:**

| Campo                  | Descrição                                                                                                                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Identificador da tecla | Esse campo contém um número para identificar a tecla que se deseja configurar. Onde 0 é a primeira tecla e 4 a última.                                                                            |
| ID do dispositivo      | Campo que possui um número único identificador do dispositivo. Este valor é sempre maior que zero. Os dados desse campo possuem o seguinte formato: Exemplo para o ID: 1 MSB `0x01 00 00 00` LSB. |
| Identificador da saída | Esse campo contém um número para identificar a saída do respectivo dispositivo que se deseja acionar. Sendo `0x01` para a primeira saída do dispositivo e `0x08` para a última.                   |

Este comando com a flag de `ALTERAR_RECURSO` ao ser enviado para o MIP 1000 IP, permite com que a configuração das teclas 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 da tecla | ID do dispositivo | Identificador da saída |
| ---------------------- | ----------------- | ---------------------- |
| 1 Byte                 | 4 Bytes           | 1 Byte                 |

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-equipamento/configurar-teclas.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.
