QUERY · ISSUE

ESP32 port missing "hard" kwarg in pin.irq()

openby jedieopened 2018-10-05updated 2025-01-07

enhancementport-esp32

The ESP8266 has hard keyword argument in pin.irq() function. This is missing in ESP32 port.

See also: https://forum.micropython.org/viewtopic.php?p=30748#p30745

CANDIDATE · ISSUE

ESP8266 - 'priority' and 'wake' params in Pin.irq method are not supported

openby rsc1975opened 2017-01-08updated 2022-08-23

port-esp8266

The doc (v1.8.6 and v1.8.7) seems to be wrong for the port esp8266, the parameters priority and wake are not supported, but they appears in the Pin class doc: https://micropython.org/resources/docs/en/latest/esp8266/library/machine.Pin.html

I've seen in the port Pin implementation that those parameters are not supported: https://github.com/micropython/micropython/blob/master/esp8266/machine_pin.c

Besides, there are some constants, like Pin.IRQ_LOW_LEVEL or Pin.IRQ_HIGH_LEVEL that are not in Pin class but they appears in the doc.

It seems that there are some other issues related with doc customizations by port, maybe that are sphinx issues, but I don't think so.

Assessment

Q Qwen · high

Both issues concern the Pin.irq() method in MicroPython's ESP ports. Issue #4214 requests adding the 'hard' keyword argument to the ESP32 port to match ESP8266 functionality. Issue #2773 reports that the ESP8266 port's documentation incorrectly lists 'priority' and 'wake' parameters that aren't actually implemented. While they both address API inconsistencies in Pin.irq() across ESP ports, they focus on different specific parameters ('hard' vs 'priority'/'wake') and different ports (ESP32 vs ESP8266). The candidate does not resolve the query's request for the 'hard' argument in ESP32.

Suggested action

Keep both issues open. Issue #4214 should be addressed separately to add the 'hard' parameter to ESP32. Issue #2773 should be addressed to fix the ESP8266 documentation and potentially implement the missing parameters.

ESP32 port missing "hard" kwarg in pin.irq()

ESP8266 - 'priority' and 'wake' params in Pin.irq method are not supported

Keyboard