Connecting an SKR3EZ H723 via an ESP32 WiFi Adapter | RepRapFirmware for LPC and STM32

How to connect to an SKR3EZ H723 via an ESP32 WiFi Adapter

Overview

The SKR3EZ H723 is an STM32H723 based board.

Since RRF 3.5-RC4, firmware for STM32F4, STM32H723 and STM32H743 boards works as follows:

Each board has its own firmware file, instead of one firmware file covering many boards.
WiFi mode and SBC mode are both included in the same firmware file. If an SD card is present, the board starts in WiFi mode. If no SD card is present, the board starts in SBC mode. This is the same way that Duet3D boards work.
A board.txt setting selects which type of WiFi module is installed.

WiFi

You will need a Fly/Mellow ESP32 Module.

Note: This board also supports an ESP32 WiFi/Ethernet adapter. See the available ESP32 WiFi/Ethernet adapters page for supported adapters and the board.txt change needed.

Downloading the board firmware

TeamGloomy provides a separate firmware file for each board. The correct file for this board is firmware_skr3ez_h723.bin.

The latest firmware files can be found here

You can download either the latest stable release or the latest pre-release, if one is available.

Once downloaded, rename the file to firmware.bin.

WiFi firmware preparation

The latest firmware files can be found here

WiFiModule_esp32.bin

DWC (DuetWebControl)

The correct version of DWC should be downloaded from here.
The version you download should be of the same version number as the board firmware you downloaded above.
For example, if version 3.5.0 of the board firmware has been downloaded, 3.5.0 of DWC should be downloaded.

Using the Configurator
Manually Editing/Creating board.txt

Generate a config

We provide a handy online tool to help you generate a set of config files for your 3D printer. The configurator does not cover every RRF option (for example, dual motor axis control, which can be added manually later), but it gives you a good starting point.

We also have a collection of user created configs which can be a useful reference. They can be found here

Manual board.txt Changes

If you are using a set of config files provided by someone else, or do not need to use the configurator, you may need to create your board.txt file manually. Most board.txt settings are already pre-configured for each board. The preset settings for the SKR3EZ H723 are listed below for reference.

board=skr3_h723
board.longName="BTT SKR3 STM32H723"
sdcard.internal.type=2
SPI0.pins={A.5,A.6,A.7}
SPI1.pins={B.13,B.14,B.15}
SPI2.pins={NoPin,NoPin,NoPin}
SPI3.pins={E.14,E.15,E.13}
SPI4.pins={C.5,B.1,B.0}
SPI5.pins={E.9,NoPin,B.1}
SPI6.pins={NoPin,NoPin,NoPin}
SPI7.pins={NoPin,NoPin,NoPin}
SPI8.pins={NoPin,NoPin,NoPin}
stepper.powerEnablePin=NoPin
stepper.enablePins={D.6,D.1,E.0,C.7,D.13}
stepper.stepPins={D.4,A.15,E.2,D.15,D.11}
stepper.directionPins={D.3,A.8,E.3,D.14,D.10}
stepper.numSmartDrivers=5
stepper.TmcUartPins={D.5,D.0,E.1,C.6,D.12}
stepper.spiChannel=3
power.VInDetectPin=NoPin
sbc.TfrReadyPin=C.14
sbc.csPin=B.12
sbc.spiChannel=1
wifi.espDataReadyPin=B.10
wifi.TfrReadyPin=B.11
wifi.espResetPin=C.14
wifi.serialRxTxPins={D.9, D.8}
heat.tempSensePins={A.1,A.2,A.3}

Unless you are overriding some of the above settings, or adding additional features, such as an accelerometer or 12864 display, a board.txt file is not required.

Sensorless Homing

Follow the instructions as found here

You can now continue getting the SD card in the correct format.

WiFi Type

You will need to add the type of WiFi module you use to your board.txt so the firmware knows the correct firmware file to use for future updates.

Add the following line to your board.txt.

wifi.moduleType=esp32

Drivers

The following line should be added (obviously with the array entries matching your drivers and their locations):

stepper.DriverType = {Tmc2208, Tmc2240, tmc2209, tmc5160, stepdir}

The DriverType array allows for any driver to be used in any slot so there is no order requirement like the previous detection method. The array must also include an entry for each driver slot up to the last one that’s populated. The following list of entries are valid:

none
stepdir
tmc2208
tmc2209
tmc2660
tmc5160
tmc2240

The entry for stepper.numSmartDrivers is preset in the firmware for the number of drivers your board can handle. The number of drivers only needs to be changed if you are adding more drivers using something such as the BTT EXP MOT.

TMC2240 Driver Temperature

