ELFOS
System Installation & Upgrade Procedure

The video to the right which shows these steps may be useful for you, but it is not required to perform the upgrade. The video was made to assist those who might find it a good learning tool for watching someone else perform the steps.

Prior Version Needed?
Click here to download the files.


Current Version: V3.0

The specific printed circuit board (PCB) you are using will matter for these instructions. The two current boards are shown in the images to the right, though the color of your board might be different.

The key delineators are:

4 Axis Board

Text on the board reads

Rose Engine Controller
Spindle and Three Axes V002c

There are 4 bi-color circles along one side of the board (shown on the bottom of the picture to the right).

5 Axis Board

Text on the board reads

Rose Engine Controller V003

There are 5 bi-color circles along one side of the board (shown on the bottom of the picture to the right).

There is also a version of this board with surface-mounted shifters; that one is typically blue.


Click on either picture above to see a larger size

Instructions are in blue. Commentary to help clarify the instructions is in black.

Step 1 - Get a copy of the Teensy program file
Teensy Model PCB ELFOS Version
3.0.5 3.0.8
3.2 4 Axis 5Rose_v305_t32.hex N/A
5 Axis
3.5 4 Axis 5Rose_v305_t35.hex 5Rose_v308_t35.hex
5 Axis
3.6 4 Axis 5Rose_v305_t36.hex 5Rose_v308_t36.hex
5 Axis
4.1 4 Axis N/A N/A
5 Axis

Download 5Rose_v305_txx.hex to your computer.

To save the file, click on the file's name on the right side of the screen (e.g., "5Rose_v305_t35.hex").

Comments  

Unsure which Teensy you have? The Teensy 3.5 is the most common, however if you are unsure of which one you have,

  1. Open the Teensy loader (as noted in step 4b below).
  2. Click on "Help" then turn on Verbose Information.
  3. Press the button (as shown on step 4d below). The Verbose Information screen will show which Teensy you have.

Best Practice Note: It is a best practice to right-click on the link for your appropriate Teensy model, then ensure the file is saved with the file name noted. For example, if you are trying to download the file for the Teensy 3.5, ensure it gets saved as "5Rose_v305_t35.hex". This is because some computer systems will add ".txt".to the end (e.g., making it "5Rose_v305_t35.hex.txt").

What about the Teensy 4.1? The code library used for programming this system has not been successfully upgraded for the Teensy 4.1. Once Ed gets that completed, we will post the upgrade.

Step 2 - Get a copy of the Nextion configuration file
Nextion Model PCB ELFOS Version
3.0.5 3.0.8
4.3" Enhanced 4 Axis RE305_43e.tft N/A
5 Axis
5" Intelligent 4 Axis N/A N/A
5 Axis RE305_5i.tft RE308_5i.tft
7" Intelligent 4 Axis N/A N/A
5 Axis RE305_7i.tft RE308_7i.tft

Get a copy of the Nextion configuration file.

Comments  

Unsure which Nextion you have? The 4.3" Enhanced is the most common, however if you try the wrong file it won't load. The Nextion display will not let you load the wrong one.

Why do the Nextion 5” and 7” Intelligent need the 5-axis PCB? The Nextion Intelligent displays require a higher voltage than the Nextion Enhanced series. This can be a problem which may cause the Teensy to fail due to over-voltage on the input pins. This is particularly true for the on the Teensy 3.6, and will be similarly for the Teensy 4.1.

The 5-axis PCB was designed with a Pololu 2595 daughter board for handling the voltage differences.

The 4-axis PCB can theoretically be used if you are using a Teensy 3.2 or 3.5. But the higher voltages for the Nextion Intelligent display does make this risky.

Should you upgrade to the 7” Nextion Intelligent? Yes.

Over time, the 5” display may be deprecated, and the 7” display is nicer. The case for the 7” Nextion Intelligent Display which can be 3D printed is available on Ed's Github Page in the Nextion folder.

