Túr Comharthaíochta#

Réamhrá#

Is gléas é an Túr Comharthaíochta a úsáideann soilse daite chun stádas an róbait a thaispeáint. Tá lasc tuairteora ionsuite ann freisin ar féidir leis a bhrath nuair a bhrúitear é.

Maidir leis na samplaí thíos, tabharfar signal_tower_1 ar an Túr Comharthaí cumraithe agus úsáidfear é i ngach sampla ina dhiaidh sin ar fud an doiciméid API seo agus tagairt á déanamh do SignalTower.

Seo thíos liosta de na modhanna uile atá ar fáil:

Socraitheoirí – Cumraigh dathanna agus patrúin solais an Túir Chomharthaíochta.

  • set_color – Socraíonn sé an patrún do cheann amháin nó do na soilse LED go léir sa Túr Comhartha.

  • set_colors – Socraíonn sé staid gach soilse LED sa Túr Comharthaíochta.

Getters – Léigh staid tuairteora an Thúir Chomharthaíochta.

  • pressing – Tugann sé seo ar ais an bhfuil maolán an Túir Chomharthaíochta brúite faoi láthair.

Glaonna ar ais – Rith cód nuair a athraíonn staid maoláin an Thúir Chomharthaíochta.

  • pressed – Cláraíonn sé feidhm le glaoch uirthi nuair a bhrúitear maolán an Túir Chomharthaíochta.

  • released – Cláraíonn sé feidhm le glaoch uirthi nuair a scaoiltear maolán an Túir Chomharthaíochta.

Tógálaithe – Déan an Túr Comharthaíochta a thosú agus a chumrú de láimh.

Socraitheoirí#

set_color#

Socraíonn set_color patrún solais ceann amháin nó na soilse LED go léir ar an Túr Comharthaíochta. Is féidir na soilse seo a úsáid chun a rianú cá bhfuil an róbat i dtionscadal nó chun a thaispeáint cathain a chomhlíontar coinníollacha áirithe.

Usage:
signal_tower_1.set_color(value, state)

Paraiméadar

Cur síos

luach

An dath solais le rialú:

  • SignalTower.RED
  • SignalTower.GREEN
  • SignalTower.BLUE
  • SignalTower.YELLOW
  • SignalTower.WHITE
  • SignalTower.ALL — Cuireann sé an gníomh i bhfeidhm ar na dathanna uile.

stát

An patrún solais le cur i bhfeidhm:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Blincann na soilse air agus as.

 
# Set the Signal Tower to start blinking the blue LED
signal_tower_1.set_color(SignalTower.BLUE, signal_tower.BLINK)

set_colors#

set_colors staid gach soilse LED Túr Comharthaíochta. Is féidir na soilse seo a úsáid chun a rianú cá bhfuil an róbat i dtionscadal nó chun a thaispeáint cathain a chomhlíontar coinníollacha áirithe.

Usage:
signal_tower_1.set_colors(r, y, g, b, w)

Paraiméadar

Cur síos

r

An staid don solas dearg:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Blincann na soilse air agus as.

y

An staid don solas buí:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Blincann na soilse air agus as.

g

An staid don solas glas:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Blincann na soilse air agus as.

b

An staid don solas gorm:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Blincann na soilse air agus as.

w

An staid don solas bán:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Blincann na soilse air agus as.

 
# Turn on all LEDs
signal_tower_1.set_colors(SignalTower.ON, SignalTower.ON, SignalTower.ON, SignalTower.ON, SignalTower.ON)

# Turn on just the red LED
signal_tower_1.set_colors(SignalTower.ON, SignalTower.OFF, SignalTower.OFF, SignalTower.OFF, SignalTower.OFF)

Faighteoirí#

pressing#

Má bhrúnn tú pressing , faightear luach Booleach a léiríonn an bhfuil brú ar bhuimpéar an Túir Chomharthaíochta faoi láthair. Is féidir é seo a úsáid mar stad éigeandála.

  • True — Tá brú ar bhuilleoir an Thúir Chomharthaíochta faoi láthair.

  • False — Níl brú á chur ar thuairteoir an Thúir Chomharthaíochta.

Usage:
signal_tower_1.pressing()

Glaonna ar ais#

pressed#

pressed feidhm le glaoch nuair a bhrúitear tuairteoir an Thúir Chomharthaíochta.

Tugann an modh seo sampla den rang Event ar ais.

Usage:
signal_tower_1.pressed(callback, arg)

Paraiméadair

Cur síos

callback

Feidhm a shainmhíníodh roimhe seo a fhorghníomhaítear nuair a bhrúitear tuairteoir an Thúir Chomharthaíochta.

arg

Roghnach. Tuple ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais.

 
# Define a function tower_button_pressed()
def tower_button_pressed():
    # Print that the Signal Tower's button was pressed
    # to the Brain's screen.
    brain.screen.print("button pressed")

# Run tower_button_pressed when the Signal Tower's
# button is pressed.
signal_tower_1.pressed(tower_button_pressed)

released#

released feidhm le glaoch uirthi nuair a scaoiltear tuairteoir an Thúir Chomharthaíochta.

Tugann an modh seo sampla den rang Event ar ais.

Usage:
signal_tower_1.released(callback, arg)

Paraiméadair

Cur síos

callback

Feidhm a shainmhíníodh roimhe seo a fhorghníomhaítear nuair a scaoiltear maolán an Thúir Chomharthaíochta.

arg

Roghnach. Tuple ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais.

 
# Define a function tower_button_released()
def tower_button_released():
    # Print that the Signal Tower's button was released
    # to the Brain's screen.
    brain.screen.print("button released")

# Run tower_button_released when the Signal Tower's
# button is released.
signal_tower_1.released(tower_button_released)

Tógálaithe#

SignalTower#

Cruthaíonn SignalTower Túr Comhartha.

SignalTower(smartport)

Paraiméadar

Cur síos

smartport

An Port Cliste a bhfuil an Túr Comharthaíochta ceangailte leis, scríofa mar Ports.PORTx áit a seasann x do uimhir an phoirt.

 
# Construct a Signal Tower "signal_tower_1" with the
# SignalTower class
signal_tower_1 = SignalTower(Ports.PORT1)
On this page