> 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/cameras-and-gravadores/integracao-api-cftvip-e-mibo/cameras-e-gravadores/configuracoes-do-sistema.md).

# Configurações do Sistema

Integração de configurações via CGI (configManager/devVideoInput): brilho/contraste, nitidez, flip/mirror/rotate, exposição, balanço de branco, dia/noite, foco/zoom e iluminação.

### Definições de Configuração

> Esta documentação apresenta os recursos de configuração e controle de câmeras, detalhando os principais parâmetros de imagem e vídeo como: brilho, contraste, exposição, foco, zoom, balanço de branco, modo dia/noite e iluminação, além dos formatos de requisição e exemplos de uso por meio de API HTTP.

***

## Dicas & Boas Práticas <a href="#dicas-and-boas-praticas" id="dicas-and-boas-praticas"></a>

* `[0][0]`: Indica o canal utilizado e pode ser alterado conforme a necessidade.
* `VideoInFocus`: Prioriza a qualidade do vídeo, melhorando foco e nitidez.
* `Mode`: Define o funcionamento do sistema, pode ser **Automático**, **Manual** ou **Teste**, conforme a situação.
  * **Modo Automático:** O sistema funciona sozinho, tomando decisões sem intervenção humana.
  * **Modo Teste:** Usado para verificar se tudo está funcionando corretamente antes do uso real.
  * **Modo Manual:** O usuário controla todas as ações diretamente.
* Utilize configurações diferentes para **Day** e **Night,** ajustando cada um de acordo com as condições de luz do ambiente.
* Aumentar demais a **nitidez** pode gerar **ruído e artefatos** na imagem.

***

### Configurar Brilho, Contraste e Saturação

**Tópico:** Ajustar configurações de Vídeo da câmera como: **Brilho, Contraste e Saturação.**

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoColor`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoColor"
```

**Resposta:**

```
table.VideoColor[0][0].Brightness=50
table.VideoColor[0][0].ChromaSuppress=50
table.VideoColor[0][0].Contrast=50
table.VideoColor[0][0].Gamma=50
table.VideoColor[0][0].Hue=50
table.VideoColor[0][0].Name=Day
table.VideoColor[0][0].Saturation=50
table.VideoColor[0][0].Style=Standard
table.VideoColor[0][0].TimeSection=1 00:00:00-24:00:00
table.VideoColor[0][1].Brightness=50
table.VideoColor[0][1].ChromaSuppress=50
table.VideoColor[0][1].Contrast=50
table.VideoColor[0][1].Gamma=50
table.VideoColor[0][1].Hue=50
table.VideoColor[0][1].Name=Night
table.VideoColor[0][1].Saturation=50
table.VideoColor[0][1].Style=Standard
table.VideoColor[0][1].TimeSection=0 00:00:00-24:00:00
```

### Parâmetros da Tabela VideoColor

<table><thead><tr><th width="317">Parâmetro completo</th><th width="156">Descrição</th><th width="182">Valor de Exemplo</th></tr></thead><tbody><tr><td><code>table.VideoColor[0][0].Name</code></td><td>Nome do perfil</td><td><code>Day</code></td></tr><tr><td><code>table.VideoColor[0][0].Brightness</code></td><td>Brilho</td><td><code>50</code></td></tr><tr><td><code>table.VideoColor[0][0].Contrast</code></td><td>Contraste</td><td><code>50</code></td></tr><tr><td><code>table.VideoColor[0][0].Saturation</code></td><td>Saturação</td><td><code>50</code></td></tr><tr><td><code>table.VideoColor[0][0].Hue</code></td><td>Matiz (Hue)</td><td><code>50</code></td></tr><tr><td><code>table.VideoColor[0][0].Gamma</code></td><td>Gamma</td><td><code>50</code></td></tr><tr><td><code>table.VideoColor[0][0].ChromaSuppress</code></td><td>Supressão de Chroma</td><td><code>50</code></td></tr><tr><td><code>table.VideoColor[0][0].Style</code></td><td>Estilo de imagem</td><td><code>Standard</code></td></tr><tr><td><code>table.VideoColor[0][0].TimeSection</code></td><td>Período de aplicação</td><td><code>1 00:00:00-24:00:00</code></td></tr></tbody></table>

### Exemplo de Definição de Brilho

**Tópico:** Definir brilho desejado com o parâmetro

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoColor[0][0].Brightness=50`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd \
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoColor[0][0].Brightness=50 "
```

**Resposta:**

```
OK
```

***

### Nitidez <a href="#data-hora-e-fuso" id="data-hora-e-fuso"></a>

**Tópico:** Obter ajuste de nitidez

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInSharpness`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd \
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInSharpness "
```

**Resposta:**

```
table.VideoInSharpness[0][0].Level=50
table.VideoInSharpness[0][0].Mode=1
table.VideoInSharpness[0][0].Name=Day
table.VideoInSharpness[0][0].Sharpness=50
table.VideoInSharpness[0][1].Level=50
table.VideoInSharpness[0][1].Mode=1
table.VideoInSharpness[0][1].Name=Night
table.VideoInSharpness[0][1].Sharpness=50
```

