Menu do Hub TI

Nota: Ao criar um novo programa que utilize este módulo, recomenda-se a utilização do tipo de programa Projeto do Hub. Isto irá garantir que todos os módulos relevantes são importados.

Item

Descrição

da importação do ti_hub *

Importa todos os métodos do módulo ti_hub.

 

Dispositivos Hub integrados > Saída de cor

Item

Descrição

rgb(red,green,blue)

Define a cor para o LED RGB.

blink(frequency,time)

Define a frequência de intermitência e a duração da cor selecionada.

off()

Desliga o LED RGB.

 

Dispositivos Hub integrados > Saída de luz

Item

Descrição

on()

Liga o LED.

off()

Desliga o LED.

blink(frequency,time)

Define a frequência de intermitência e a duração do LED.

 

Dispositivos Hub integrados > Saída de som

Item

Descrição

tone(frequency,time)

Reproduz um tom da frequência especificada para o tempo especificado.

note("note",time)

Reproduz a nota especificada para o tempo especificado.

A nota é especificada utilizando o nome da nota e uma oitava. Por exemplo: A4, C5.

Os nomes das notas são C, CS, D, DS, E, F, FS, G, GS, A, AS e B.

Os números de oitava variam de 1 a 9 (inclusive).

tone(frequency,time,tempo)

Reproduz um tom da frequência especificada para o tempo e ritmo especificados.

O ritmo define o número de sinais sonoros por segundo de 0 a 10 (inclusive).

note("note",time,tempo)

Reproduz a nota especificada para o tempo e ritmo especificados.

A nota é especificada utilizando o nome da nota e uma oitava. Por exemplo: A4, C5.

Os nomes das notas são C, CS, D, DS, E, F, FS, G, GS, A, AS e B.

Os números de oitava variam de 1 a 9 (inclusive).

Os números de ritmo variam de 0 a 10 (inclusive).

 

Dispositivos Hub integrados > Entrada de brilho

Item

Descrição

measurement()

Lê o sensor de BRILHO (nível de luz) incorporado e devolve uma leitura.

O intervalo predefinido é de 0 a 100. Isto pode ser alterado utilizando a função range().

range(min,max)

Define o intervalo para mapear as leituras do sensor de nível de luz.

Se ambos estiverem em falta ou definidos para um valor de Nenhum, então é definido o intervalo de brilho predefinido de 0 a 100.

 

Adicionar dispositivo de entrada

Este menu tem uma lista dos sensores (dispositivos de entrada) suportados pelo módulo ti_hub. Todos os itens do menu irão colar o nome do objeto e esperar uma variável e uma porta utilizada com o sensor. Cada sensor tem um método measurement() que devolve o valor do sensor.

Item

Descrição

DHT (Humidade Digital e Temp)

Devolve uma lista constituída pela temperatura atual, humidade, tipo de sensor e último estado lido em cache.

Ranger

Devolve a medição de distância atual a partir do sensor ultrassónico.

• measurement_time() - devolve o tempo que o sinal ultrassónico demora a chegar ao objeto (o "tempo de voo").

Nível de luz

Devolve o nível de brilho a partir do sensor de nível de luz externo (brilho).

Temperatura

Devolve a leitura de temperatura a partir do sensor de temperatura externo.

A configuração predefinida é para suportar o sensor de temperatura Seeed nas portas IN 1, IN 2 ou IN 3.

Para utilizar o sensor de temperatura TI LM19 do pacote da placa de ensaio TI-Innovator™ Hub, edite a porta para o pino BB em utilização e utilize um argumento opcional "TIANALOG".

Exemplo: mylm19=temperature("BB 5","TIANALOG")

Humidade

Devolve a leitura do sensor de humidade.

Magnético

Deteta a presença de um campo magnético.

O valor limiar para determinar a presença do campo é definido através da função trigger().

O valor predefinido do limiar é 150.

Vernier

Lê o valor do sensor analógico Vernier especificado no comando.

O comando suporta os seguintes sensores Vernier:

• temperatura - Sensor de temperatura de aço inoxidável.
• nível de luz - Sensor de nível de luz TI.
• pressão - Sensor de pressão de gás original
• pressão - Sensor de pressão de gás mais recente.
• pH - Sensor de pH.
• força10 - Definição ±10 N, sensor de força dupla.
• força50 - Definição ±50 N, sensor de força dupla.
• acelerómetro - Acelerómetro G baixo.
• genérico - Permite a definição de outros sensores não suportados diretamente acima e a utilização da API calibrate() acima para definir coeficientes de equações.

Analog In

Suporta a utilização de dispositivos genéricos de entrada analógica.

Digital In

Devolve o estado atual do pino digital ligado ao objeto DIGITAL ou o estado em cache do valor de saída digital DEFINIDO pela última vez para o objeto.

Potenciómetro

Suporta um sensor do potenciómetro.

O intervalo do sensor pode ser alterado pela função range().

Termístor

Lê os sensores do termístor.

Os coeficientes predefinidos são concebidos para corresponder ao termístor incluído no pacote da placa de ensaio do TI-Innovator™ Hub, quando utilizado com uma resistência fixa de 10KΩ.

Pode configurar um novo conjunto de coeficientes de calibração e resistência de referência para o termístor utilizando a função calibrate().

Intensidade sonora

Suporta sensores de intensidade sonora.

Entrada de cor

Fornece interfaces a um sensor de entrada de cor ligada ao I2C.

O pino do bb_port é utilizado para além da porta I2C para controlar o LED no sensor de cor.

• color_number(): Devolve um valor de 1 a 9 que representa a cor que o sensor deteta.

Os números representam as cores de acordo com o seguinte mapeamento:

1: Vermelho

2: Verde

3: Azul

4: Ciano

5: Magenta

6: Amarelo

7: Preto

8: Branco

9: Cinzento

• red(): Devolve um valor de 0 a 255 que representa a intensidade do nível de cor VERMELHO a ser detetado.
• green(): Devolve um valor de 0 a 255 que representa a intensidade do nível de cor VERDE a ser detetado.
• blue(): Devolve um valor de 0 a 255 que representa a intensidade do nível de cor AZUL a ser detetado.
• gray(): Devolve um valor de 0 a 255 que representa o nível cinzento a ser detetado, em que 0 é preto e 255 é branco.

Porta BB

Fornece suporte para utilizar todos os 10 pinos de porta BB como porta de entrada/saída digital combinada.

As funções de inicialização têm um parâmetro de "máscara" opcional que permite a utilização do subconjunto dos 10 pinos.

• read_port(): Lê os valores atuais nos pinos de entrada da porta BB.
• write_port(value): Define os valores dos pinos de saída para o valor especificado, onde o valor está entre 0 e 1023. Tenha em atenção que o valor também é ajustado contra o valor da máscara na operação var=bbport(máscara), se tiver sido fornecida uma máscara.

Tempo do Hub

Fornece acesso ao temporizador de milissegundo interno.

TI-RGB Array

Fornece funções para programar a matriz TI-RGB.

A função de inicialização aceita um parâmetro opcional "LAMP" para permitir um modo de alto brilho para a TI-RGB Array que requer uma fonte de alimentação externa.

• set(led_position, r,g,b): Define uma led_position específica (0-15) para o valor r,g,b especificado, em que r,g,b são valores de 0 a 255.
• set(led_list,red,green,blue): Define os LED definidos na "led_list" para a cor especificada por "vermelho", "verde", "azul". A "led_list" é uma lista Python que inclui índices dos LED de 0 a 15. Por exemplo, o conjunto([0,2,4,6,15], 0, 255) irá definir os LED 0, 2, 4, 6 e 15 para azul.
• set_all(r,g,b): Define todos os LED RGB na matriz com o mesmo valor r,g,b.
• all_off(): Desliga todos os RGBs no conjunto.
• measurement(): Devolve a corrente aproximada que o conjunto RGB está a utilizar a partir do TI-Innovator™ em miliamperes.
• pattern(pattern): Utilizando o valor do argumento como um valor binário no intervalo de 0 a 65535, liga os píxeis onde estaria um valor de 1 na representação. Os LED são ligados como VERMELHO com valor de nível pwm de 255.
• pattern(value,red,green,blue): Define os LEDs definidos pelo "padrão" para a cor especificada por "vermelho", "verde", "azul".

 

