Balíček brian.sensors.NXT

Modul brian.sensors.NXT.LightSensorNXT

class brian.sensors.NXT.LightSensorNXT.LightSensorNXT(port: SensorPort)

Základy: Sensor

Třída pro interakci s NXT světelným senzorem.

Senzor je automaticky registrován v konstruktoru základní třídy a odstraněn v jeho destruktoru. Může být také odregistrován voláním LightSensorNXT.close_sensor().

Na jednom portu může být v celém programu současně pouze jedna instance jakékoliv třídy senzoru.

__init__(port: SensorPort)

Inicializuje NXT světelný senzor na zadaném portu.

Parametry:

port – Port senzoru, ke kterému je senzor připojen.

set_led_on(led_on: bool) → None

Tato funkce nastaví senzor do požadovaného režimu. I když to není nutné, doporučuje se nejprve zavolat tuto funkci před přístupem k hodnotám senzoru v specifickém režimu, aby se předešlo výjimkám SensorIsNotReady.

Parametry:

led_on – Zda má být červená LED zapnuta nebo vypnuta.

light_value(led_on: bool | None) → float

Měří příchozí světlo.

Parametry:

led_on – Indikuje, zda má být červená LED zapnuta nebo vypnuta. - Pokud není poskytnuta žádná hodnota nebo je předána hodnota None, bude použito předchozí nastavení LED.

Vrací:

Hodnota v rozsahu 0-1, kde 0 je nejtmavší a 1 nejsvětlejší.

Vyvolá:

brian.sensors.SensorIsNotReadyError – Pokud senzor není připraven.

light_value_raw(led_on: bool | None) → int

Měří příchozí světlo. Surové měření je invertované, což znamená, že nižší hodnoty odpovídají jasnějšímu světlu.

Parametry:

led_on – Indikuje, zda má být červená LED zapnuta nebo vypnuta. - Pokud není poskytnuta žádná hodnota nebo je předána hodnota None, bude použito předchozí nastavení LED.

Vrací:

Hodnota v rozsahu 0-4095, kde 4095 je nejtmavší a 0 nejsvětlejší.

Vyvolá:

brian.sensors.SensorIsNotReadyError – Pokud senzor není připraven.

Modul brian.sensors.NXT.SoundSensorNXT

class brian.sensors.NXT.SoundSensorNXT.SoundSensorNXT(port: SensorPort)

Základy: Sensor

Třída pro interakci s NXT zvukovým senzorem.

Senzor je automaticky registrován v konstruktoru základní třídy a odstraněn v jeho destruktoru. Může být také odregistrován voláním SoundSensorNXT.close_sensor().

Na jednom portu může být v celém programu současně pouze jedna instance jakékoliv třídy senzoru.

__init__(port: SensorPort)

Inicializuje NXT zvukový senzor na zadaném portu.

Parametry:

port – Port senzoru, ke kterému je senzor připojen.

sound_intensity() → float

Měří příchozí zvuk.

Vrací:

Hodnota v rozsahu 0-1, kde 0 je nejtišší a 1 nejhlasitější.

Vyvolá:

brian.sensors.SensorIsNotReadyError – Pokud senzor není připraven.

sound_intensity_raw() → int

Měří příchozí zvuk. Surové měření je invertované, což znamená, že nižší hodnoty odpovídají hlasitějším zvukům.

Vrací:

Hodnota v rozsahu 0-4095, kde 4095 je nejtišší a 0 nejhlasitější.

Vyvolá:

brian.sensors.SensorIsNotReadyError – Pokud senzor není připraven.

Modul brian.sensors.NXT.TouchSensorNXT

class brian.sensors.NXT.TouchSensorNXT.TouchSensorNXT(port: SensorPort)

Základy: Sensor

Třída pro interakci s NXT dotykovým senzorem.

Senzor je automaticky registrován v konstruktoru základní třídy a odstraněn v jeho destruktoru. Může být také odregistrován voláním TouchSensorNXT.close_sensor().

Na jednom portu může být v celém programu současně pouze jedna instance jakékoliv třídy senzoru.

__init__(port: SensorPort)

Inicializuje NXT dotykový senzor na zadaném portu.

Parametry:

port – Port senzoru, ke kterému je senzor připojen.

is_pressed() → bool

Měří stav senzoru. Vrací boolean posledního stavu tlačítka. Pokud senzor není připraven, vrací False.

Vrací:

Pravda, pokud je tlačítko senzoru stisknuto, jinak nepravda. Nebo nepravda, pokud senzor není připraven.

Vyvolá:

brian.sensors.SensorIsNotReadyError – Pokud senzor není připraven.

wait_for_press(timeout_ms: int = -1) → bool

Čeká na další událost stisknutí tlačítka. Tato funkce je blokující.

Parametry:

timeout_ms – Maximální počet milisekund čekání. Pokud je timeout záporný, funkce bude čekat neomezeně.

Vrací úspěch:

• Pravda: Pokud byla zachycena požadovaná událost tlačítka.

• Nepravda: Pokud vypršel timeout.

wait_for_release(timeout_ms: int = -1) → bool

Čeká na další událost uvolnění tlačítka. Tato funkce je blokující.

Parametry:

timeout_ms – Maximální počet milisekund čekání. Pokud je timeout záporný, funkce bude čekat neomezeně.

Vrací úspěch:

• Pravda: Pokud byla zachycena požadovaná událost tlačítka.

• Nepravda: Pokud vypršel timeout.

wait_for_press_and_release(timeout_ms: int = -1) → bool

Čeká na další událost stisknutí a uvolnění tlačítka. Tato funkce je blokující.

Parametry:

timeout_ms – Maximální počet milisekund čekání. Pokud je timeout záporný, funkce bude čekat neomezeně.

Vrací úspěch:

• Pravda: Pokud byla zachycena požadovaná událost tlačítka.

• Nepravda: Pokud vypršel timeout.

Modul brian.sensors.NXT.UltrasonicSensorNXT

class brian.sensors.NXT.UltrasonicSensorNXT.UltrasonicSensorNXT(port: SensorPort)

Základy: Sensor

Třída pro interakci s NXT ultrazvukovým senzorem.

Senzor je automaticky registrován v konstruktoru základní třídy a odstraněn v jeho destruktoru. Může být také odregistrován voláním UltrasonicSensorNXT.close_sensor().

Na jednom portu může být v celém programu současně pouze jedna instance jakékoliv třídy senzoru.

__init__(port: SensorPort)

Inicializuje NXT ultrazvukový senzor na zadaném portu.

Parametry:

port – Port senzoru, ke kterému je senzor připojen.

distance_cm() → int

Nepřetržitě měří vzdálenost a vrací hodnotu v cm.

Vrací:

Vzdálenost v cm (0-255).

Vyvolá:

brian.sensors.SensorIsNotReadyError – Pokud senzor není připraven.