Step 3 - Get a copy of the RE30.ini settings file
ELFOS Version
3.0.5 3.0.8
RE30.ini RE308.ini
Download RE30.ini, and put it in the root of a microSD card.This can be the same microSD card as in step #2. Details about the RE30.ini are available by clicking the web link at the start of this sentence.

The RE30.ini file is updated with each version. Get a copy of the new one if upgrading to a new version.

Comments  

Best Practice Note: It is a best practice to right-click on the link for the ini file, then ensure the file is saved with the file name noted ("RE30.ini"). This is because some computer systems will simply display the contents if you clik on the link.

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.
  • There is no need to remove the Teensy from the PCB to perform this step.
Comments  

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.

 

Teensy Loader on macOS

 

Teensy Loader on Linux and Windows

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

If you do not have the Teensy Loader installed on your computer, you can get it from https://www.pjrc.com/teensy/loader.html.

  Step 4c     Be sure the system shows that the Teensy is connected.

This is evident when

  • the Auto button is illuminated green, and
  • the picture of the Teensy is no longer grayed out.

As noted in step 4a above, if your USB cable is bad, the Teensy will not connect.

The default CPU selected will not handle the whole 5Rose_x.hex file, so if you try to open it, you will get the message on the bottom of the screen (where this picture shows "No file specified"):

5Rose_x.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 file button Teensy Loader (circled in red in the picture to the right), open 5Rose_x.hex.

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

  Step 4f     Select the download button (circled in red in the picture to the right) on the Teensy loader program to load the program file onto the Teensy.

  Step 4g     Select the reboot button (circled in red in the picture to the right) on the Teensy loader program to restart the Teensy.

Verify that it was successfully rebooted. If not, repeat the steps above (and if that does not work, your Teensy may be damaged and needing to be replaced).

Disconnect the computer from 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 controls system 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 controls system again.

Comments  

Error for too many .tft files?. When you delete the old .ini file from many computers, it gets renamed in a way that you can not see it. For example, on some systems

RE30.tft becomes ~E30.tft

It is not actually removed from the microSD card. The remediation is:
  1. Use a computer which lets you see hidden files, and delete the hidden one, or
  2. Re-format the microSD card. A good solution I use is SD Memory Card Formatter from SD Association. I will say I've had mixed luck with this approach though.
Step 6 - Load the .ini file

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

Comments  

Using a Teensy 3.2?. If you are using a Teensy 3.2, the microSD card will have to be inserted into a microSD card adapter.

  Step 6b     Start the system and click the ... button (top right), and then the Load ini button (left).

Note: Starting with version 24, there are text fields shown at the bottom of the screen (in the center). These are just to show that the command is working. These boxes only appear when Load Ini has been touched.

Watch the Key field to ensure each of the following are loaded:

  1. Preferences
  2. Limits
  3. Returns
  4. Main
  5. Multi
  1. Index
  2. Move
  3. Shared
  4. Sync
  1. Recip
  2. GreekKey
  3. Program
  4. Rose
First time loading the INI file?

The values of the INI file must be loaded for each section to enable the screens to work in the program. If the values are not set for a specific section, you will see it in the config settings screens as they will be blank.

A common problem is not having the key field update-to-date in the INI file. For example,

  • [Ind] was updated to be [Index].
  • [Ind] has been deprecated and the values in that section will not load in the current version.

Details about the RE30.ini are available by clicking the web link at the start of this sentence. This page also documents those items which have been deprecated.

If data for one of the keys did not load, check the contents of the RE30.ini file you are using against the latest RE30.ini. The field values are periodically changed, and if they are wrong, the values won't load for that section. Details about the RE30.ini are available by clicking the web link at the start of this sentence.

Once the INI file load has completed, a message will appear saying

Done - Restart may be needed.

Restart the system one last time.

Step 7 - Verify the Settings

Verification Checklist
After installing a new system or making a substantial upgrade to an existing system, consider using this checklist to verify everything works as is should.

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.

If some settings are not loaded, that screen will not run or at least will not run properly. Check your 4Axes.INI file against the latest one. As noted in step 6b above, some key field designators have changed in later versions.


Questions or comments? Contact us at
ColvinTools@Gmail.com
Disclaimers