No Description
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Paul Florence 66fdc1d83c Fix baudrate. 7 months ago
.cargo Implémentation de la connexion série. 11 months ago
robot_core Fix baudrate. 7 months ago
robot_debugger Meilleure récéption des trames. 11 months ago
.gitignore Implémentation de la connexion série. 11 months ago
.rustfmt.toml Meilleur formatage du code. 1 year ago
Cargo.toml Ajout du JenkinsFile. 1 year ago
Jenkinsfile Ajout du JenkinsFile. 1 year ago
README.md Ajout d'un peu de documentation et de quelques cas de test. 1 year ago
make_release.sh Implémentation de la connexion série. 11 months ago

README.md

Arborescence

Le projet contiens actuellement deux dossiers :

  • robot_core : il s’agit d’une librairie contenant tous les types primitifs pour implémenter le robot, comme Trame. Cette librairie contiens aussi des traits et des structures pratiques pour communiquer avec l’électronique.

  • robot_debugger : anciennement Can_Interface en C++, il s’agit d’une application qui permets d’afficher des Trame depuis une connexion série ou tcp.

Installation de l’environnement de dévelopement

Compilateur

Pour installer un compilateur pour rust, il faut d’abord installer rustup.

curl https://sh.rustup.rs -sSf | sh

Ensuite on peut ajouter une nouvelle toolchain, si ce n’est pas fait par défaut:

rustup toolchain install stable-x86_64-unknown-linux-gnu

Tu peut vérifier que tout marche en exécutant cargo build dans le dossier robot_core.

IDE

Le mieux est d’utiliser le plugin IntellijRust pour Clion ou Idea. A noter qu’en s’inscrivant avec le mail de l’INSA on a une license gratuite.

Il est aussi possible d’utiliser son combo éditeur de texte/terminal favori. Le support des différents éditeurs est disponible ici.

Librairies

Pour compiler robot_debugger il faut installer gtk3. Sur Ubuntu, le paquet à récuperer est libgtk-3-dev : apt-get install libgtk-3-dev. Il faut aussi installer libudev-dev.

Compiler la documentation

Pour compiler la documentation il faut exécuter cargo doc dans le projet où tu souhaites voir la documentation. Ensuite, celle-ci va se trouver dans target/doc/$CRATE_NAME.

Par exemple, pour voir la documentation de robot_core :

cd robot_core
cargo doc
firefox target/doc/robot_core/index.html

Cross-compilation

Pour cross-compiler vers windows tu vas avoir besoin de récupérer une nouvelle toolchain :

rustup target add x86_64-pc-windows-gnu

Analyse statique

Il est possible d’utiliser Clippy afin d’analyser le code à la recherche de motifs pouvant causer des bugs. Il faut commencer par installer Clippy :

cargo install clippy

On peut ensuite exécuter Clippy sur le projet robot_core (par exemple) en exécutant :

cd robot_core
cargo clippy

Ressources

As-tu besoin d’être convaincu par Rust ? Tu peut toujours lire ceci.

Apprentissage

Il commence à y avoir pas mal de littérature vis à vis de Rust, il est conseillé de jeter un coup d’oeil à ces liens :

Il existe aussi une série de post de blog, c’est toujours pratique pour apprendre surtout quand c’est en Français :

Enfin il y a une page github qui recense encore plus de ressources que tu peut toujours consulter.

 Aide

Tu as besoin d’aide ? Le meilleur moyen de résoudre ton problème est d’aller sur le chan #rust-beginners sur le serveur IRC de Mozilla. Si tu n’as pas de client IRC, tu peut aussi passer par une interface web.

Pour des questions plus complexes, tu peut ouvrir une issue sur github.