TMC2240 drivers support reporting their own temperature, rather than just hot and very hot like the other TMC drivers. To utilise this, add the following line to your config.g

M308 S11 Y"drivers"

This will return the highest temperature reading from any of the drivers. TMC2240 drivers will return the actual temperature; other drivers will return 0, 100 or 150 (as before).

If you want to know the temperature of a particular driver you need to add the following line (as well as the above):

M308 S12 Y"drivertemp" p"S11.X"

Where X is the driver number that matches the driver number used by M569

Sensorless Homing

Follow the instructions as found here

SD Card preparation

Now all the required files have been gathered, the SD card structure needs to be created.

SD Card Specification

When choosing an SD Card to use with RRF, we recommend one with the following features:

a branded card with a speed rating of Class 4 or higher
of up to 32GB capacity, formatted as below. RepRapFirmware does not support SD cards formatted in exFAT format.

Formatting

Tip: We recommend formatting your SD card with the SD Memory Card Formatter from the SD Association. Do this regardless of whether the SD Card is brand new or has been used for something else.

If you can’t use the recommended formatting tool, note the following when formatting the micro SDHC card:

If the capacity of the card is 4GB or lower, use FAT16 format
If the capacity is more than 4GB (up to 32GB) then you will have to use FAT32 format
All cards should be formatted with 512 byte sectors
For best upload speed choose the largest cluster size available, which is normally 64kb for FAT16 and 32kb for FAT32

Warning: DO NOT use Windows ‘Quick Erase’. This generally does not create a clean FAT32 partition.

SD Card Structure

The following structure should be replicated on your SD card.

sd card root/
├─ filaments/
├─ firmware/
│  ├─ WiFiModule_esp*.bin
├─ gcodes/
├─ macros/
├─ sys/
│  ├─ bed.g
│  ├─ board.txt (if required)
│  ├─ config.g
│  ├─ homeall.g
│  ├─ homex.g
│  ├─ homey.g
│  ├─ homez.g
│  ├─ pause.g
│  ├─ resume.g
│  ├─ sleep.g
│  ├─ stop.g
│  ├─ tfree0.g
│  ├─ tpost0.g
│  ├─ tpre0.g
├─ www/
│  ├─ contents of DuetWebControl-SD.zip
firmware.bin

In the above example, the contents of the sys folder have come from the online configurator. The WiFiModule file name will either be:

WiFiModule_esp32.bin
WiFiModule_esp32eth.bin

The contents of DuetWebControl-SD.zip should be extracted into the www folder.

Final Setup

Once connected, power up the board using 12-24V and connect the USB port on the board to your computer. Connect to the board using a program such as PuTTY. Follow the instructions here to set it up for RRF. Change the COM port to match the SKR3EZ H723 and connect. The baud rate does not matter.

Tip: A tool that shows the COM port number automatically when a serial device is plugged in can make this step easier. One example is Serial Port Monitor.

Flashing the WiFi Firmware

Type in the following to putty

M552 S0
M997 S1

Wait for the uploading of the WiFi firmware to finish.

Sending your WiFi Credentials

Send the following

M552 S0
M587 S"your SSID" P"your password"
M552 S1

Warning: DO NOT USE PRONTERFACE. It will convert all text to upper case. If you really must use it, do the following.
If you wanted to use PassWord, you would write P"P'a's'sW'o'r'd", with the ' indicating that the following letter should be lower case. Explanation here.

Important: Both the SSID and Password used to connect to your WiFi are case sensitive.

The blue light on the WiFi module should flash, then turn solid once a connection is established. The IP address is shown on the serial connection. You can also type M552 on its own to see the current IP address.

The final step is to add the line M552 S1 to your config.g file. You can edit config.g through the web interface. This makes sure that WiFi starts automatically when the board powers on. You do not need to add the M587 command to config.g, since it is saved permanently to the WiFi module.

Once up and running

You will need to PID tune your tools and your bed. Bed tuning may take up to an hour, and tool tuning normally takes around 15 minutes. If it takes longer, that is fine — up to 30 tuning cycles may run.

To tune the bed, run the following command, changing the temperature (the S value) if a different tuning temperature is required.

M303 H0 S60

To tune each tool, run the following command, changing the temperature (the S value) if a different tuning temperature is required. This process turns on the part cooling fans during the final phase of tuning, so their cooling effect is accounted for. If your printer has more than one tool, make sure each tool is tuned.

M303 T0 S220

Once the tuning is complete, either copy the M307 command into the heater definitions or send M500, ensuring you have M501 at the end of your config.g.
If the tuning fails at the end, carry on saving the values as in most cases the outputted values still work correctly.
If the values still result in a heater fault, please refer to this wiki page for information about how to adjust the values manually.

Tags: