finished writting a simple user manual

Readme.fr.md

@@ -25,7 +25,7 @@ Pour savoir comment assembler/imprimer ce masque, voir la [_section sur l'assemb
 
 ### Entretien
 
-Il est recommandé d'appliquer de la graisse (de préférence de la vaseline alimentaire) autour du filetage, autour du connecteur du masque d'insuflation et autour du périmètre de la valve à sens unique pour améliorer l'étanchéité.
+Il est recommandé d'appliquer de la graisse (de préférence de la vaseline alimentaire) autour du filetage, autour du connecteur du masque d'insufflation et autour du périmètre de la valve à sens unique pour améliorer l'étanchéité.
 
 Si vous utilisez un filtre imprimé en 3D - _ou DIY_ - (_comme décrit dans [la section ci-dessous](#1-b-cartouche-de-masque-à-gaz)_), changez régulièrement le matériau filtrant - en général du charbon actif - et nettoyez la cartouche si vous ne le changez pas.
 
@@ -81,7 +81,7 @@ L'assemblage du masque est très simple, il vous faudra tout d'abord imprimer :
  - _En option :_ des fournitures pour une vanne unidirectionnelle d'entrée : :warning: **_Nécessite la modification des paramètres du fichier du tube adaptateur !_** :warning:
     - 1 base pour la vanne unidirectionnelle [3Dfiles/one_way_valve/owv_base_cap.stl](./3Dfiles/one_way_valve/)
     - soit 1 insert de membrane pour la vanne unidirectionnelle [3Dfiles/one_way_valve/owv_membrane_insert.stl](./3Dfiles/one_way_valve/), soit 1 membrane séparée (_imprimée en TPU_) [3Dfiles/one_way_valve/owv_separate_membrane.stl](./3Dfiles/one_way_valve/) et 1 support pour la membrane [3Dfiles/one_way_valve/owv_separate_membrane_insert.stl](./3Dfiles/one_way_valve/)
- - _En option :_ 1 bouchon d'emballage trouvé dans [3Dfiles/accessories/imc_packaging_plug.stl](./3Dfiles/accessories/) qui peut être maintenu sur le tube du masque d'insuflation à l'aide d'un élastique, et peut protéger la graisse appliquée lors de l'expédition/du transport sans qu'un masque d'insuflation ne soit connecté.
+ - _En option :_ 1 bouchon d'emballage trouvé dans [3Dfiles/accessories/imc_packaging_plug.stl](./3Dfiles/accessories/) qui peut être maintenu sur le tube du masque d'insufflation à l'aide d'un élastique, et peut protéger la graisse appliquée lors de l'expédition/du transport sans qu'un masque d'insufflation ne soit connecté.
 
 Tout (_sauf la membrane séparée qui doit être imprimée en TPU, mais qui peut être remplacée par un insert de membrane_) est très résistant aux différents paramètres d'impression et matériaux. Nous suggérons le PETG, en particulier pour l'insert de membrane qui doit fléchir à chaque respiration.
 
@@ -94,7 +94,7 @@ En ce qui concerne les support ; nous suggérons d'en mettre :
  - à la base des support de sangles
  - _à titre facultatif_, pour soutenir les pas de vis de connexion des cartouches (_sans matériau de soutien, du ponçage peut être nécessaire_).
 
-Nous ne recommandons pas d'avoir de de support sous les deux tubes pour les cartouches, car il n'est _pas nécessaire et rend l'impression beaucoup plus longue_. Nous ne recommandons pas non plus d'avoir du matériel de soutien à l'intérieur du tube reliant le masque d'insuflation, car il n'est _pas nécessaire et difficile à enlever_.
+Nous ne recommandons pas d'avoir de de support sous les deux tubes pour les cartouches, car il n'est _pas nécessaire et rend l'impression beaucoup plus longue_. Nous ne recommandons pas non plus d'avoir du matériel de soutien à l'intérieur du tube reliant le masque d'insufflation, car il n'est _pas nécessaire et difficile à enlever_.
 
 ### 2.b - Fournitures : _Autres fournitures_
 

Readme.md

@@ -26,7 +26,7 @@ To know how to assemble/print this mask, see the [_section on mask assembly and
 
 ### Maintenance
 
-It is recommended to apply grease (_prefer food safe Vaseline_) around thread, around the insuflation mask connector and around the perimeter of the one way valve to improve the seal.
+It is recommended to apply grease (_prefer food safe Vaseline_) around thread, around the insufflation mask connector and around the perimeter of the one way valve to improve the seal.
 
 If you are using a 3D printed (_or DIY_) filter (_as described in [the section bellow](#1-b-filter-canister)_), change regularly the filter material - in general activated charcoal - and clean the enclosure if you don't change it.
 
@@ -34,7 +34,7 @@ In general do a fitment check before using the mask : put a piece of plastic (_o
 
 ### 1.a - Interfacing with the face
 
-The final design relies on an insuflation mask (_with a standard 22m inner diameter connector_) for good fitment to the face of the user. The advantage of this is that the fitment is good, there are multiple sizes to choose from, and insuflation mask are readily available (_they are suppose to be single use only, and are used at every anesthesia, CPR and in many other cases_) and **cheap** (_there are some available for around 2€ at [medisafe.fr](https://www.medisafe.fr/secours/oxygene/insufflateur-bavu/masque-insufflateur-usage-unique.html#MA285-2612-TAI1140_) for example_). 
+The final design relies on an insufflation mask (_with a standard 22m inner diameter connector_) for good fitment to the face of the user. The advantage of this is that the fitment is good, there are multiple sizes to choose from, and insufflation mask are readily available (_they are suppose to be single use only, and are used at every anesthesia, CPR and in many other cases_) and **cheap** (_there are some available for around 2€ at [medisafe.fr](https://www.medisafe.fr/secours/oxygene/insufflateur-bavu/masque-insufflateur-usage-unique.html#MA285-2612-TAI1140_) for example_). 
 
 The downside of this method are that firstly these mask tend to deteriorate over time and with use as they are meant to be single use item, however they are obviously swappable so they can be switched when unusable ; and secondly that the height of these mask and the length of the adapter puts the majority of the mask weight far from the face and thus a bit uncomfortable, especially under quick head movements.
 
@@ -84,29 +84,29 @@ Assembly of the mask is very simple, you will first need to print :
  - _Optionally :_ supplies for an input-one way valve : :warning: **_Will require modifying the adapter tube file parameters !_** :warning:
  	- 1 base for the one-way valve [3Dfiles/one_way_valve/owv_base_cap.stl](./3Dfiles/one_way_valve/)
  	- either 1 membrane insert for the one-way valve [3Dfiles/one_way_valve/owv_membrane_insert.stl](./3Dfiles/one_way_valve/), or 1 separate membrane (_printed out of TPU_) [3Dfiles/one_way_valve/owv_separate_membrane.stl](./3Dfiles/one_way_valve/) and 1 holder for the membrane [3Dfiles/one_way_valve/owv_separate_membrane_insert.stl](./3Dfiles/one_way_valve/)
- - _Optionally :_ 1 pakaging plug found at [3Dfiles/accessories/imc_packaging_plug.stl](./3Dfiles/accessories/) which can be held over the tube for the insuflation mask using a rubber band, and can protect applied grease while shipping/transporting witout an insuflation mask connected.
+ - _Optionally :_ 1 pakaging plug found at [3Dfiles/accessories/imc_packaging_plug.stl](./3Dfiles/accessories/) which can be held over the tube for the insufflation mask using a rubber band, and can protect applied grease while shipping/transporting witout an insufflation mask connected.
 
 Everything (_except the separate membrane which is to be printed out of TPU, but can be replaced by a membrane insert_) is very resilient to different print parameters and materials. We would suggest PETG, especially for the _membrane insert_ which has to flex at each breath.
 
 <img src="https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask/media/branch/main/pictures/gas_mask_supports.png?raw=true" alt="Image not available" height="300" />
 
-Print orientation are quite evident, although we would suggest printing the adapter tube with the flat "top" surface on the bed, and using minimal support to support the two threads meant to hold filters and to support the insuflation mask connector.
+Print orientation are quite evident, although we would suggest printing the adapter tube with the flat "top" surface on the bed, and using minimal support to support the two threads meant to hold filters and to support the insufflation mask connector.
 
 Regarding support material ; we suggest the following:
- - at the bottom of the tube connecting to the insuflation mask
+ - at the bottom of the tube connecting to the insufflation mask
  - at the bottom of the strap holders
  - _optionally_, supporting the threads ment for connecting the cartridges (_without support material, some sanding might be required_)
 
-We don't recommend having support material under the two tubes for the cartridges, as it is _not necessary and makes the print significantly longer_. We also don't recommend having support material inside the tube connecting to the insuflation mask, as it is _not necessary and hard to remove_.
+We don't recommend having support material under the two tubes for the cartridges, as it is _not necessary and makes the print significantly longer_. We also don't recommend having support material inside the tube connecting to the insufflation mask, as it is _not necessary and hard to remove_.
 
 ### 2.b - Supplies : _Other supplies_
 
 You will also need extra supplies :
- - 1 insuflation mask of the correct size
+ - 1 insufflation mask of the correct size
  - ~1m/3ft of elastic to hold the mask to your face
  - either 2 compatible filter canister or 1 filter canister and 1 plug
 
-### 2.c - Assembly : _Insuflation mask and elastic straps_
+### 2.c - Assembly : _insufflation mask and elastic straps_
 
 To assemble you can connect the insufltion mask to the adapter with the opening of the main tube of the adapter pointing toward the chin ; and tie two adjustable elastic loops (_simply tie the elastic to one side, loop it through the other side and tie a knot onto itself so it can slide lengthening/shortening the elastic loop length_) to the two pairs of tie-off points to hold the mask to your face.
 
@@ -114,7 +114,7 @@ To assemble you can connect the insufltion mask to the adapter with the opening
 
 <img src="https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask/media/branch/main/pictures/gas_mask_input_owv_step1.png?raw=true" alt="Image not available" height="250" />
 
-To assemble the output one-way valve you can first screw the base ([3Dfiles/one_way_valve/owv_base_cap.stl](./3Dfiles/one_way_valve/)) into the main tube of the adapter, with the smoother surface pointing down, until it is right under the tube that connect to the insuflation mask.
+To assemble the output one-way valve you can first screw the base ([3Dfiles/one_way_valve/owv_base_cap.stl](./3Dfiles/one_way_valve/)) into the main tube of the adapter, with the smoother surface pointing down, until it is right under the tube that connect to the insufflation mask.
 
 <img src="https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask/media/branch/main/pictures/gas_mask_input_owv_step2.png?raw=true" alt="Image not available" height="250" />
 
@@ -151,13 +151,13 @@ _**snap_fit_clearance** :_ \[_default=0.09mm_\] The clearance between two object
 
 ### 3.b - Geometrical parameters
 
-_**nt_horizontal_angle** and **nt_vertical_angle** :_ \[_default=20° and 30°_\] The former is the horizontal angle away from the two arms of the adapter tube being perfectly parallel, having such an angle is useful to bring the center of mass closer to your face. The latter is similarly the vertical angle of the arms of the adapter tube, which is used to lower the center of mass so the adapter tube doesn't want to rotate around the connector of the insuflation mask under the weight of the filter canister. 
+_**nt_horizontal_angle** and **nt_vertical_angle** :_ \[_default=20° and 30°_\] The former is the horizontal angle away from the two arms of the adapter tube being perfectly parallel, having such an angle is useful to bring the center of mass closer to your face. The latter is similarly the vertical angle of the arms of the adapter tube, which is used to lower the center of mass so the adapter tube doesn't want to rotate around the connector of the insufflation mask under the weight of the filter canister. 
 
-### 3.c - Insuflation mask parameters
+### 3.c - insufflation mask parameters
 
 The mask diameter is standard to 22mm (set yt _**imc_max_outer_diameter**_).
 
-_**imc_length** :_ \[_default=20mm_\] Length of the connector of the insuflation mask. Can be adapted to your specific mask.
+_**imc_length** :_ \[_default=20mm_\] Length of the connector of the insufflation mask. Can be adapted to your specific mask.
 
 ### 3.d - Strap holder parameters
 

manual/manuel-utilisateur.md

@@ -1,8 +1,49 @@
-# manuel utilisateur
+# _Masque à gaz paramétrique imprimé en 3D_
+
+# Manuel utilisateur
+
+**_Plus d'informations sont disponibles sur la page [https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask](https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask), et n'hésitez pas à nous contacter si besoin par mail à l'adresse [distorsion@systemli.org](mailto:distorsion@systemli.org). Nous sommes intéressés d'avoir des suggestions et des retours !_**
 
 ## 1 - Guide de démarrage rapide
 
-_À completer_
+### 1.a - Lorsque vous recevez votre masque
 
-## 2 - Maintenance du masque
+Lors de la réception du masque, il se peut qu'un élastique retienne un protecteur autour du tuyau de raccordement du masque d'insufflation, afin de maintenir la graisse appliquée autour de celui-ci. Vous pouvez retirer cet élastique et cette protection lorsque vous souhaitez raccorder un masque d'insufflation.
 
+S'il n'y a pas de sangle élastique attachée au masque, vous pouvez acheter n'importe quelle sangle élastique (environ ~10-15 mm de large) et l'attacher au support de sangle (une boucle reliant les deux supports de sangle supérieurs et une boucle entre les deux supports de sangle inférieurs).
+
+Vous pouvez ensuite connecter une cartouche et commencer à utiliser votre masque !
+
+### 1.b - Ce qu'il faut acheter
+
+#### _Masque d'insufflation_
+
+Vous pouvez acheter n'importe quel "masque d'insufflation" standard (que l'on trouve sur les sites de matériel médical), qui coûte environ 1 à 2 euros par masque.
+
+Comme il existe plusieurs tailles de masque d'insufflation pour adultes, vous pouvez tester et trouver la taille qui vous convient le mieux pour utiliser confortablement ce masque, tout en ayant une bonne étanchéité avec votre visae. Notez que la taille la plus grande est généralement très grande.
+
+#### _Cartouche de masque à gaz_
+
+Si vous n'avez pas reçu de cartouche avec votre masque, vous pouvez acheter une cartouche filtrante conçue pour les "masques à gaz de 40mm", parfois appelée "masque à gaz de 40mm _OTAN_".
+
+Un adaptateur peut avoir été fourni avec votre masque pour le raccorder à une autre norme de cartouche filtrante. Il s'agit généralement d'un adaptateur à "baïonnette" 3m, qui permet de monter des cartouches ou des filtres de marque 3m.
+
+En général, l'un des deux filetages permettant de monter une cartouche est bloqué par un bouchon. Si vous avez l'intention d'utiliser deux cartouches (ce qui facilitera la respiration), vous devrez l'enlever.
+
+## 2 - Entretien du masque
+
+### 2.a - Test
+
+Avant toute utilisation, veuillez effectuer un test de pression : _Mettez votre masque et bloquez l'entrée de la cartouche sans pousser le masque dans aucune direction. Si vous sentez que de l'air entre dans vos poumons, c'est que l'étanchéité n'est pas parfaite et qu'il faut changer la taille du masque d'insufflation ou appliquer de la graisse sur les filets ou le connecteur du masque d'insufflation._
+
+### 2.b - Graissage
+
+Vous devrez appliquer de la graisse autour des filetages utilisés pour monter les cartouches, autour des filetages de la valve (au bas du masque), autour de la surface d'étanchéité de la valve (la surface lisse de l'insert rond à quatre bras en bas du masque), et autour du connecteur du masque d'insufflation.
+
+Le graissage est essentiel pour conserver une connexion étanche à l'air avec les mavaise tolérances de l'impression 3D.
+
+### 2.c - Remplacement/remplissage de la cartouche
+
+Vous devrez changer les cartouches à l'usage, vérifiez les recommandations du fabricant et utilisez votre propre jugement.
+
+Si vous avez une cartouche imprimée en 3D, vous pouvez la dévisser et la remplir de charbon actif après avoir remplacé les bouts du masque COVID utilisées pour retenir le charbon actif. Vous pouvez consulter des instructions plus précises sur [https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-40mm-gas-mask-canister](https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-40mm-gas-mask-canister).

manual/user-manual.md

@@ -1,9 +1,47 @@
-# User manual
+# _3D Printed parametric gas-mask_ - User manual
+
+**_More information is available at [https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask](https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-gas-mask), and if ou need to don't hesitate to contact us by email at [distorsion@systemli.org](mailto:distorsion@systemli.org). We are interested in suggestions and feedback !_**
 
 ## 1 - Quick start guide
 
-_To do_
+### 1.a - When you receive your mask
+
+When receiving a mask, a rubber band may be holding a protector around the tube ment to connecting the insufflation mask, to keep grease applied around it. You can remove this rubber band and protection when you want to connect an insufflation mask.
+
+If there is no elastic strap attached to the mask, you can buy any elastic strap (around ~10-15mm wide) and tie it to the strap holder (a loop connecting the two top strap holder and a loop between the two bottom strap holder).
+
+You can then connect a canister and start using your mask !
+
+### 1.b - What to buy
+
+#### _Insufflation mask_
+
+You can buy any standard "insufflation mask" (which can be found on medical supplies sites), which cost around 1 to 2 euros per mask.
+
+Their exist multiples adult sizes of insufflation mask, you can test and find the best size for you to comfortably use this mask, while having a good fitment. Note that typically the largest size is very large.
+
+#### _Canister_
+
+If you didn't received a canister with your mask, you can buy a filtering canister made for "40mm gas masks", also sometimes called a "40mm _NATO_ gas mask".
+
+An adapter may have been included with your mask to connect to another standard of filtering canister. Typically this would be an adapter to 3m bayonet mount, which would allow you to mount 3m canisters or filters.
+
+Usually ne of the two threads ment to mount a canister will be blocked by a plug, if you intend on using two canister (which will make breathing easier), you will need to remove it.
 
 ## 2 - Maintenance of the mask
 
-_To do_
+### 2.a - Testing
+
+Before use, please do a pressure test : _Put on your mask and block the input of the canister without pushing the mask in any direction. If you feel any air entering your lungs, then the fit isn't perfect, and you may need to change the insufflation mask size or apply grease to threads or to the connector of the insufflation mask._
+
+### 2.b - Greasing
+
+You will need to apply grease around threads ment to mount canisters, and around the threads of the one-way-valve (at the bottom of the mask), around the sealing surface of the one-way-valve (the smooth surface of the round insert with four arms at the bottom of the mask), and around the connector ment for the insufflation mask.
+
+Greasing is essential to archiving an airtight connection with the loose tolerances of 3D printing.
+
+### 2.c - Replacing/refilling the canister
+
+You will need to change canisters with use, please check the recommandation of the manufacturer and use your own jugement.
+
+If you have a DIY 3D printed canister, you can unscrew them and refill with activated charcoal after replacing the pieces of COVID mask used to hold the activated charcoal. You can checkout more precise instruction at [https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-40mm-gas-mask-canister](https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-40mm-gas-mask-canister).