Control System for Multiple Stepper Motors
System Upgrade Procedure
Latest Version Earlier Versions
Step 1 - Get a copy of the Teensy program file








V18 N/A


You can click on the image or file name to the right and save that file.

Download 4Rose.hex to your computer.

Step 2 - Get a copy of the Nextion configuration file


V21 RoseEngine_21.tft
V20 RoseEngine_20.tft
V19 RoseEngine_19.tft
V18 N/A
V17 RoseEngine_17.tft

You can click on the image or file name to the right and save that file.

Download RoseEngine_Nxx.tft (where "xx" is the version number) and put it in the root folder of a microSD card.


  1. You can only have one file on this card which is a .TFT file. The upgrade will not work if there is a 2d one.
  2. You need to check for hidden files on the microSD card. I found that hard to do on macOS (which created a hidden TFT file) and had to do this on a Raspberry Pi.
Step 3 - Get a copy of the 4Axes.ini settings file



You can click on the image or file name to the right and save that file.

Download 4Axes.ini, and put it in the root of a microSD card. This can be the same microSD card as in step #2.

Using a newer version of the 4Axes.ini file with older versions of 4Roses.hex is fine. The latest 4Axes.ini file has settings that get ignored with earlier versions of 4Roses.hex.

Step 4 - Upgrade the Teensy

  Step 4a     Connect the computer to the Teensy.

  • The cable end connected to the Teensy uses a MicroUSB connector.
  • The Teensy's jack is noted in the picture to the right.

Be sure you have a good MicroUSB cable. Some are only used for charging a device (and they are usually longer). These will often not work.

  Step 4b     On the Computer, start the Teensy Loader.


  1. 1. If you do not have the Teensy Loader installed on your computer, you can get it from

  Step 4c     Be sure the system shows that the Teensy is connected. This is evident when the Auto button is illuminated green. As noted in step 4a above, if your USB cable is bad, this will not light.

The default for the CPU selected will not handle the whole 4Rose.hex file, so if you try to open it, you will get the message as shown at the bottom of the picture to the right.

4Rose.hex (too large!)

  Step 4d     Press the button on the Teensy to get the Teensy loader to recognize which CPU you are using.

  Step 4e     Back on the Computer, using the Teensy Loader, open 4Rose.hex.

Once this is loaded, the bottom message will change to reflect the file size.

  Step 4f     Press the button on the Teensy to load the program file.

Disconnect the computer from the Teensy, and then reboot the Teensy.

Step 5 - Upgrade the Nextion

Secure the microSD card which has the Nextion configuration file (from step 2). Put this microSD card into the Nextion's microSD card slot.

Reboot the Teensy again.

If this works as expected, the Nextion display will read (upside down, by the way)

Check Data . . . 100%

Updated Successed!

(guess that is a bad translation from Chinese).

After that message appears, remove the microSD card from the Nextion, and reboot the Teensy again.

Step 6 - Load the .ini file

  Step 6a     Secure the microSD card which has the 4Axes.ini settings file (from step 3). Put this microSD card into the Teensy's microSD card slot.

  Step 6b     Start the system and click the Load ini button.

Once completed, a message will appear saying

Done - Restart may be needed.

Reboot the system one last time.

Where is the "Load ini" button?

Based on the version you just installed, it may be in a different place.

Ver Comments
21 or
It is on the splash page, down on the bottom right.
Click the button with 3 dots to open the Preferences Screen (top right on the screen)
Click the More button (bottom left on the screen)
Click the Load Ini button (bottom right on the screen)
Step 7 - Verify the Settings

It is a good practice to verify all of the settings once you've completed the steps.

  1. Touch the Config button on each page and verify the Teensy column is populated with the same numbers as the Nextion column. Repeat for each axis on each page.

  2. Next verify the Preferences are correct for the Spindle, Axes, Limits, and Returns.

  3. Select the Main page, then the '...' (Preferences) page.
    Select the More page.
    Touch EEPROM.

    Repeat for each page and axis on the page. This will show all of the settings for the selected page.

Questions or comments? Contact us at