Ímã#

Introdução#

O íman V5 só pode ser utilizado com a célula de trabalho V5.

Segue-se uma lista dos métodos disponíveis:

Ações – Interaja com o íman.

  • pickup – Activa o íman para apanhar um objecto.

  • drop – Desativa o Íman para largar um objeto.

  • set_power – Define o nível de potência do Magnet utilizado para pegar e largar.

Getters – Retornam dados do Magnet.

  • temperature – Devolve a temperatura do Magneto.

  • installed – Verifica se o Magneto está ligado.

  • timestamp – Retorna o timestamp do último pacote de estado recebido do Magnet.

Construtores – Inicialize e configure o Magnet manualmente.

Ações#

pickup#

pickup(duration, units, power) activa o íman para apanhar um objecto.

Usage: magnet.pickup(duration, units, power)

Parâmetros

Descrição

duration

Opcional. A duração da ativação do Magneto, em formato inteiro ou decimal.

units

Opcional. Unidades de duração:

  • MSEC (Padrão)
  • SECONDS

power

Opcional. Nível de potência a definir (0 - 100).

# Set the Magnet to pickup.
magnet.pickup()

# Set the Magnet to pickup for 250 milliseconds at
# 90% power.
magnet.pickup(250, MSEC, 90)

drop#

drop() desativa o Magnet para largar um objeto.

Usage: magnet.drop(duration, units, power)

Parâmetros

Descrição

duration

Opcional. A duração para desativar o Magneto, como um número inteiro ou decimal.

units

Opcional. Unidades de duração:

  • MSEC (Padrão)
  • SECONDS

power

Opcional. Nível de potência a definir (0 - 100).

# Set the Magnet to drop.
magnet.drop()

# Set the Magnet to drop for 250 milliseconds at
# 90% power.
magnet.drop(250, MSEC, 90)

set_power#

set_power(value) define o nível de potência do íman utilizado para pegar e largar.

Usage: magnet.set_power(value)

Parâmetros

Descrição

value

Nível de potência a definir (0 - 100).

# Set the default power to 80%. 
magnet.set_power(80)

Getters#

temperature#

temperature() devolve a temperatura do Magnet como um float.

Usage: magnet.temperature(units)

Parâmetros

Descrição

units

Opcional. Unidades de temperatura:

  • CELSIUS (Standard)
  • FAHRENHEIT

installed#

installed() devolve um valor booleano se o Magnet estiver ligado.

  • True - O íman está ligado ao cérebro.

  • False - O íman não está ligado ao cérebro.

Usage: magnet.installed()

Parâmetros

Descrição

Este método não tem parâmetros.

timestamp#

timestamp() devolve um número inteiro como carimbo de data/hora do último pacote de estado recebido do Magnet.

Usage: magnet.timestamp()

Parâmetros

Descrição

Este método não tem parâmetros.

Construtores#

Os construtores são utilizados para criar manualmente objetos Magnet, que são necessários para configurar um Magnet fora do VEXcode.

Electromagnet#

Electromagnet creates a magnet.

Utilização: magnet_1 = Electromagnet(port)

Parâmetro

Descrição

port

A porta inteligente à qual o íman está ligado é indicada como Ports.PORT seguida do número da porta, que varia de 1 a 12.

# Create a Magnet in Port 1.
magnet_1 = Electromagnet(Ports.PORT1)