#### **Tabela de Parâmetros – VideoInSharpness**

<table><thead><tr><th width="355">Parâmetro completo</th><th>Descrição</th><th>Valor</th></tr></thead><tbody><tr><td><code>table.VideoInSharpness[0][0].Mode</code></td><td>Modo de nitidez</td><td>1</td></tr><tr><td><code>table.VideoInSharpness[0][0].Level</code></td><td>Nível de processamento</td><td>50</td></tr><tr><td><code>table.VideoInSharpness[0][0].Sharpness</code></td><td>Nitidez</td><td>50</td></tr></tbody></table>

### Exemplo de Ajuste de Nitidez

**Tópico:** Ajustar nitidez da câmera com parâmetros

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInSharpness[0][0].Level=10&Vid`\
  `eoInSharpness[0][0].Mode=1&VideoInSharpness[0][0].Sharpness=0`

**Exemplo**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInSharpness[0][0].Level=10&Vid
eoInSharpness[0][0].Mode=1&VideoInSharpness[0][0].Sharpness=0 "
```

**Resposta:**

```
OK
```

***

### Virar, Espelhar e Girar 90

**Tópico**: Obter configuração de parâmetros gerais incluindo, virar, espelhar e girar 90

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoImageControl`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoImageControl "
```

**Resposta:**

```
table.VideoImageControl[0].Flip=false
table.VideoImageControl[0].FlipMode=Manual
table.VideoImageControl[0].Freeze=false
table.VideoImageControl[0].Mirror=false
table.VideoImageControl[0].Rotate90=0
table.VideoImageControl[0].Stable=0
```

### **Parâmetros de Vídeo**

<table><thead><tr><th width="317">Parâmetro completo</th><th>Descrição</th><th>Valor</th></tr></thead><tbody><tr><td><code>table.VideoImageControl[0].Flip</code></td><td>Inverter imagem (Flip)</td><td>false</td></tr><tr><td><code>table.VideoImageControl[0].FlipMode</code></td><td>Modo de inversão</td><td>Manual</td></tr><tr><td><code>table.VideoImageControl[0].Freeze</code></td><td>Congelar imagem</td><td>false</td></tr><tr><td><code>table.VideoImageControl[0].Mirror</code></td><td>Espelhamento da imagem</td><td>false</td></tr><tr><td><code>table.VideoImageControl[0].Rotate90</code></td><td>Rotação 90°</td><td>0</td></tr></tbody></table>

### **Exemplo de Ajuste Com Parâmetros**

