Guide de configuration du système FLYOS-FAST

Ce guide sert à configurer la plateforme matérielle, le réseau, l’environnement d’impression, l’écran, la caméra et la communication CAN des appareils FLYOS-FAST. Les services système des H3, H5 et H618 se présentent de manière similaire, mais les options liées au matériel ne peuvent pas être copiées d’une plateforme à l’autre.

Confirmation avant la configuration

我没有收到您提供的 MDX 单行文本。请发送需要翻译的内容。

Projet	Contenu à confirmer
Image système	La plateforme de l’image correspond à la puce de l’appareil : H3, H5 ou H618
Modèle d'appareil	Pour sélectionner le bon board
Environnement d'impression	Utilisation de Klipper ou RRF
Affichage local	Sans écran, HDMI, FLY-TFT, KlipperScreen, FLY Screen ou écran série
Caméra	Non activée, Crowsnest, ou GoCam de la version bêta FLYOS-FAST v1.4.0
Vitesse CAN	Utilisation uniforme sur la carte mère, la carte outil et le système 1000000、500000 ou 250000

请提供需要翻译的中文短文本。 board

board Cela affecte la configuration matérielle telle que le port série, le SPI, l'écran et le MCU embarqué. Un choix incorrect peut rendre les interfaces indisponibles, provoquer des anomalies à l'écran ou une erreur de traitement du firmware au premier démarrage. Ne copiez pas d'abord la configuration complète puis modifiez le nom de l'appareil ; partez de l'image d'origine actuelle. config.txt Commencer la configuration élément par élément.

Configuration recommandée

1. Choisissez l'image système correspondant à l'appareil et board。
2. Configurez le Wi-Fi, le fuseau horaire et le nom de l’imprimante.
3. Choisir printer=klipper ou printer=rrf。
4. Choisissez le type d’écran réel et l’interface utilisateur de l’écran.
5. Activez la caméra ou Moon2UART selon les besoins, et testez-les un par un.
6. Définir uniformément la vitesse de tous les appareils lors de l’utilisation du CAN.
7. Après l’enregistrement, redémarrez et confirmez un par un les services et les interfaces matérielles.

Choisissez la méthode de configuration

• Configurer Myprint
• 直接修改配置文件

Utilisation de Config Myprint pour configurer la carte système

Config Myprint est adapté à la configuration graphique de la carte système avant le premier démarrage. Connectez la carte système flashée à l'ordinateur, ouvrez le logiciel et attendez qu'il identifie la partition FlyOS-Conf.

Interface logicielle et version de l'image

Les options disponibles dans le logiciel peuvent être mises à jour plus tard que l'image de test. Après l'écriture, ouvrez FlyOS-Conf/config.txt et vérifiez que board, l'écran, la caméra et le débit CAN correspondent aux périphériques réels. Les nouvelles options de configuration non affichées dans le logiciel doivent être ajoutées manuellement, sans utiliser de noms similaires en remplacement.

Première étape : Activer la configuration système

Activez l'interrupteur Activer la configuration système.

Loading...

Deuxième étape : Effectuer les réglages de base

Gestion des fichiers de configuration

• Sélectionnez uniquement le dossier contenant les fichiers de configuration de la imprimante, ne sélectionnez pas un fichier individuel.
• Le logiciel copiera les configurations du dossier sélectionné vers la carte système et les chargera au premier démarrage.
• Avant l'écriture, assurez-vous que le dossier ne contient pas de printer.cfg résiduel d'une autre imprimante ou de configurations en double.

Loading...

Réseau Wi-Fi

Renseignez un nom de réseau Wi-Fi et un mot de passe disponibles. Ces champs peuvent être laissés vides si vous utilisez un réseau filaire ou si vous prévoyez de configurer le Wi-Fi ultérieurement.

Loading...

Interface web Klipper

Choisissez Fluidd ou Mainsail. Cette option n'affecte que l'interface web utilisée par défaut en mode Klipper.

Loading...

Affichage local

Sélectionnez l'interface d'affichage réellement connectée, puis décidez d'activer KlipperScreen ou FLY Screen. Si les deux sont activés, le système lancera KlipperScreen en priorité ; lors de l'utilisation de FLY Screen, KlipperScreen doit être désactivé.

Loading...

Troisième étape : Effectuer les réglages avancés

Nom de l'imprimante

Définissez un nom d'imprimante facile à identifier. Il est recommandé d'utiliser uniquement des lettres anglaises, des chiffres, des tirets et des underscores.

Loading...

Service de caméra

Activez Crowsnest selon les besoins. Pour utiliser GoCam avec l'image bêta v1.4.0, vérifiez après l'écriture que dans config.txt, crowsnest=0 et gocam=1 ; les deux services ne doivent pas être activés simultanément.

Loading...

Langue et fuseau horaire

Choisissez la langue initiale du système et le fuseau horaire réel. Une fois le système connecté au réseau, l'heure sera affichée selon ce fuseau horaire.

Loading...

Débit de communication CAN

Sélectionnez un débit cohérent avec le firmware de la carte mère et de toutes les cartes d'outils CAN. Les valeurs courantes sont 1000000, 500000 ou 250000 ; sur un même bus CAN, différents débits ne doivent pas être mélangés.

Loading...

Quatrième étape : Écrire et vérifier

Après avoir effectué tous les réglages, cliquez sur Écrire manuellement la configuration. Si vous sélectionnez uniquement des options dans l'interface sans cliquer sur écrire, la configuration ne sera pas enregistrée sur la carte système.

Loading...

Après l'écriture, effectuez les vérifications suivantes :

1. Ouvrez FlyOS-Conf/config.txt.
2. Confirmez que board correspond exactement au périphérique réel.
3. Confirmez que seules les interfaces d'écran et les services de caméra nécessaires sont activés.
4. Confirmez que canbus_bitrate est cohérent avec le firmware de tous les périphériques CAN.
5. Après sauvegarde, éjectez en toute sécurité la carte système, puis insérez-la dans l'appareil cible pour démarrer.

Modification du fichier de configuration

Le fichier de configuration système de FLYOS-FAST apparaît sous différents noms selon l'emplacement, mais pointe en réalité vers la même configuration :

Cas d'utilisation	Emplacement du fichier	Situation applicable
Carte système connectée à un ordinateur	FlyOS-Conf/config.txt	Configuration du réseau, du modèle d'appareil et des options d'initialisation avant le premier démarrage
À l'intérieur du système Linux	/config/config.txt	Vérification de la configuration via SSH
Fluidd / Mainsail	.flyos-config/sys-config.conf	Modification en ligne des options lues à chaque démarrage après le démarrage du système

À savoir avant modification

• Sauvegardez d'abord le fichier de configuration d'origine.
• Conservez le format clé=valeur, ne le modifiez pas en clé : valeur.
• Ne dupliquez pas les éléments de configuration du même nom ; pour modifier, éditez directement la valeur d'origine.
• N'utilisez pas la fonction de traduction du navigateur pour éditer la configuration, afin d'éviter que le contenu ne soit modifié.
• Utilisez de préférence uniquement des lettres anglaises, des chiffres, des tirets et des underscores pour les noms et chemins.
• Ne modifiez pas le contenu situé après ######### VEUILLEZ NE PAS MODIFIER CE QUI SUIT #########.

• Modifier la carte système avant le premier démarrage
• Modifier via le Web après le démarrage du système

1. Après avoir gravé l'image, reconnectez la carte système à l'ordinateur.
2. Ouvrez le disque amovible nommé FlyOS-Conf.
3. Ouvrez config.txt avec un éditeur de texte brut.
4. Modifiez board en fonction de l'appareil réel, puis configurez le Wi-Fi, le mode d'impression, l'écran et la vitesse CAN.
5. Enregistrez le fichier et éjectez la carte système en toute sécurité, puis insérez-la dans l'appareil pour démarrer.

Éléments de premier démarrage

Les éléments d'initialisation tels que language, printer_name et firmware doivent être modifiés ici. Une fois le premier démarrage du système effectué, la modification de ces valeurs ne relancera pas le processus d'initialisation.

1. Assurez-vous que l'ordinateur et l'ordinateur hôte sont connectés au même réseau.
2. Ouvrez l'adresse IP de l'appareil dans le navigateur, par exemple http://192.168.1.2/.
3. Dans Fluidd, décochez « Filtrer les fichiers et dossiers cachés », ou dans Mainsail, cochez « Afficher les fichiers cachés ».

Loading...

Loading...

4. Ouvrez sys-config.conf dans le dossier .flyos-config.

Loading...

5. Modifiez les éléments de configuration nécessaires et enregistrez.

Loading...

6. Redémarrez complètement l'ordinateur hôte pour recharger les services système et la configuration matérielle.

Limites de modification via le Web

La méthode Web convient pour modifier les configurations lues à chaque démarrage. Les éléments d'initialisation manqués après le premier démarrage ne peuvent pas être réexécutés par un simple redémarrage ; utilisez la méthode de modification propre à chaque fonction concernée.

Vérification après enregistrement

Après le redémarrage, vérifiez au moins les éléments suivants :

• La page Web s'ouvre correctement, et le mode d'impression ainsi que l'interface Web sont correctement sélectionnés.
• L'écran local, l'orientation tactile et l'interface utilisateur de l'écran fonctionnent correctement.
• Les services optionnels tels que la caméra et Moon2UART n'ont démarré que celui qui est nécessaire.
• En cas d'utilisation du CAN, la vitesse du système correspond exactement à celle du firmware de la carte mère et de la carte outil.
• Klipper ou RRF peut se connecter correctement à la carte de contrôle correspondante.

Si le système ne démarre pas correctement après modification, connectez la carte système à l'ordinateur, restaurez le config.txt d'origine, puis modifiez et vérifiez élément par élément.

Voir les options de configuration par plateforme

• H618 : C5 / C8P / Pi V3
• Appareils H3 / H5

Options de configuration H618

Les valeurs par défaut et les valeurs optionnelles ci-dessous ont été vérifiées par rapport au fichier FlyOS-Conf/config.txt de l'image officielle H618 v1.3.10 ; les configurations ajoutées dans l'image de test v1.4.0 seront indiquées séparément.

Réseau sans fil

WIFI_SSID et WIFI_PASS sont lus à chaque démarrage. Lorsque vous utilisez un réseau ouvert, le mot de passe peut être laissé vide ; lorsque vous utilisez un réseau sécurisé, les deux champs doivent être renseignés.

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
WIFI_SSID	Vide	Nom du Wi-Fi	Une fois renseigné, le système se connecte automatiquement à ce réseau au démarrage
WIFI_PASS	Vide	Mot de passe Wi-Fi	Peut être laissé vide pour les réseaux ouverts

Paramètres de premier démarrage

language, printer_name et firmware sont utilisés uniquement lors du processus de premier démarrage après le flashage de l'image complète. Une fois le premier démarrage du système terminé, la modification de ces éléments ne réexécutera pas l'initialisation.

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
language	zh-CN	zh-CN, en, ja, ko et autres codes de langue listés dans l'image	Définit la langue initiale de Fluidd et Mainsail
printer_name	Vide	Tout nom sans caractères spéciaux	Définit le nom initial de l'imprimante
firmware	/usr/lib/firmware/klipper/stm32h723-128k-usb.bin	Chemin du firmware dans l'image, ou /config/klipper.bin	Pour C5, C5 V1.1, C8P, le MCU de la carte peut être flashé automatiquement selon board au premier démarrage ; Pi V3 n'utilise pas cette option pour flasher les cartes mères externes

Conditions de flashage automatique

Le flashage automatique n'est exécuté que si le marqueur de premier démarrage existe, que board et firmware sont tous deux valides et que le fichier du firmware est présent. Ne créez pas manuellement le marqueur de premier démarrage pour répéter le flashage ; pour la maintenance ultérieure du firmware, veuillez suivre le tutoriel de flashage du firmware de la carte mère correspondante.

Système et carte mère

Les paramètres suivants sont lus à chaque démarrage.

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
board	none	fly-c5, fly-c5-v1.1, fly-c8p, fly-pi-v3	Sélectionne le modèle réel de l'appareil ; cette valeur affecte la configuration des ports série et SPI du H618
localtime	Asia/Shanghai	Fuseau horaire mondial	Fuseau horaire du système utilisé après la synchronisation de l'heure via le réseau
printer	klipper	klipper, rrf	Sélectionne l'environnement de contrôle d'impression à démarrer
console	serial	serial, both	Définit la console système ; maintenez la valeur par défaut sans besoin spécifique
canbus_bitrate	1000000	1000000, 500000, 250000	Définit le débit de l'interface CAN du système, il doit correspondre à tous les périphériques CAN du bus

Choisir correctement board

La configuration d'origine de l'image est board=none, l'appareil essaiera d'abord de lire le résultat d'identification matérielle ; si l'identification échoue toujours, H618 v1.3.10 utilisera fly-c5 comme valeur de repli. Par conséquent, les utilisateurs de C8P, C5 V1.1 et Pi V3 doivent clairement sélectionner leur modèle d'appareil avant le premier démarrage et ne pas compter sur la valeur de repli.

Les périphériques H618 activés selon les différentes valeurs de board sont les suivants. Ce tableau sert uniquement à expliquer les conséquences d'une mauvaise sélection et ne signifie pas que ces ports série ou SPI peuvent être réaffectés à d'autres usages.

Valeur de configuration board	Périphériques de bord activés par le système
fly-c5	UART1
fly-c5-v1.1	UART1, SPI1.2
fly-c8p	UART1, UART3, UART4, SPI1.2
fly-pi-v3	UART1, UART3, UART4, SPI1.2

Écran et interface

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
screen	hdmi	none, hdmi, fly-tft-v2-r, fly-tft-v2-c	Sélectionne l'interface d'affichage ; none désactive la sortie d'affichage locale
rotate	auto	auto, 0, 90, 180, 270	En mode auto, HDMI est à 0 degré par défaut et FLY-TFT à 90 degrés par défaut ; les angles manuels s'appliquent également à l'affichage et à l'orientation tactile HDMI
klipper_screen	0	0, 1	Active KlipperScreen en mode Klipper
fly_screen	0	0, 1	Active FLY Screen en mode Klipper
moon2uart	0	0, 1	Active le service d'écran série Moon2UART
m2u_port	/dev/ttyS1	Chemin réel du périphérique série	Port série utilisé par Moon2UART
m2u_baud	115200	Débit en bauds requis par l'écran	Vitesse de communication série Moon2UART

Lorsque klipper_screen=1 et fly_screen=1 sont définis simultanément, le système démarre KlipperScreen en priorité. Lors de l'utilisation de FLY Screen, définissez klipper_screen=0 et fly_screen=1.

La mise à niveau OTA conserve l'ancienne configuration

Après une mise à niveau OTA depuis une version plus ancienne, config.txt peut manquer fly_screen, m2u_port ou m2u_baud. Si les fonctions correspondantes sont nécessaires, vous pouvez ajouter ces options en vous référant au tableau ci-dessus.

Interface web Klipper et caméra

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
klipper_webui	fluidd	fluidd, mainsail	Interface web utilisée en mode Klipper
crowsnest	0	0, 1	Active ou désactive le service de caméra

Configurations de la version bêta v1.4.0

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
gocam	0	0, 1	Active le service de caméra UVC GoCam

La version officielle v1.3.10 ne dispose pas de gocam. Dans la version bêta v1.4.0, si crowsnest=1 et gocam=1 sont définis simultanément, le système démarre Crowsnest en priorité. Lors de l'utilisation de GoCam, définissez clairement crowsnest=0 et gocam=1.

Méthode d'utilisation de GoCam : Voir le service de caméra GoCam

Arrêt sur coupure de courant

Dans la configuration d'origine de H618 v1.3.10, shutdown_pin_state et shutdown_pin sont commentés par défaut, c'est-à-dire que la détection d'arrêt sur coupure de courant est désactivée. Les niveaux de déclenchement peuvent varier selon les produits et les versions matérielles. Veuillez vous référer à la documentation « Arrêt sur coupure de courant et reprise après coupure » du produit correspondant et ne copiez pas directement les valeurs d'autres appareils.

Fonctions mutuellement exclusives

L'arrêt sur coupure de courant et la reprise après coupure ne peuvent pas être activés simultanément. Si vous avez besoin de la reprise après coupure, maintenez la détection d'arrêt sur coupure de courant désactivée.

Configuration avancée

Option de configuration	Valeur par défaut	Valeurs optionnelles	Description
spidev	spidev0.0	Combinaisons de périphériques SPI explicitement indiquées dans la documentation produit	Contrôle le périphérique SPI fourni à l'espace utilisateur Linux

Les éléments tels que spidev, overlays sont utilisés pour l'activation matérielle de bas niveau. Sauf exigence explicite d'un tutoriel produit, conservez les valeurs par défaut de l'image et ne modifiez pas le contenu après la ligne ######### PLEASE DO NOT EDIT THE FOLLOWING #########.

Options de configuration H3 / H5

Les configurations suivantes ont été vérifiées par rapport au fichier FlyOS-Conf/config.txt de l'image officielle H3, H5 v1.3.10. Les configurations de services des deux plates-formes sont essentiellement identiques, mais les options board, les modèles d'écran et les options matérielles de bas niveau ne doivent pas être mélangés.

Réseau sans fil

Élément de configuration	Valeur par défaut	Valeurs possibles	Description
WIFI_SSID	Vide	Nom du Wi-Fi	Une fois renseigné, le système tente de se connecter à ce réseau au démarrage
WIFI_PASS	Vide	Mot de passe du Wi-Fi	Peut être laissé vide pour un réseau ouvert

Ces deux éléments sont lus à chaque démarrage. Si le nom ou le mot de passe contient des espaces et des caractères spéciaux, le format entre guillemets de l'image doit être conservé.

Paramètres de premier démarrage

Élément de configuration	Valeur par défaut	Valeurs possibles	Description
language	zh-CN	Codes de langue répertoriés dans l'image	Définit la langue initiale de Fluidd et Mainsail
printer_name	Vide	Nom sans caractères spéciaux	Définit le nom initial de l'imprimante
firmware	Désactivé par défaut	Chemin du firmware spécifié dans la documentation produit	À utiliser uniquement lorsque le produit correspondant prend explicitement en charge le flashage au premier démarrage

language, printer_name et firmware ne sont utilisés que lors du processus de premier démarrage après le flashage complet de l'image. Ne décommentez pas firmware de votre propre initiative et ne copiez pas les chemins de firmware d'autres produits.

Plate-forme de l'appareil et board

Plate-forme de l'image	Appareil	Valeur de configuration board
H5	FLY-Pi	fly-pi
H5	FLY-Pi V2	fly-pi-v2
H5	FLY-Gemini V1	fly-gemini-v1
H5	FLY-Gemini V2	fly-gemini-v2
H5	FLY-Gemini V3	fly-gemini-v3
H5	FLY-C8	fly-c8
H3	FLY-Lite2	fly-lite2
H3	FLY-Lite2.1	fly-lite2.1
H3	FLY-MiniPad	fly-minipad

L'image et l'appareil doivent correspondre

L'image H5 ne peut pas utiliser la valeur board de H3, et l'image H3 ne peut pas utiliser la valeur board de H5. Le script de démarrage refusera les valeurs d'appareil qui n'appartiennent pas à la plate-forme actuelle. Avant le premier démarrage, précisez clairement l'appareil réel et ne vous fiez pas aux valeurs par défaut de l'image.

La valeur par défaut originale de l'image H5 v1.3.10 est board=fly-pi-v2, et celle de l'image H3 v1.3.10 est board=fly-lite2.1. La valeur par défaut ne peut être conservée que si l'appareil réel correspond exactement à ces modèles.

Système et communication

Élément de configuration	Valeur par défaut	Valeurs possibles	Description
localtime	Asia/Shanghai	Noms de fuseaux horaires mondiaux	Fuseau horaire du système utilisé après synchronisation de l'heure en ligne
console	serial	serial, both	Mode de console système ; conservez la valeur par défaut sans besoin spécifique
printer	klipper	klipper, rrf	Sélectionne l'environnement d'impression Klipper ou RRF au démarrage
canbus_bitrate	1000000	1000000, 500000, 250000	Débit CAN du système, doit être identique sur tous les appareils du bus

Type d'écran

Plate-forme de l'image	Valeurs possibles de screen
H5	none, hdmi, fly-tft-v1, fly-tft-v2-r, fly-tft-v2-c
H3	none, hdmi, fly-tft-v1, fly-minipad-r, fly-minipad-c, fly-tft-v2-r, fly-tft-v2-c

Élément de configuration	Valeur par défaut	Valeurs possibles	Description
screen	hdmi	Valeurs prises en charge par la plate-forme actuelle dans le tableau ci-dessus	Sélectionne l'interface d'affichage ; none désactive la sortie d'affichage locale
rotate	auto	auto, 0, 90, 180, 270	En mode auto, HDMI utilise par défaut 0 degré et TFT utilise par défaut 90 degrés
klipper_screen	0	0, 1	Active KlipperScreen en mode Klipper
fly_screen	0	0, 1	Active FLY Screen en mode Klipper
moon2uart	0	0, 1	Active le service d'écran série Moon2UART
m2u_port	/dev/ttyS1	Chemin du port série spécifié dans la documentation produit	Port série utilisé par Moon2UART
m2u_baud	115200	Débit en bauds requis par l'écran	Vitesse du port série Moon2UART

Lorsque klipper_screen=1 et fly_screen=1 sont définis simultanément, le système démarre KlipperScreen en priorité. Le modèle d'écran, la direction de l'interface et le chemin du port série doivent être conformes à la documentation du produit correspondant.

Interface Web et caméra

Élément de configuration	Valeur par défaut	Valeurs possibles	Description
klipper_webui	fluidd	fluidd, mainsail	Interface Web utilisée par défaut en mode Klipper
crowsnest	0	0, 1	Active ou désactive le service de caméra Crowsnest

Les images officielles H3 et H5 v1.3.10 ne comportent pas l'élément de configuration gocam ; ne reprenez pas les paramètres de l'image de test v1.4.0.

Arrêt sur coupure de courant et configuration avancée

shutdown_pin_state, shutdown_pin, spidev et overlays sont liés au matériel spécifique de l'appareil. Ne les modifiez que si la documentation produit correspondante fournit des valeurs explicites ; ne copiez pas les configurations d'autres cartes mères, d'autres versions matérielles ou d'autres plates-formes de puces.

L'arrêt sur coupure de courant et la reprise après coupure de courant ne peuvent pas être activés simultanément. Si la reprise après coupure est nécessaire, désactivez la détection d'arrêt sur coupure de courant conformément au tutoriel du produit correspondant.

Combinaisons de fonctions courantes

Objectif	Configuration clé	Précautions
Utilisation du web uniquement, pas d'écran local	screen=none、klipper_screen=0、fly_screen=0	L'écran série Moon2UART peut être activé indépendamment selon les besoins
HDMI + KlipperScreen	screen=hdmi、klipper_screen=1、fly_screen=0	rotate Réglage de l'affichage et de l'orientation tactile
Utilisation de FLY Screen klipper_screen=0、fly_screen=1	screen Interface d’affichage réel encore à sélectionner
Utilisation de Crowsnest crowsnest=1 La version bêta v1.4.0 doit également rester compatible. gocam=0
Utiliser GoCam	crowsnest=0、gocam=1 Uniquement pour l'image bêta v1.4.0 ;Consultez le tutoriel
Utilisation de Moon2UART moon2uart=1 Simultanément vérifier m2u_port Et m2u_baud
Utiliser CAN	Définir une norme unifiée canbus_bitrate Système, carte mère et tous les nœuds CAN doivent être cohérents.

Vérification de l’achèvement après redémarrage

Élément de vérification	Résultat normal
Réseau	Accessible via l'adresse IP de l'appareil ou l'adresse de connexion directe 10.10.10.1 Ouvrir la page web
Plateforme d'équipement	Les fonctions série, SPI et embarquées sont identiques au produit réel
Service d'impression	Klipper ou RRF ne lancent que l'environnement sélectionné
Écran	Affichage, tactile et rotation normaux
Caméra	Exécutez uniquement l’un des éléments sélectionnés entre Crowsnest ou GoCam
CAN	Tous les nœuds peuvent être interrogés sans erreur d’incohérence de débit

Modifiez un groupe d'options connexes à la fois. En cas d'anomalie, restaurez d'abord la configuration de ce groupe, sans modifier plusieurs éléments en même temps. board、écran、CAN et paramètres matériels avancés, afin de ne pas être incapable de déterminer la source du problème.