SEKTØR

Guides / Technical Reference

MIB2.5 customization guide
MIB2 Toolbox by jilleb

MIB

SEKTØR / Technical Guide

MIB2 Toolbox täysi muokkausopas.

MIB2 Toolboxilla voidaan muokata MIB2.5-järjestelmän käyttöliittymää, käynnistysruutua, skin-resursseja ja ajotilavalikon grafiikkaa. Tässä oppaassa asennetaan Toolbox, tehdään varmuuskopio, puretaan CANIM- ja MCF-tiedostot, muokataan kuvat ja pakataan resurssit takaisin autoon asennettaviksi.

Install

Asenna MIB2 Toolbox SD-kortilta.

Splash Screen

Pura ja pakkaa CANIM-käynnistysruutu.

Mode Selection

Muokkaa skin-resurssien images.mcf-tiedostoja.

Mahdollinen lopputulos

Ajotilavalikko voidaan muuttaa osaksi auton omaa ilmettä

Oikeilla skin-resursseilla Mode Selection -valikon kuvat voidaan vaihtaa auton väriin, malliin tai muuhun teemaan sopiviksi.

Lue ennen ensimmäistä muutosta

Kehittäjävalikon tasoista muokkausta

Toolbox kirjoittaa infotainment-järjestelmän tiedostoja. Väärä resurssi, keskeytetty kirjoitus tai väärään ohjelmistoversioon tarkoitettu tiedosto voi aiheuttaa graafisia virheitä, mustan käynnistysruudun tai kadonneita asetuksia.

Varmista virransyöttö ja tee varmuuskopio

Älä tee päivityksiä heikolla akulla. Älä poista SD-korttia tai katkaise virtaa kirjoitusprosessin aikana. Tee dump ennen ensimmäistäkään muutosta ja säilytä kopio sekä tietokoneella että erillisessä pilvipalvelussa.

Tarvikkeet ja ohjelmistot

Mitä tarvitset?

Storage

SD-kortti Toolboxille

Mieluiten yli 1 GB. Vanhaa ennen versiota 4.0 käytettyä korttia varten suositellaan alustusta.

Backup

Toinen kortti tai USB

Valinnainen, mutta suositeltava ikonipaketeille, muokatuille resursseille ja siirtoihin.

Software

Python 3

Tarvitaan CANIM- ja MCF-skriptien suorittamiseen. Asennuksessa valitaan Add Python to PATH.

Time

Rauhallinen työympäristö

Päivitystä tai tiedostojen kirjoittamista ei tehdä kiireessä tai heikolla akulla.

MIB2 Toolbox GitHub Lataa Toolbox v4.1

Osa 1

Asenna MIB2 Toolbox autoon

Toolbox asennetaan SD-kortilta MIB-yksikön normaalin ohjelmistopäivitysvalikon kautta.

Valmistele SD-kortti

Jos käytössä on vanha Toolbox ennen versiota 4.0, alusta SD-kortti.
Lataa repository GitHubista tai valmis ZIP-julkaisu.
Pura ladattu paketti tietokoneelle.
Kopioi kaikki tiedostot ja kansiot tyhjän SD-kortin juureen.

Tarkista kansiorakenne. Toolboxin varsinaisten tiedostojen pitää olla SD-kortin juuressa, ei yhden ylimääräisen pääkansion sisällä.

Avaa ohjelmistopäivitys

Laita SD-kortti MIB2-laitteen korttipaikkaan.
Pidä laitteessa vain yksi SD-kortti.
Paina ja pidä MENU-painiketta, kunnes huoltovalikko avautuu.
Avaa Software updates/versions.
Valitse Update.
Valitse SD-kortti.
Avaa MQB Coding MIB2 Toolbox.

Anna asennuksen valmistua

Anna päivityksen edetä loppuun koskematta laitteeseen.
Useat uudelleenkäynnistykset ja N/A-moduulit voivat olla normaaleja.
Etsi rivi, jossa Toolbox näyttää arvon Y.
Palaa takaisin.
Jos järjestelmä pyytää kytkemään tietokoneen vikakoodien poistoon, valitse Cancel.
Laite käynnistyy vielä kerran. Asennus on valmis.

Pikatarkistus:
MENU → TESTMODE → Green Developer Menu → mqbcoding

Osa 2

Päivitä Toolbox ja tee varmuuskopio

Päivitä mqbcoding ja skriptit

Ohita tämä vaihe, jos kyseessä on ensimmäinen asennus ja käytössä on valmiiksi uusin julkaisu.

Avaa Green Developer Menu → mqbcoding.
Valitse Update toolbox with a new mqbcoding.esd and scripts .
Seuraa näytön ohjeita.

Luo dump

Avaa mqbcoding → dump.
Suorita varmuuskopiointi loppuun.
Kopioi varmuuskopio tietokoneelle.
Tallenna toinen kopio pilvipalveluun tai muuhun erilliseen sijaintiin.

Älä säilytä ainoaa varmuuskopiota samalla SD-kortilla, jota käytät muokkauksiin.

Osa 3

Valmistele PC-työympäristö

CANIM- ja MCF-resurssit käsitellään Python-skripteillä. Selkeä kansiorakenne estää alkuperäisten tiedostojen, purettujen kuvien ja lopputulosten sekoittumisen.

Root

C:\MQBtool\

Splash

C:\MQBtool\startscreen\

Skin 0

C:\MQBtool\skinfiles\skin0\

Skin 1

C:\MQBtool\skinfiles\skin1\

Skin 4

C:\MQBtool\skinfiles\skin4\

Asenna Python 3. Valitse asennuksen aikana Add Python to PATH, jotta komennot toimivat suoraan PowerShellissä.

Osa 4 / CANIM

Käynnistysruudun muokkaus

Käynnistysruutu sijaitsee CANIM-tiedostossa. Kopioi alkuperäinen tiedosto, pura kuvat, muokkaa niitä muuttamatta resoluutiota tai nimiä ja pakkaa kokonaisuus takaisin.

Kopioi CANIM Varmuuskopiosta PC:lle

Pura kuvat extract-canim_vw.py

Muokkaa Samat nimet ja resoluutio

Pakkaa takaisin compress-canim_vw.py

Asenna autoon Customization → Startup Screen

Hae alkuperäinen splash varmuuskopiosta

Aseta tietokoneeseen SD-kortti, jolla on MIB Toolboxin varmuuskopio.
Avaa polku: dump → [HEADUNIT_SW_VERSION] → [LONG_VERSION_FOLDER] → splashscreen
Kansiosta löytyy esimerkiksi splash.canim tai mallikohtainen tiedosto kuten VWMIBHigh_SUA_GTI.canim.
Kopioi oikea CANIM-tiedosto tietokoneelle.

Valmistele tiedostot

Luo kansio C:\MQBtool.
Luo sen sisään kansio C:\MQBtool\startscreen.
Kopioi splash.canim startscreen-kansioon.
Kopioi Toolboxin tools-kansiosta:
- extract-canim_vw.py
- compress-canim_vw.py
Liitä molemmat skriptit kansioon C:\MQBtool.

Avaa PowerShell ja siirry työkalukansioon

PowerShell

Työhakemisto

cd \
cd mqbtool

Pura splash-kuvat

PowerShell

Extract CANIM

python extract-canim_vw.py .\startscreen\splash.canim .\startORIG\

Jos Python kysyy tarvittavien moduulien asentamisesta, hyväksy asennus.

Muokkaa puretut kuvat

Avaa startORIG-kansio.
Älä muuta kuvien resoluutiota.
Älä nimeä tiedostoja uudelleen.
Tallenna muokatut kuvat korvaamalla alkuperäiset tiedostot.

CANIM-pakkaus perustuu alkuperäiseen tiedostorakenteeseen. Muuttunut tiedostonimi tai koko voi aiheuttaa mustan käynnistysruudun.

Pakkaa splash uudelleen

PowerShell

Compress CANIM

python compress-canim_vw.py .\startscreen\splash.canim .\splash2.canim .\startORIG\

Komento luo tiedoston splash2.canim.

Siirrä uusi splash SD-kortille

Kopioi splash2.canim SD-kortin kansioon: Custom\Splashscreen
Jos kansiossa on jo splash.canim, nimeä se: splashbackup.canim.
Nimeä uusi tiedosto: splash2.canim → splash.canim.

Asenna splash autoon

Aseta SD-kortti slot 1 -paikkaan.
Avaa MIB Toolbox.
Siirry: Customization → Startup Screen.
Valitse uusi splash-tiedosto ja ota se käyttöön.

Jos näyttö jää mustaksi, palauta varmuuskopio.

Osa 5 / MCF

Mode Selection -taustakuvien muokkaus

Ajotilavalikon kuvat sijaitsevat skin-kohtaisissa images.mcf-tiedostoissa. Jokainen skin käsitellään erillään.

Kopioi skin-resurssit SD-kortilta

Kopioi images.res tai images.mcf niistä skin-kansioista, joita haluat muokata.

SD-kortin polut

\Skinfiles\Resources\skin0\
\Skinfiles\Resources\skin1\
\Skinfiles\Resources\skin4\

Luo kansiot tietokoneelle

PC-kansiorakenne

C:\MQBtool\skinfiles\skin0\
C:\MQBtool\skinfiles\skin1\
C:\MQBtool\skinfiles\skin4\

Laita jokaisen skinin tiedosto omaan kansioonsa. Esimerkiksi skin1:n images.mcf kuuluu kansioon C:\MQBtool\skinfiles\skin1\.

Siirry PowerShellissä MQBtool-kansioon

PowerShell

cd \
cd MQBtool

Pura skin1:n kuvat

PowerShell

Extract MCF

python extract-mcf.py .\skinfiles\skin1\images.mcf .\editskin1

Skripti kysyy:

Script prompt

Do you want to print the image number on each image (y/n)?

Vastaa n.

Puretut kuvat löytyvät kansiosta:

Output

.\editskin1Unsorted\

Muokkaa kuvat

Älä nimeä tiedostoja uudelleen.
Älä muuta kuvien resoluutiota tai kokoa.
Tallenna muokkaukset korvaamalla alkuperäiset kuvat Unsorted-kansiossa.

Muuta yksi skin kerrallaan. Näin mahdollinen virhe voidaan yhdistää oikeaan MCF-pakettiin.

Pakkaa kuvat takaisin MCF-tiedostoksi

PowerShell

Compress MCF

python .\compress-mcf_fixed.py .\skinfiles\skin1\images.mcf .\imageedited1.mcf .\editskin1unsorted

Komento luo tiedoston: imageedited1.mcf.

Siirrä valmis MCF SD-kortille

Kopioi imageedited1.mcf seuraavaan kansioon:

SD-kortti

\Custom\Skinfiles\skin1\

Vaihda kohdekansio sen mukaan, muokkasitko skin0-, skin1- vai skin4-resursseja.

Ota muokatut skin-resurssit käyttöön

Aseta SD-kortti autoon.
Avaa MIB Toolbox.
Siirry kohtaan Customization.
Valitse ja ota muokatut skin-resurssit käyttöön.
Käynnistä MIB-yksikkö uudelleen.

Tarkista lopputulos ennen seuraavaa muutosta. Jos grafiikat näkyvät oikein, tallenna toimiva MCF-tiedosto erilliseen varmuuskopiokansioon.

Tarkistus ja vianetsintä

Jos jokin ei toimi

Icons

Kuvat eivät vaihtuneet

Käynnistä MIB uudelleen, tarkista tiedoston nimi, kohdekansio ja valittu customization-toiminto.

Graphics

Näkyy graafisia virheitä

Tarkista resoluutio, tiedostonimi ja formaatti. Palauta alkuperäinen resurssi tai dump.

Diagnostics

Järjestelmä näyttää vikakoodeja

Anna laitteen käynnistyä täysin. Tee hallittu reboot ja lue pysyvät vikakoodit diagnostiikalla.

Yleisimmät kysymykset

FAQ

Voiko MIB2 Toolbox rikkoa infotainment-yksikön?

Väärin käytettynä kyllä. Suurin riski liittyy yhteensopimattomiin tiedostoihin, keskeytettyyn kirjoitusprosessiin ja puuttuvaan varmuuskopioon.

Miksi kuvien nimiä tai resoluutiota ei saa muuttaa?

CANIM- ja MCF-paketit viittaavat kuviin alkuperäisen rakenteen perusteella. Muuttunut nimi tai koko voi estää pakkaamisen tai aiheuttaa käyttöliittymävirheen.

Voiko yhden skinin komennon kopioida muille skineille?

Kyllä, kun vaihdat lähdekansion, tulostiedoston ja puretun kuvakansion vastaamaan oikeaa skin0-, skin1- tai skin4-kokonaisuutta.

Miksi PowerShell ei löydä Pythonia?

Pythonia ei ehkä lisätty PATH-ympäristömuuttujaan. Asenna Python uudelleen ja valitse Add Python to PATH, tai lisää sen polku manuaalisesti.

Miksi splash jää mustaksi?

Tyypillisiä syitä ovat väärä CANIM-pohja, muuttuneet tiedostonimet, väärä resoluutio tai epäonnistunut pakkaus. Palauta alkuperäinen splash tai koko varmuuskopio.

Pitääkö jokaisen muutoksen jälkeen käynnistää MIB uudelleen?

Käytännössä kyllä. Uudelleenkäynnistys varmistaa, että järjestelmä lataa uudet resurssit ja mahdolliset ongelmat näkyvät ennen seuraavaa muutosta.

Valmista. Kun mqbcoding näkyy Green Developer -valikossa, käynnistysruutu latautuu oikein ja Mode Selection näyttää uudet grafiikat ilman virheitä, kokonaisuus toimii.

Epävirallinen harrastajaopas

Yhteensopivuus, tiedostopolut, valikkonimet ja resurssit voivat vaihdella MIB-laitteen, ohjelmistoversion ja Toolbox-version mukaan. Muutokset tehdään käyttäjän omalla vastuulla. Tee aina varmuuskopio ja varmista käytössä olevan version dokumentaatio ennen järjestelmätiedostojen kirjoittamista.