**Tópico:** Ajuste de vídeo invertando imagem

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoImageControl[0].Flip=true`

**Exemplos**:

```powershell
curl --digest -u admin:pwd \
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoImageControl[0].Flip=true "
```

**Resposta:**

```
OK
```

***

### Exposição <a href="#informacoes-do-dispositivo" id="informacoes-do-dispositivo"></a>

**Tópico:** Obter configuração de exposição

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInExposure`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInExposure"
```

**Resposta:**

```
table.VideoInExposure[0][0].AntiFlicker=0
table.VideoInExposure[0][0].AutoGainMax=2
table.VideoInExposure[0][0].Backlight=0
table.VideoInExposure[0][0].BacklightRegion[0]=3096
table.VideoInExposure[0][0].BacklightRegion[1]=3096
table.VideoInExposure[0][0].BacklightRegion[2]=5096
table.VideoInExposure[0][0].BacklightRegion[3]=5096
table.VideoInExposure[0][0].Compensation=50
table.VideoInExposure[0][0].DoubleExposure=0
table.VideoInExposure[0][0].Gain=1
table.VideoInExposure[0][0].GainMax=50
table.VideoInExposure[0][0].GainMin=0
table.VideoInExposure[0][0].GlareInhibition=0
table.VideoInExposure[0][0].Iris=50
table.VideoInExposure[0][0].IrisAuto=true
table.VideoInExposure[0][0].IrisMax=50
table.VideoInExposure[0][0].IrisMin=0
table.VideoInExposure[0][0].Mode=8
table.VideoInExposure[0][0].Name=Day
table.VideoInExposure[0][0].RecoveryTime=900
table.VideoInExposure[0][0].Rect[0]=0
table.VideoInExposure[0][0].Rect[1]=0
table.VideoInExposure[0][0].Rect[2]=0
table.VideoInExposure[0][0].Rect[3]=0
table.VideoInExposure[0][0].SlowAutoExposure=0
table.VideoInExposure[0][0].SlowShutter=false
table.VideoInExposure[0][0].SlowSpeed=25
table.VideoInExposure[0][0].Value1=0.000000
table.VideoInExposure[0][0].Value2=10.000000
table.VideoInExposure[0][0].WideDynamicRange=0
table.VideoInExposure[0][0].WideDynamicRangeMode=0
```

### **Parâmetros de Vídeo**

<table><thead><tr><th width="424">Parâmetro completo</th><th width="215.77783203125">Descrição</th><th width="151" align="center">Valor</th></tr></thead><tbody><tr><td><code>table.VideoInExposure[0][0].AntiFlicker</code></td><td>Anti‐flicker</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].Gain</code></td><td>Ganho</td><td align="center">1</td></tr><tr><td><code>table.VideoInExposure[0][0].GainMin</code></td><td>Ganho mínimo</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].GainMax</code></td><td>Ganho máximo</td><td align="center">50</td></tr><tr><td><code>table.VideoInExposure[0][0].AutoGainMax</code></td><td>Limite automático de ganho</td><td align="center">2</td></tr><tr><td><code>table.VideoInExposure[0][0].IrisAuto</code></td><td>Íris automática</td><td align="center">true</td></tr><tr><td><code>table.VideoInExposure[0][0].Iris</code></td><td>Íris</td><td align="center">50</td></tr><tr><td><code>table.VideoInExposure[0][0].IrisMin</code></td><td>Íris mínima</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].IrisMax</code></td><td>Íris máxima</td><td align="center">50</td></tr><tr><td><code>table.VideoInExposure[0][0].SlowShutter</code></td><td>Obturador lento</td><td align="center">false</td></tr><tr><td><code>table.VideoInExposure[0][0].SlowSpeed</code></td><td>Velocidade lenta</td><td align="center">25</td></tr><tr><td><code>table.VideoInExposure[0][0].SlowAutoExposure</code></td><td>Auto exposição lenta</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].RecoveryTime</code></td><td>Tempo de recuperação</td><td align="center">900</td></tr><tr><td><code>table.VideoInExposure[0][0].Backlight</code></td><td>Compensação de contraluz</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].BacklightRegion[0]</code></td><td>Região de contraluz X1</td><td align="center">3096</td></tr><tr><td><code>table.VideoInExposure[0][0].BacklightRegion[1]</code></td><td>Região de contraluz Y1</td><td align="center">3096</td></tr><tr><td><code>table.VideoInExposure[0][0].BacklightRegion[2]</code></td><td>Região de contraluz X2</td><td align="center">5096</td></tr><tr><td><code>table.VideoInExposure[0][0].BacklightRegion[3]</code></td><td>Região de contraluz Y2</td><td align="center">5096</td></tr><tr><td><code>table.VideoInExposure[0][0].DoubleExposure</code></td><td>Dupla exposição</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].GlareInhibition</code></td><td>Redução de ofuscamento</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].WideDynamicRange</code></td><td>WDR</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].WideDynamicRangeMode</code></td><td>Modo WDR</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].Rect[0]</code></td><td>Área de medição X1</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].Rect[1]</code></td><td>Área de medição Y1</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].Rect[2]</code></td><td>Área de medição X2</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].Rect[3]</code></td><td>Área de medição Y2</td><td align="center">0</td></tr><tr><td><code>table.VideoInExposure[0][0].Value1</code></td><td>Parâmetro auxiliar 1</td><td align="center">0.000000</td></tr><tr><td><code>table.VideoInExposure[0][0].Value2</code></td><td>Parâmetro auxiliar 2</td><td align="center">10.000000</td></tr></tbody></table>

### **Exemplo de Ajuste Com Parâmetros**

**Tópico:** Ajuste de vídeo invertando imagem

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInExposure[0][0].Iris=50`

**Exemplos**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInExposure[0][0].Iris=50 "
```

**Resposta:**

```
OK
```

***

### Iluminação de Fundo <a href="#informacoes-do-dispositivo" id="informacoes-do-dispositivo"></a>

**Tópico:** Obter configuração de parâmetros gerais incluindo, virar, espelhar e girar 90

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInBacklight`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInBacklight"
```

**Resposta:**

```
table.VideoInBacklight[0][0].BacklightMode=Default
table.VideoInBacklight[0][0].BacklightRegion[0]=3096
table.VideoInBacklight[0][0].BacklightRegion[1]=3096
table.VideoInBacklight[0][0].BacklightRegion[2]=5096
table.VideoInBacklight[0][0].BacklightRegion[3]=5096
table.VideoInBacklight[0][0].GlareInhibition=50
table.VideoInBacklight[0][0].Intensity=50
table.VideoInBacklight[0][0].IntensityMode=Disable
table.VideoInBacklight[0][0].Mode=Off
table.VideoInBacklight[0][0].Name=Day
table.VideoInBacklight[0][0].WideDynamicRange=50
```

### **Parâmetros de Vídeo**

<table><thead><tr><th width="421">Parâmetro completo</th><th width="214">Descrição</th><th width="127" align="center">Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><code>table.VideoInBacklight[0][0].BacklightMode</code></td><td>Tipo de processamento de contraluz</td><td align="center">Default</td><td></td></tr><tr><td><code>table.VideoInBacklight[0][0].Intensity</code></td><td>Intensidade do efeito</td><td align="center">50</td><td></td></tr><tr><td><code>table.VideoInBacklight[0][0].IntensityMode</code></td><td>Controle automático de intensidade</td><td align="center">Disable</td><td></td></tr><tr><td><code>table.VideoInBacklight[0][0].GlareInhibition</code></td><td>Redução de ofuscamento</td><td align="center">50</td><td></td></tr><tr><td><code>table.VideoInBacklight[0][0].WideDynamicRange</code></td><td>WDR</td><td align="center">50</td><td></td></tr></tbody></table>

### **Exemplo de Ajuste Com Parâmetros**

**Tópico:** Ajuste de vídeo de redução de ofuscamento

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInBacklight[0][0].GlareInhibition =50`

**Exemplos**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInBacklight[0][0].GlareInhibition
=50 "
```

**Resposta:**

```
OK
```

***

### Balanço de Branco <a href="#informacoes-do-dispositivo" id="informacoes-do-dispositivo"></a>

**Tópico:** Obter configuração de balanço de branco

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInWhiteBalance`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInWhiteBalance"
```

**Resposta:**

```
table.VideoInWhiteBalance[0][0].ColorTemperatureLevel=50
table.VideoInWhiteBalance[0][0].GainBlue=80
table.VideoInWhiteBalance[0][0].GainGreen=80
table.VideoInWhiteBalance[0][0].GainRed=80
table.VideoInWhiteBalance[0][0].ManualDatumRect[0]=3096
table.VideoInWhiteBalance[0][0].ManualDatumRect[1]=3096
table.VideoInWhiteBalance[0][0].ManualDatumRect[2]=5096
table.VideoInWhiteBalance[0][0].ManualDatumRect[3]=5096
table.VideoInWhiteBalance[0][0].Mode=Auto
table.VideoInWhiteBalance[0][0].Name=Day
```

### **Parâmetros de Vídeo**

<table><thead><tr><th width="371">Parâmetro completo</th><th>Descrição</th><th width="84">Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><code>table.VideoInWhiteBalance[0][0].ColorTemperatureLevel</code></td><td>Nível de temperatura de cor</td><td>50</td><td></td></tr><tr><td><code>table.VideoInWhiteBalance[0][0].GainRed</code></td><td>Ganho do canal vermelho</td><td>80</td><td></td></tr><tr><td><code>table.VideoInWhiteBalance[0][0].GainGreen</code></td><td>Ganho do canal verde</td><td>80</td><td></td></tr><tr><td><code>table.VideoInWhiteBalance[0][0].GainBlue</code></td><td>Ganho do canal azul</td><td>80</td><td></td></tr></tbody></table>

### **Exemplo de Ajuste com Parâmetros**

**Tópico:** Ajuste de vídeo de ganho de canal azul

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInWhiteBalance[0][0].GainBlue= 50`

**Exemplos**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInWhiteBalance[0][0].GainBlue=
50 "
```

**Resposta:**

```
OK
```

***

### Dia-Noite

**Tópico:** Obter configuração de dia-noite

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInDayNight`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInDayNight "
```

**Resposta:**

```
table.VideoInDayNight[0][0].Delay=2
table.VideoInDayNight[0][0].Mode=Brightness
table.VideoInDayNight[0][0].Name=Day
table.VideoInDayNight[0][0].Sensitivity=2
table.VideoInDayNight[0][0].Type=Mechanism
```

### **Parâmetros de Vídeo**

<table><thead><tr><th width="358">Parâmetro completo</th><th>Descrição</th><th align="center">Valor</th></tr></thead><tbody><tr><td><code>table.VideoInDayNight[0][0].Mode</code></td><td>Critério de comutação Dia/Noite</td><td align="center">Brightness</td></tr><tr><td><code>table.VideoInDayNight[0][0].Type</code></td><td>Tipo de mecanismo</td><td align="center">Mechanism</td></tr><tr><td><code>table.VideoInDayNight[0][0].Sensitivity</code></td><td>Sensibilidade de detecção</td><td align="center">2</td></tr><tr><td><code>table.VideoInDayNight[0][0].Delay</code></td><td>Atraso de comutação (s)</td><td align="center">2</td></tr></tbody></table>

### **Exemplo de Ajuste Com Parâmetros**

**Tópico:** Ajuste de vídeo invertando imagem

* Método: `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInDayNight[0][0].Mode=BlackW hite`

**Exemplos**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInDayNight[0][0].Mode=BlackW
hite  "
```

**Resposta:**

```
OK
```

***

### Ajustar Foco

* Método: `GET /cgi-bin/devVideoInput.cgi?action=adjustFocus`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=adjustFocus  "
```

#### Tabela de Parâmetros

| Nome      | Tipo   | Descrição                                                                  | Exemplo |
| --------- | ------ | -------------------------------------------------------------------------- | ------- |
| `channel` | int    | Número do canal de vídeo (inicia em 1). Valor padrão: 1.                   | `1`     |
| `focus`   | double | Posição relativa do motor de foco. Intervalo: `[0–1]`. `-1` executa reset. | `0.5`   |
| `zoom`    | double | Posição relativa do motor de zoom. Intervalo: `[0–1]`. `-1` executa reset. | `-0.5`  |

**Exemplo:**

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=adjustFocus&focus=0.5&zoom=-0.5 "
```

