RP2040: Customizing - Paciente8159/uCNC GitHub Wiki
µCNC for RP2040 can be configured/customized to fit different boards like Pico and Pico W
Jump to section
µCNC for RP2040 can be customized either using the Web Config Tool or by manually modifing the source code files. For the latest method most configurations and pin assigning should be done in the corresponding boardmap file inside the uCNC/src/hal/boards/rp2040/ directory and then the respective board file.
An HAL pin need to be mapped to a physical IO pin. The way this is done is by defining the IO BIT. There is no need do define IO PORT on this MCU. This must be performed for every used pin. RP2040 PORT is ignored. This is similar to the general customization instructions
All input pins can have a weak pull-up activated to drive them high if unconnected. This is similar to the general customization instructions
All pins all repeatedly read by a soft polling routine. But for special function pins an interrupt driven event to force a reading and respective action can be also activated. This causes the response to be immediate and not depend on the pin reading routine cycle.
To make an input pin interruptable just declare #define <pin_name>_ISR.
For RP2040 the pin mapping can be checked here.
This is similar to the general customization instructions
PWM clock is internally set in the mcumap file and there is no need to configure it. The only thing needed is to choose the PWM pin output.
//Setup PWM
#define PWM0_BIT 8 //assigns PWM0 pin
For analog pins, like in PWM the only thing you need to define is the pin. Arduino framework takes care of the rest:
#define ANALOG0_BIT 0
To make a read just do
uint8_t value = mcu_get_analog(ANALOG0);
All step and dir pins are modified inside a timer ISR (µCNC's heartbeat). In the RP2040 Timer 1 (of 4 available Timers) is used by default. RTC, SERVO and ONESHOT shares the same timer (uses Timer 2).
Servo timing control is shared with RTC. There is no need to configure this timer.
Both WiFi and Bluetooth share the same transition hardware. Enabling them both might lead to unexpected behavior and poor performance. Both WiFi and Bluetooth also save their last state. On power on their previous state (enabled or disabled) will automatically be reinstated.
WiFi interface exposes the following system commands that can be used to configure and control WiFi:
$wifion - this enables WiFi. When this command is issued all changes made to the WiFi settings are stored.
$wifioff - this disables WiFi. When this command is issued all changes made to the WiFi settings are stored.
$wifireset - this resets all WiFi settings.
$wifisave - this saves all WiFi settings. Settings will only be in effect after disabling and enabling the WiFi.
$wifiscan - scans all available WiFi AP's.
$wifissid - gets the current defined AP SSID.
$wifissid=<ssid> - (text) sets the current defined AP SSID.
$wifipass=<pass> - (text) sets the current WiFi password.
$wifimode=<mode_number> - (number) sets the WiFi mode. 1-STA+AP, 2-STA, 3-AP
$wifiip - gets the board IP address
Bluetooth interface exposes the following system commands that can be used to control BLE module:
$bthon - this enables WiFi. When this command is issued all changes made to the WiFi settings are stored.
$bthoff - this disables WiFi. When this command is issued all changes made to the WiFi settings are stored.