Skip to main content

Overview

The first step sets up your build environment by creating the initial configuration file (seed.conf) and defining the three main directory locations:
  • SRC: Where source files will be downloaded
  • BLD: Where temporary build files will be stored
  • BIN: Where compiled libraries will be installed
This is a once-only configuration step. You only need to run this when setting up Miele-LXIV Easy for the first time.

Running the Configuration

1

Navigate to EASY_HOME

Open Terminal and navigate to the directory where you downloaded/cloned Miele-LXIV Easy:
cd $EASY_HOME
Replace $EASY_HOME with the actual path to your Miele-LXIV Easy directory.
2

Run the build script

Since seed.conf doesn’t exist yet, running build.sh will automatically launch the configuration interface:
./build.sh
3

Configure your settings

The kconfig-mconf interface will appear. Here you can:
  • Review and accept the default directory paths (recommended)
  • Or define your own custom paths if needed
  • Select your version set file (use the default unless you have specific requirements)
Recommendation: If you’re setting up for the first time, accept all defaults to get a tried and tested configuration.
Configuration Menu
4

Save and exit

Navigate through the menu and:
  1. Select Save
  2. Confirm with Ok
  3. Select Exit
  4. Confirm Exit again

What Happens

When you complete this step:
  1. The seed.conf file is created in $EASY_HOME
  2. A log/ directory is created for capturing build logs
  3. Your directory paths and version selections are saved
  4. A timestamp is appended to the configuration

The kconfig-mconf Interface

The configuration interface uses the same tool that Linux uses for kernel configuration. It provides:
  • Navigation: Use arrow keys to move through options
  • Selection: Press Space to toggle options, Enter to select menus
  • Help: Press ? on any option to see detailed help text
  • Save: Writes your configuration to files
  • Exit: Leaves the configuration interface

Configuration File Location

After completion, you’ll find:
$EASY_HOME/
├── seed.conf          # Your configuration settings
├── log/              # Directory for build logs
└── build.sh          # Main build script

Verifying Configuration

You can verify your configuration was created successfully:
cat seed.conf
You should see entries for your SRC, BLD, and BIN directories, along with a timestamp.

Common Settings

The configuration will ask you to define:
  • CONFIG_SRC_DIR: Source directory path
  • CONFIG_BLD_DIR: Build directory path
  • CONFIG_BIN_DIR: Install/binaries directory path
These can be relative or absolute paths.
The version set file defines which versions of all third-party libraries will be downloaded and built. The default version set has been tested and is recommended.
Choose between Xcode (recommended) or Unix Makefiles as the CMake generator.

Troubleshooting

If you see “Please install kconfig-mconf”, you need to install the kconfig-mconf tool first. See the Prerequisites Guide.
If you see “Please install the command-line cmake”, install cmake via Homebrew or from the CMake.app package. See the Prerequisites Guide.

Next Step

Step 2: Download Sources

Now that your build environment is configured, proceed to download the third-party library sources.

Build docs developers (and LLMs) love