***

### Ajustar o Foco Continuamente

* Método: `GET /cgi-bin/devVideoInput.cgi?action=adjustFocusContinuously`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=adjustFocusContinuously    "
```

#### Tabela de Parâmetros

<table><thead><tr><th width="162">Nome</th><th width="135">Tipo</th><th>Descrição</th><th width="115" align="center">Exemplo</th></tr></thead><tbody><tr><td><code>channel</code></td><td>int</td><td>Número do canal de vídeo (inicia em 1). Valor padrão: 1.</td><td align="center"><code>1</code></td></tr><tr><td><code>focus</code></td><td>double</td><td>Taxa relativa de foco. Intervalo: <code>[-1, 1]</code><br><code>-1</code>: Nenhuma operação<br><code>0</code>: Parar<br>Valor positivo: mover para frente<br>Valor negativo: mover para trás</td><td align="center"><code>0.02</code></td></tr><tr><td><code>zoom</code></td><td>double</td><td>Taxa relativa de zoom. Intervalo: <code>[-1, 1]</code><br><code>-1</code>: Nenhuma operação<br><code>0</code>: Parar<br>Valor positivo: mover para frente</td><td align="center"></td></tr></tbody></table>

**Exemplo:**

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=adjustFocusContinuously&channel=1&focus=0.0
2&zoom=-1  "
```

***

### Foco Automático

* Método: `GET /cgi-bin/devVideoInput.cgi?action=autoFocus`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=autoFocus  "
```

#### Tabela de Parâmetros

| Nome      | Tipo | Descrição                                                | Exemplo |
| --------- | ---- | -------------------------------------------------------- | ------- |
| `channel` | int  | Número do canal de vídeo (inicia em 1). Valor padrão: 1. | `1`     |

**Exemplo:**

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=autoFocus&channel=1  "
```

***

### Obter Status De Foco

* Método: `GET /cgi-bin/devVideoInput.cgi?action=getFocusStatus`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=getFocusStatus   "
```

#### Tabela de Parâmetros

| Nome      | Tipo | Descrição                                                | Exemplo |
| --------- | ---- | -------------------------------------------------------- | ------- |
| `channel` | int  | Número do canal de vídeo (inicia em 1). Valor padrão: 1. | `1`     |

**Exemplo:**

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/devVideoInput.cgi?action=getFocusStatus&channel=1  "
```

***

### Definir Foco

* Método: `GET /cgi-bin/api/devVideoInput/setFocus`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/api/devVideoInput/setFocus   "
```

#### Tabela de Parâmetros

| Nome        | Tipo | Descrição                                                                                                                                 | Exemplo |
| ----------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `Channel`   | uint | Número do canal de vídeo, iniciando em 0. Valor padrão: 0.                                                                                | `0`     |
| `FocusType` | uint | <p>Tipo de foco.<br><code>1</code>: Foco por auto-aprendizado.<br>Valor padrão: <code>0</code> (quando 0, não possui efeito prático).</p> | `1`     |

**Exemplo:**

```powershell
{ 
"Channel ": 0, 
“FocusType”:1 
}
```

***

### Configuração de Zoom

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInZoom`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInZoom"
```

#### Tabela de Parâmetros

| Nome           | Tipo         | Descrição                                                                                                                                                                                                                                                                                                                         | Exemplo |
| -------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `VideoInZoom`  | object\[]\[] | <p>Parâmetro de configuração de zoom; matriz bidimensional.<br>A primeira dimensão representa o canal de vídeo (inicia em 1).<br>A segunda dimensão representa o cenário de iluminação.<br>Os três primeiros elementos representam, respectivamente: <strong>Day</strong>, <strong>Night</strong> e <strong>General</strong>.</p> | —       |
| `+Name`        | char\[16]    | Nome do cenário                                                                                                                                                                                                                                                                                                                   | `"Day"` |
| `+Speed`       | int          | Velocidade do zoom; intervalo: `[0–100]`                                                                                                                                                                                                                                                                                          | `8`     |
| `+DigitalZoom` | bool         | Habilita/desabilita zoom digital                                                                                                                                                                                                                                                                                                  | `true`  |

**Exemplo:**

```powershell
curl --digest -u admin:pwd 
  "/cgi-bin/configManager.cgi?action=setConfig&VideoInZoom[0][0].DigitalZoom=false
&VideoInZoom[0][0].Speed=8 "
```

***

### Configuração de Foco

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInFocus`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInFocus "
```

#### Tabela de Parâmetros

<table><thead><tr><th>Nome</th><th width="108.85186767578125">Tipo</th><th>Descrição</th><th width="102" align="center">Exemplo</th></tr></thead><tbody><tr><td><code>VideoInFocus</code></td><td>object[][]</td><td>Parâmetro de configuração de foco vari-focal; matriz bidimensional.<br>A primeira dimensão representa o canal de vídeo (inicia em 1).<br>A segunda dimensão representa o cenário de iluminação.<br>Os três primeiros elementos representam: <strong>Day</strong>, <strong>Night</strong> e <strong>General</strong>.</td><td align="center">—</td></tr><tr><td><code>+Name</code></td><td>char[16]</td><td>Nome do cenário</td><td align="center"><code>"Day"</code></td></tr><tr><td><code>+Mode</code></td><td>int</td><td>Modo de foco:<br><code>2</code>: Auto focus<br><code>3</code>: Semi-auto (usa AF e depois trava o foco; ajuste manual necessário)<br><code>4</code>: Foco manual</td><td align="center"><code>2</code></td></tr><tr><td><code>+FocusLimit</code></td><td>int</td><td>Limite recomendado de foco próximo (mm). Intervalo depende do dispositivo.</td><td align="center"><code>2000</code></td></tr><tr><td><code>+FocusFarLimit</code></td><td>int</td><td>Limite recomendado de foco distante (mm). Intervalo depende do dispositivo.</td><td align="center"><code>5000</code></td></tr><tr><td><code>+AutoFocusTrace</code></td><td>int</td><td>Rastreamento vari-focal:<br><code>0</code>: Desligado<br><code>1</code>: Ligado</td><td align="center"><code>1</code></td></tr><tr><td><code>+IRCorrection</code></td><td>int</td><td>Correção de foco IR:<br><code>0</code>: Sem correção<br><code>1</code>: Correção manual<br><code>2</code>: Correção automática</td><td align="center"><code>1</code></td></tr><tr><td><code>+Sensitivity</code></td><td>int</td><td>Sensibilidade de foco:<br><code>0</code>: Alta<br><code>1</code>: Padrão<br><code>2</code>: Baixa</td><td align="center"><code>1</code></td></tr><tr><td><code>+FocusLimitSelectMode</code></td><td>char[16]</td><td>Modo de limite de foco próximo:<br><code>"Manual"</code> ou <code>"Auto"</code></td><td align="center"><code>"Auto"</code></td></tr></tbody></table>

**Exemplo:**

```powershell
curl --digest -u admin:pwd 
  "http:/<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInFocus[0][0].FocusLimit=2000
&VideoInFocus[0][0].FocusFarLimit=5000&VideoInFocus[0][0].Sensitivity=1 "
```

***

### Vídeo Sem Foco

* O evento **VideoUnFocus** é gerado quando o sistema detecta que a imagem está fora de foco.

#### **Informações do Evento**

| Campo                       | Descrição          |
| --------------------------- | ------------------ |
| **Event Code**              | `VideoUnFocus`     |
| **Evento disparado quando** | O vídeo perde foco |
| **Event Index**             | `0`                |
| **Event Action**            | `Start` / `Stop`   |

#### **Formato da Resposta do Evento**

**Tipo:** `multipart`\
**Formato do corpo:** `key=value` + dados binários

**Exemplo de Resposta**

```
--<boundary>
Content-Type: text/plain
Content-Length: <length>

Events[0].EventBaseInfo.Code=VideoUnFocus
Events[0].EventBaseInfo.Action=Start
Events[0].EventBaseInfo.Index=0
……
--<boundary>
Content-Type: image/jpeg
Content-Length: <image size>

<Jpeg image data>
--<boundary>
```

***

### Definir Modo Claro

* Método: `POST /cgi-bin/api/CoaxialWhiteLightSpeaker/setLightMode`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd \
  "http://<ip>/cgi-bin/api/CoaxialWhiteLightSpeaker/setLightMode "
```

#### Tabela de Parâmetros

**(JSON format in body)**

| Nome          | Tipo   | Descrição                                                                                                                                                                                                                                                                               | Exemplo |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `channel`     | uint32 | Número do canal de vídeo                                                                                                                                                                                                                                                                | `0`     |
| `LightMode`   | uint32 | <p>Modo de iluminação:<br><code>0</code> — Luz branca<br><code>1</code> — Infravermelho<br><code>2</code> — Luz dupla inteligente</p>                                                                                                                                                   | `0`     |
| `TriggerMode` | uint32 | <p>Tipo de acionamento:<br><code>0</code> — Desligado (válido apenas no modo de comutação de luz)<br><code>1</code> — Acionamento manual<br><code>2</code> — Acionamento automático<br><br><em>No modo de luz dupla inteligente, somente o acionamento automático é suportado.</em></p> | `0`     |

**Exemplo:**

```powershell
{ 
    "channel": 0, 
    "LightMode": 0, 
    "TriggerMode": 0 
}
```

### Configuração do Controle da Luz&#x20;

**Tópico:** Configuração de Dispositivo Com Conexão Direta

* Método: `POST /cgi-bin/api/CoaxialWhiteLightSpeaker/setLightMode`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=LightGlobal "
```

**Resposta:**

```
table.LightGlobal[0].Enable=true 
```

#### Tabela de Parâmetros

| Nome          | Tipo      | Descrição                                              | Exemplo |
| ------------- | --------- | ------------------------------------------------------ | ------- |
| `LightGlobal` | object\[] | Configuração global de múltiplos estados de iluminação | —       |
| `+Enable`     | bool      | Habilita o sistema de iluminação                       | `true`  |

**Exemplo**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&LightGlobal[0].Enable=true "
```