Adicionar dispositivo de saída

Este menu tem uma lista de dispositivos de saída suportados pelo módulo ti_hub. Todos os itens do menu irão colar o nome do objeto e esperar uma variável e uma porta utilizada com o sensor.

Item

Descrição

LED

Funções para controlar os LEDs ligados externamente.

RGB

Apoio para controlar LEDs RGB externos.

TI-RGB Array

Fornece funções para programar a matriz TI-RGB.

Coluna

Funções para apoiar uma coluna externa com o TI-Innovator™ Hub.

As funções são as mesmas que para o "som" acima.

Potência

Funções para controlar a alimentação externa com o TI-Innovator™ Hub.

• set(value): Define o nível de potência para o valor especificado, entre 0 e 100.
• on(): Define o nível de potência para 100.
• off(): Define o nível de potência para 0.

Servomotor contínuo

Funções para controlar servomotores contínuos.

• set_cw(speed,time): O servomotor irá rodar no sentido dos ponteiros do relógio à velocidade especificada (0-255) e pela duração específica em segundos.
• set_ccw(speed,time): O servomotor irá rodar no sentido dos ponteiros do relógio à velocidade especificada (0-255) e pela duração específica em segundos.
• stop(): Para o servomotor contínuo.

Saída analógica

Funções para utilização de dispositivos genéricos de entrada analógica.

Motor de vibração

Funções para controlar os motores de vibração.

• set(val): Define a intensidade do motor de vibração para "val" (0-255).
• off(): Desliga o motor de vibração.
• on(): Liga o motor de vibração no nível mais alto.

Relé

Controla interfaces para relés de controlo.

• on(): Define o relé para o estado ON (Ligado).
• off(): Define o relé para o estado OFF (Desligado).

Servomotor

Funções para controlar servomotores contínuos.

• set_position(pos): Define a posição do servomotor de varrimento num intervalo de -90 a +90.
• zero(): Define o servomotor de varrimento para a posição zero.

Squarewave

Funções para gerar uma onda quadrada.

• set(frequency,duty,time): Define a onda quadrada de saída com um ciclo de serviço predefinido de 50% (se o ciclo não for especificado) e uma frequência de saída especificada por "frequência". A frequência pode ser de 1 a 500 Hz. O ciclo de trabalho, se especificado, pode ser de 0 a 100%.
• off(): Desliga a onda quadrada.

Saída digital

Interfaces para controlar uma saída digital.

• set(val): Define a saída digital para o valor especificado por "val" (0 ou 1).
• on(): Define o estado da saída digital para alto (1).
• off(): Define o estado da saída digital para baixo (0).

Porta BB

Fornece funções para programar a matriz TI-RGB.

Consulte os detalhes acima.

 

Comandos

Item

Descrição

sleep(seconds)

Pausa o programa durante um número especificado de segundos.

Importado do módulo "time".

text_at(row,"text","align")

Apresenta o "texto" especificado na área de representação gráfica no "alinhamento" especificado.

Parte do módulo ti_plotlib.

cls()

Limpa o ecrã Shell para representar graficamente.

Parte do módulo ti_plotlib.

enquanto get_key() != "esc":

Executa os comandos no ciclo "while" até que a tecla "esc" seja premida.

get_key()

Devolve uma cadeia que representa a tecla premida.

A tecla "1" devolve "1", "esc" devolve "esc" e por aí adiante.

Quando chamada sem quaisquer parâmetros - get_key() - devolve imediatamente.

Quando é chamado com um parâmetro - get_key(1) - aguarda até que seja premida uma tecla.

Parte do módulo ti_system.

 

Portas

Estas são as portas de entrada e saída disponíveis no TI-Innovator™ Hub.

Item

OUT 1

OUT 2

OUT 3

IN 1

IN 2

IN 3

BB 1

BB 2

BB 3

BB 4

BB 5

BB 6

BB 7

BB 8

BB 9

BB 10

I2C