MediaTek Git01 Account Setup

Important

Since v26.0, the service hosting NDA repositories is changed from GitLab to MediaTek Git01. To access the MediaTek Git01 service, a Genio Developer account is required. Please read below for more information.

IoT Yocto is hosted across two services — GitLab and MediaTek Git01 — depending on the configuration:

  • Public configurations are built with packages and recipes that are openly available. This configuration lacks some proprietary features. Furthermore, certain proprietary components, such as libdram, are provided in binary-only format.

  • Private configurations are a functional superset of the public configurations, and require access to private repositories. The additional features are:

    • Access to source code for components related to custom board bring-up

    • MT7663 proprietary Wi-Fi driver on Genio 350

    • eFuse writer on all Genio platform

    • ISP support on Genio 1200

For example, the Linux kernel fork for IoT Yocto is hosted at https://gitlab.com/mediatek/aiot/bsp/linux and is publicly accessible without an account. However, certain proprietary packages hosted on the MediaTek Git01 service are permission-controlled and subject to separate license agreements. Building these proprietary packages is disabled by default and can be enabled during the build process.

The prebuilt images for private configurations are available in the Download page.

Note

You may skip to Environment Setup if you don’t intend to build the private configuration. If you want to build the private configuration, e.g., customize your own board design, please continue to read the following sections.

Private Configuration Overview

You can modify and build a public image for Genio EVK boards without NDA access. However, bringing up a custom board design requires NDA access to proprietary packages and tools.

To obtain this access, you need to:

  1. Sign up for a Genio Developer account.

    Important

    Note that Genio Developer account is different from the MediaTek Git01 account. The Genio Developer account is required before obtaining the MediaTek Git01 account.

  2. Sign an electronic NDA for the Genio platform.

  3. Create a Git01 account from the Genio Developer Account Center.

  4. Generate access tokens for tools such as git to access source code repositories.

The following sections describe each step in detail.

1. Sign Up Genio Developer Account

Note

If you already have a Genio Developer account, you may skip this section.

Please follow the steps to create a Genio Developer account:

  1. Visit the registration page to create a new account.

  2. Check your email inbox and click the validation link in the confirmation email sent from mediatek.com. You might want to check your junk mailbox if you didn’t see it in your inbox.

  3. Log in to https://genio.mediatek.com/account/login with your email and password.

2. Sign Electronic NDA for Genio Platform

Note

If you have already signed the NDA for Genio, you may skip this section.

Before obtaining a MediaTek Git01 account, you must sign an electronic NDA (non-disclosure agreement) through the Genio Developer Account Center:

  1. Log in and navigate to the Advanced Resource Access section in your Profile Page.

  2. Find NDA for Genio and click the Online NDA Application button. Fill out and submit the NDA application form.

The MediaTek Genio team will review your application. Once approved, you will receive an email to sign the electronic NDA. Upon completion, the NDA status in your Profile Page will be updated to Valid.

For a detailed step-by-step guide, refer to the Genio Community forum post.

3. Create Git01 Account

After your NDA has been approved, you can create a MediaTek Git01 account directly from the Genio Developer Account Center. The steps are described below:

  1. Log in to the Genio Developer Account Center and navigate to your Profile page.

  2. Scroll down to the NDA for Genio section. Once your NDA status is Valid, a Create Account button will appear. Click it to initiate MediaTek Git01 account creation.

    ../../../_images/sw_yocto_get-started_account-setup_git01-create-account.png

  3. After clicking, the status changes to Account creation in progress. Refresh the page periodically to check for updates.

    ../../../_images/sw_yocto_get-started_account-setup_git01-in-progress.png

  4. Once the process is complete, your MediaTek Git01 account name will be displayed on the page.

    ../../../_images/sw_yocto_get-started_account-setup_git01-account-name.png

  5. Check your email inbox for the credentials sent by the MediaTek Git01 service. If the email has not arrived, also check your spam or junk mail folder.

Note

If you encounter any issues during the MediaTek Git01 account creation process, contact the Genio NDA team at genio_nda@mediatek.com for assistance.

4. Generate Access Token

Important

Please complete 3. Create Git01 Account before continuing.

To fetch source code from Git repositories via the HTTPS protocol, you must create an access token and use it as your Git password instead of your login password.

The steps for creating an access token are outlined below:

  1. Visit MediaTek Git01 service and log in with the username and password of your MediaTek Git01 account.

  2. Navigate to the HTTP Credentials page, or go to your Git01 dashboard, select Settings and then select HTTP Credentials.

  3. Click GENERATE NEW PASSWORD button, a pop-up dialog will appear displaying the generated token. Copy the token and store it in a secure storage, preferably a password manager.

For detailed steps, please visit Git01 First-Time Login and Token Setup.

After generating the token, run the account setup script provided by MediaTek to configure your environment:

curl -L https://gitlab.com/mediatek/aiot/rity/meta-mediatek-bsp/-/raw/scarthgap/scripts/genio-account-setup.py > genio-account-setup.py
python3 genio-account-setup.py

The script prompts for your credentials and configures the necessary settings for fetching Git repositories over HTTPS.

Note

If you lose your access token, you can regenerate it at any time from the HTTP Credentials page. The previous token is invalidated immediately upon regeneration.

5. Confirm Your Account Setup

Run the following verification steps before proceeding to fetch and build IoT Yocto:

  1. Confirm account permission: Verify that you can access https://git01.mediatek.com/plugins/gitiles/genio/nda/libdram/+/refs/heads/main.

  2. Confirm git HTTPS configuration: Verify that you can fetch the repository from your Linux host machine:

    # Use generated access token as password, not your Git01 password.
git clone https://git01.mediatek.com/genio/nda/libdram.git

  3. If successful, delete the libdram directory that’s created:

    rm -Rf libdram

If any of the steps above fail, review your access token settings and ensure the token was copied correctly.