**Resposta:**

```
OK
```

***

### Alterar o Modo de Emenda da Câmera Binocular

* Método: `POST /cgi-bin/api/MultiVideo/changeSpliceMode`

**Exemplo (curl)**:

```powershell
http://<server>/cgi-bin/api/MultiVideo/changeSpliceMode 
```

#### Tabela de Parâmetros

**(JSON format in body)**

| Nome    | Tipo  | Descrição                                                                                                                                                                                                           | Exemplo |
| ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `State` | int32 | <p>Estado de splicing:<br><code>1</code> — Alternar para modo de <strong>splicing</strong> (câmera monocular)<br><code>0</code> — Alternar para modo <strong>não-splicing</strong> (modo original multi-câmera)</p> | `0`     |

**Exemplo:**

```json
{
     "State": 0 
} 
```

### Opções de Vídeo Nas Configurações <a href="#informacoes-do-dispositivo" id="informacoes-do-dispositivo"></a>

* Método: `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInOptions`

**Exemplo (curl)**:

```powershell
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=getConfig&name=VideoInOptions  "
```

#### Tabela de Parâmetros

<table><thead><tr><th>Nome</th><th width="140.22222900390625">Tipo</th><th>Descrição</th><th>Exemplo</th></tr></thead><tbody><tr><td><code>VideoInOptions</code></td><td>object[]</td><td>Opções de entrada de vídeo. Vetor unidimensional; cada índice corresponde a um canal de vídeo (inicia em 0).</td><td>—</td></tr><tr><td><code>+Backlight</code></td><td>int</td><td>Intensidade de contraluz <code>[0–n]</code>. <code>0</code>: desligado, <code>1…n</code>: níveis de backlight</td><td><code>0</code></td></tr><tr><td><code>+DayNightColor</code></td><td>int</td><td><code>0</code>: sempre colorido; <code>1</code>: troca automática por brilho; <code>2</code>: sempre monocromático</td><td><code>0</code></td></tr><tr><td><code>+WhiteBalance</code></td><td>char[32]</td><td>Modo de balanço de branco</td><td><code>"Disable"</code></td></tr><tr><td><code>+Mirror</code></td><td>bool</td><td>Espelhamento de vídeo</td><td><code>false</code></td></tr><tr><td><code>+Flip</code></td><td>bool</td><td>Inversão vertical da imagem</td><td><code>false</code></td></tr><tr><td><code>+IrisAuto</code></td><td>bool</td><td>Íris automática</td><td><code>false</code></td></tr><tr><td><code>+GainRed</code></td><td>uint8</td><td>Ganho do vermelho <code>[0–100]</code> (ativo se WhiteBalance = Custom)</td><td><code>50</code></td></tr><tr><td><code>+GainBlue</code></td><td>uint8</td><td>Ganho do azul <code>[0–100]</code> (ativo se WhiteBalance = Custom)</td><td><code>50</code></td></tr><tr><td><code>+GainGreen</code></td><td>uint8</td><td>Ganho do verde <code>[0–100]</code> (ativo se WhiteBalance = Custom)</td><td><code>50</code></td></tr><tr><td><code>+ExposureValue1</code></td><td>double</td><td>Limite inferior da exposição automática (ms)</td><td><code>0.1</code></td></tr><tr><td><code>+ExposureValue2</code></td><td>double</td><td>Limite superior da exposição automática (ms)</td><td><code>80</code></td></tr><tr><td><code>+Gain</code></td><td>uint8</td><td>Ganho <code>[0–100]</code>. Se GainAuto=true → limite máximo; senão → valor fixo</td><td><code>50</code></td></tr><tr><td><code>+GainAuto</code></td><td>bool</td><td>Ganho automático</td><td><code>true</code></td></tr><tr><td><code>+SignalFormat</code></td><td>enum char[16]</td><td>Modo do sinal de entrada</td><td><code>"BT656"</code></td></tr><tr><td><code>+Rotate90</code></td><td>uint8</td><td><code>0</code>: sem rotação; <code>1</code>: 90° horário; <code>2</code>: 90° anti-horário</td><td><code>0</code></td></tr><tr><td><code>+ExternalSyncPhase</code></td><td>float</td><td>Fase de sincronismo externo <code>[0°–360°]</code></td><td><code>12.6</code></td></tr><tr><td><code>+ExternalSync</code></td><td>uint8</td><td><code>0</code>: sincronismo interno; <code>1</code>: externo</td><td><code>0</code></td></tr><tr><td><code>+AntiFlicker</code></td><td>int</td><td><code>0</code>: Outdoor; <code>1</code>: 50Hz; <code>2</code>: 60Hz</td><td><code>0</code></td></tr><tr><td><code>+ExposureSpeed</code></td><td>int</td><td>Controle de exposição (Auto / Manual / Limitado)</td><td><code>0</code></td></tr><tr><td><code>+ExposureMode</code></td><td>enum int</td><td>Referência à configuração VideoInExposure</td><td><code>0</code></td></tr><tr><td><code>+SmartIRExposure</code></td><td>bool</td><td>Exposição IR inteligente</td><td><code>true</code></td></tr><tr><td><code>+FlashControl</code></td><td>object</td><td>Controle do flash</td><td>—</td></tr><tr><td><code>++Mode</code></td><td>int</td><td><code>0</code>: sem flash; <code>1</code>: sempre ativo; <code>2</code>: automático</td><td><code>0</code></td></tr><tr><td><code>++Value</code></td><td>int</td><td>Duração do flash <code>[0–15]</code> → 0=0us … 15=960us</td><td><code>0</code></td></tr><tr><td><code>++PreValue</code></td><td>int</td><td>Limiar de brilho para ativar o flash</td><td><code>50</code></td></tr><tr><td><code>++Pole</code></td><td>enum int</td><td>Modo de disparo: <code>0</code>: nível baixo; <code>1</code>: nível alto; <code>2</code>: borda de subida; <code>3</code>: borda de descida</td><td><code>0</code></td></tr><tr><td><code>+GlareInhibition</code></td><td>int</td><td>Redução de ofuscamento <code>[0–100]</code></td><td><code>1</code></td></tr><tr><td><code>+NightOptions</code></td><td>object</td><td>Opções especiais noturnas; apenas <code>ExternalSyncPhase</code> é válido</td><td>—</td></tr><tr><td><code>+NormalOptions</code></td><td>object</td><td>Opções padrão; referência a VideoInOptions</td><td>—</td></tr></tbody></table>

