electroimán

Inicializando la clase de electroimán

Un objeto electroimán se crea utilizando el siguiente constructor:

El constructor electromagnet crea un objeto electroimán en el puerto especificado:

Parámetro	Descripción
puerto	Un Puerto inteligente válido al que está conectado el electroimán.

// Construct an Electromagnet "magnet" with the
// electromagnet class.
electromagnet magnet = electromagnet(PORT1);

Este objeto magnet se utilizará en todos los ejemplos posteriores a lo largo de esta documentación de API cuando se haga referencia a los métodos de la clase Electromagnet.

Métodos de clase

establecerPotencia()

El método setPower(power) establece el nivel de potencia del electroimán utilizado para recoger y soltar.

Parámetros	Descripción
fuerza	El nivel de potencia se puede establecer en el rango 0 – 100.

Devoluciones: Ninguna.

// Set the default power to 80%.
magnet.setPower(80);

levantar()

Este método se llama de las siguientes maneras:

El método pickup() activa el electroimán para recoger un objeto durante la duración predeterminada y con la potencia predeterminada especificada por el método setPower().

// Set the magnet to pickup.
magnet.pickup();

El método pickup(time, units) activa el electroimán para recoger un objeto durante una duración específica y con la potencia predeterminada especificada por el método setPower().

Parámetros	Descripción
tiempo	La duración para activar el electroimán.
unidades	Una unidad de tiempo válida. El valor predeterminado es mseg.

// Set the magnet to pickup for 10 seconds.
magnet.pickup(10, seconds);

El método pickup(time, units, power) activa el electroimán para recoger un objeto durante una duración específica y a una potencia específica.

Parámetros	Descripción
tiempo	La duración para activar el electroimán.
unidades	Una unidad de tiempo válida. El valor predeterminado es mseg.
fuerza	El nivel de potencia a establecer.

// Set the magnet to pickup for 10 seconds at 90% power.
magnet.pickup(10, seconds, 90);

Devoluciones: Ninguna.

gota()

Este método se llama de las siguientes maneras:

El método drop() activa el electroimán para recoger un objeto durante la duración predeterminada y con la potencia predeterminada especificada por el método setPower().

Devoluciones: Ninguna.

// Set the magnet to drop.
magnet.drop();

El método drop(time, units) desactiva el electroimán para dejar caer un objeto durante una duración específica y con la potencia predeterminada especificada por el método setPower().

Parámetros	Descripción
tiempo	La duración para desactivar el electroimán.
unidades	Una unidad de tiempo válida. El valor predeterminado es mseg.

Devoluciones: Ninguna.

// Set the magnet to drop for 10 seconds.
magnet.drop(10, seconds);

El método drop(time, units, power) desactiva el electroimán para dejar caer un objeto durante una duración específica y a una potencia específica.

Parámetros	Descripción
tiempo	La duración para desactivar el electroimán.
unidades	Una unidad de tiempo válida. El valor predeterminado es mseg.
fuerza	El nivel de potencia a establecer.

Devoluciones: Ninguna.

// Set the magnet to drop for 10 seconds at 90 percent power.
magnet.drop(10, seconds, 90);

temperatura()

El método temperature(units) devuelve la temperatura del electroimán.

Parámetros	Descripción
unidades	Una unidad de temperatura válida. El valor predeterminado es celsius.

Devuelve: Un doble que representa la temperatura del electroimán.

marca de tiempo()

El método timestamp() solicita la marca de tiempo del último paquete de estado recibido del electroimán.

Devuelve: Marca de tiempo del último paquete de estado como un entero de 32 bits sin signo en milisegundos.

instalado()

El método installed() retorna si el electroimán está conectado.

Devuelve: true si el electroimán está instalado. false si no lo está.