**Exemplo:**

```json
curl --digest -u admin:pwd 
  "http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInOptions[0].ExposureMode=0&
VideoInOptions[0].ExposureSpeed=0"
```

**Resposta:**

```
OK
```

***

### Referências Rápidas (Resumo de Endpoints) <a href="#referencias-rapidas-resumo-de-endpoints" id="referencias-rapidas-resumo-de-endpoints"></a>

* **Brilho, Contraste e Saturação:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoColor`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoColor[0][0].Brightness=50`
* **Nitidez**:
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInSharpness`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInSharpness[0][0].Level=10&Vid`\
    `eoInSharpness[0][0].Mode=1&VideoInSharpness[0][0].Sharpness=0`
* **Virar, Espelhar e Girar 90:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoImageControl`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoImageControl[0].Flip=true`
* **Exposição**:
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInExposure`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInExposure[0][0].Iris=50`
* **Luz de fundo:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInBacklight`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInBacklight[0][0].GlareInhibition`\
    `=50`
* **Balanço de branco:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInWhiteBalance`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInWhiteBalance[0][0].GainBlue=`\
    `50`
* **Dia-Noite:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInDayNight`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInDayNight[0][0].Mode=BlackW`\
    `hite`
* **Ajuste de foco:**
  * `GET /cgi-bin/devVideoInput.cgi?action=adjustFocus`
  * `GET /cgi-bin/devVideoInput.cgi?action=adjustFocus&focus=0.5&zoom=-0.5`
* **Ajustar o Foco Continuamente:**
  * `GET /cgi-bin/devVideoInput.cgi?action=adjustFocusContinuously`
  * `GET /cgi-bin/devVideoInput.cgi?action=adjustFocusContinuously&channel=1&focus=0.0`\
    `2&zoom=-1`
* **Foco automático:**
  * `GET /cgi-bin/devVideoInput.cgi?action=autoFocus`
  * `GET /cgi-bin/devVideoInput.cgi?action=autoFocus&channel=1`
* **Obter status de foco:**
  * `GET /cgi-bin/devVideoInput.cgi?action=getFocusStatus`
  * `GET /cgi-bin/devVideoInput.cgi?action=getFocusStatus&channel=1`
* **Configurar foco:**
  * `GET /cgi-bin/api/devVideoInput/setFocus`
* **Configurar zoom:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInZoom`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInZoom[0][0].DigitalZoom=false`\
    `&VideoInZoom[0][0].Speed=8`
* **Configurar foco:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInFocus`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&VideoInFocus[0][0].FocusLimit=2000`\
    `&VideoInFocus[0][0].FocusFarLimit=5000&VideoInFocus[0][0].Sensitivity=1`
* **Iluminação**:
  * `POST /cgi-bin/api/CoaxialWhiteLightSpeaker/setLightMode`
* **Configuração de controle da luz de status:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=LightGlobal`
  * `GET /cgi-bin/configManager.cgi?action=setConfig&LightGlobal[0].Enable=true`
* **Alterar o modo de emenda da câmera binocular:**
  * `POST /cgi-bin/api/MultiVideo/changeSpliceMode`
* **Vídeo nas Configurações de Opções:**
  * `GET /cgi-bin/configManager.cgi?action=getConfig&name=VideoInOptions`

***


---

# 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/cameras-and-gravadores/integracao-api-cftvip-e-mibo/cameras-e-gravadores/configuracoes-do-sistema.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.