4 Commits
Author SHA1 Message Date
Admin-sn 90a291fb1c Correction 2S -> 1S pour ESP-12F 2026-11-03 08:22:00 +00:00
Admin-sn 1b19657e8c Ajout Polyswitch et Hall 2026-11-03 09:05:03 +01:00
Admin-sn 39c8099ab6 Merge branch 'main' of https://gitea.easylinux.fr/FinistRC/Brest_2027 2026-11-03 08:53:41 +01:00
Admin-sn 1e6e8bff19 Ajout ESP32 2026-11-03 08:52:12 +01:00
7 changed files with 123920 additions and 190 deletions

No files matched your search

File diff suppressed because it is too large. Load diff
+132
View File
@@ -0,0 +1,132 @@
{
"board": {
"active_layer": 0,
"active_layer_preset": "",
"auto_track_width": true,
"hidden_netclasses": [],
"hidden_nets": [],
"high_contrast_mode": 0,
"net_color_mode": 1,
"opacity": {
"images": 0.6,
"pads": 1.0,
"shapes": 1.0,
"tracks": 1.0,
"vias": 1.0,
"zones": 0.6
},
"selection_filter": {
"dimensions": true,
"footprints": true,
"graphics": true,
"keepouts": true,
"lockedItems": false,
"otherItems": true,
"pads": true,
"text": true,
"tracks": true,
"vias": true,
"zones": true
},
"visible_items": [
"vias",
"footprint_text",
"footprint_anchors",
"ratsnest",
"grid",
"footprints_front",
"footprints_back",
"footprint_values",
"footprint_references",
"tracks",
"drc_errors",
"drawing_sheet",
"bitmaps",
"pads",
"zones",
"drc_warnings",
"drc_exclusions",
"locked_item_shadows",
"conflict_shadows",
"shapes"
],
"visible_layers": "ffffffff_ffffffff_ffffffff_ffffffff",
"zone_display_mode": 0
},
"git": {
"integration_disabled": false,
"repo_type": "",
"repo_username": "",
"ssh_key": ""
},
"meta": {
"filename": "FinistRC.kicad_prl",
"version": 5
},
"net_inspector_panel": {
"col_hidden": [
false,
false,
false,
false,
false,
false,
false,
false,
false,
false
],
"col_order": [
0,
1,
2,
3,
4,
5,
6,
7,
8,
9
],
"col_widths": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"custom_group_rules": [],
"expanded_rows": [],
"filter_by_net_name": true,
"filter_by_netclass": true,
"filter_text": "",
"group_by_constraint": false,
"group_by_netclass": false,
"show_unconnected_nets": false,
"show_zero_pad_nets": false,
"sort_ascending": true,
"sorting_column": 0
},
"open_jobsets": [],
"project": {
"files": []
},
"schematic": {
"selection_filter": {
"graphics": true,
"images": true,
"labels": true,
"lockedItems": false,
"otherItems": true,
"pins": true,
"symbols": true,
"text": true,
"wires": true
}
}
}
+634
View File
@@ -0,0 +1,634 @@
{
"board": {
"3dviewports": [],
"design_settings": {
"defaults": {
"apply_defaults_to_fp_fields": false,
"apply_defaults_to_fp_shapes": false,
"apply_defaults_to_fp_text": false,
"board_outline_line_width": 0.05,
"copper_line_width": 0.2,
"copper_text_italic": false,
"copper_text_size_h": 1.5,
"copper_text_size_v": 1.5,
"copper_text_thickness": 0.3,
"copper_text_upright": false,
"courtyard_line_width": 0.05,
"dimension_precision": 4,
"dimension_units": 3,
"dimensions": {
"arrow_length": 1270000,
"extension_offset": 500000,
"keep_text_aligned": true,
"suppress_zeroes": true,
"text_position": 0,
"units_format": 0
},
"fab_line_width": 0.1,
"fab_text_italic": false,
"fab_text_size_h": 1.0,
"fab_text_size_v": 1.0,
"fab_text_thickness": 0.15,
"fab_text_upright": false,
"other_line_width": 0.1,
"other_text_italic": false,
"other_text_size_h": 1.0,
"other_text_size_v": 1.0,
"other_text_thickness": 0.15,
"other_text_upright": false,
"pads": {
"drill": 0.8,
"height": 1.27,
"width": 2.54
},
"silk_line_width": 0.1,
"silk_text_italic": false,
"silk_text_size_h": 1.0,
"silk_text_size_v": 1.0,
"silk_text_thickness": 0.1,
"silk_text_upright": false,
"zones": {
"min_clearance": 0.5
}
},
"diff_pair_dimensions": [
{
"gap": 0.0,
"via_gap": 0.0,
"width": 0.0
}
],
"drc_exclusions": [],
"meta": {
"version": 2
},
"rule_severities": {
"annular_width": "error",
"clearance": "error",
"connection_width": "warning",
"copper_edge_clearance": "error",
"copper_sliver": "warning",
"courtyards_overlap": "error",
"creepage": "error",
"diff_pair_gap_out_of_range": "error",
"diff_pair_uncoupled_length_too_long": "error",
"drill_out_of_range": "error",
"duplicate_footprints": "warning",
"extra_footprint": "warning",
"footprint": "error",
"footprint_filters_mismatch": "ignore",
"footprint_symbol_mismatch": "warning",
"footprint_type_mismatch": "ignore",
"hole_clearance": "error",
"hole_to_hole": "warning",
"holes_co_located": "warning",
"invalid_outline": "error",
"isolated_copper": "warning",
"item_on_disabled_layer": "error",
"items_not_allowed": "error",
"length_out_of_range": "error",
"lib_footprint_issues": "warning",
"lib_footprint_mismatch": "warning",
"malformed_courtyard": "error",
"microvia_drill_out_of_range": "error",
"mirrored_text_on_front_layer": "warning",
"missing_courtyard": "ignore",
"missing_footprint": "warning",
"net_conflict": "warning",
"nonmirrored_text_on_back_layer": "warning",
"npth_inside_courtyard": "ignore",
"padstack": "warning",
"pth_inside_courtyard": "ignore",
"shorting_items": "error",
"silk_edge_clearance": "warning",
"silk_over_copper": "warning",
"silk_overlap": "warning",
"skew_out_of_range": "error",
"solder_mask_bridge": "error",
"starved_thermal": "error",
"text_height": "warning",
"text_on_edge_cuts": "error",
"text_thickness": "warning",
"through_hole_pad_without_hole": "error",
"too_many_vias": "error",
"track_angle": "error",
"track_dangling": "warning",
"track_segment_length": "error",
"track_width": "error",
"tracks_crossing": "error",
"unconnected_items": "error",
"unresolved_variable": "error",
"via_dangling": "warning",
"zones_intersect": "error"
},
"rules": {
"max_error": 0.005,
"min_clearance": 0.0,
"min_connection": 0.0,
"min_copper_edge_clearance": 0.5,
"min_groove_width": 0.0,
"min_hole_clearance": 0.25,
"min_hole_to_hole": 0.25,
"min_microvia_diameter": 0.2,
"min_microvia_drill": 0.1,
"min_resolved_spokes": 2,
"min_silk_clearance": 0.0,
"min_text_height": 0.8,
"min_text_thickness": 0.08,
"min_through_hole_diameter": 0.3,
"min_track_width": 0.0,
"min_via_annular_width": 0.1,
"min_via_diameter": 0.5,
"solder_mask_to_copper_clearance": 0.005,
"use_height_for_length_calcs": true
},
"teardrop_options": [
{
"td_onpthpad": true,
"td_onroundshapesonly": false,
"td_onsmdpad": true,
"td_ontrackend": false,
"td_onvia": true
}
],
"teardrop_parameters": [
{
"td_allow_use_two_tracks": true,
"td_curve_segcount": 0,
"td_height_ratio": 1.0,
"td_length_ratio": 0.5,
"td_maxheight": 2.0,
"td_maxlen": 1.0,
"td_on_pad_in_zone": false,
"td_target_name": "td_round_shape",
"td_width_to_size_filter_ratio": 0.9
},
{
"td_allow_use_two_tracks": true,
"td_curve_segcount": 0,
"td_height_ratio": 1.0,
"td_length_ratio": 0.5,
"td_maxheight": 2.0,
"td_maxlen": 1.0,
"td_on_pad_in_zone": false,
"td_target_name": "td_rect_shape",
"td_width_to_size_filter_ratio": 0.9
},
{
"td_allow_use_two_tracks": true,
"td_curve_segcount": 0,
"td_height_ratio": 1.0,
"td_length_ratio": 0.5,
"td_maxheight": 2.0,
"td_maxlen": 1.0,
"td_on_pad_in_zone": false,
"td_target_name": "td_track_end",
"td_width_to_size_filter_ratio": 0.9
}
],
"track_widths": [
0.0,
0.4,
0.7
],
"tuning_pattern_settings": {
"diff_pair_defaults": {
"corner_radius_percentage": 80,
"corner_style": 1,
"max_amplitude": 1.0,
"min_amplitude": 0.2,
"single_sided": false,
"spacing": 1.0
},
"diff_pair_skew_defaults": {
"corner_radius_percentage": 80,
"corner_style": 1,
"max_amplitude": 1.0,
"min_amplitude": 0.2,
"single_sided": false,
"spacing": 0.6
},
"single_track_defaults": {
"corner_radius_percentage": 80,
"corner_style": 1,
"max_amplitude": 1.0,
"min_amplitude": 0.2,
"single_sided": false,
"spacing": 0.6
}
},
"via_dimensions": [
{
"diameter": 0.0,
"drill": 0.0
}
],
"zones_allow_external_fillets": false
},
"ipc2581": {
"dist": "",
"distpn": "",
"internal_id": "",
"mfg": "",
"mpn": ""
},
"layer_pairs": [],
"layer_presets": [],
"viewports": []
},
"boards": [],
"cvpcb": {
"equivalence_files": []
},
"erc": {
"erc_exclusions": [],
"meta": {
"version": 0
},
"pin_map": [
[
0,
0,
0,
0,
0,
0,
1,
0,
0,
0,
0,
2
],
[
0,
2,
0,
1,
0,
0,
1,
0,
2,
2,
2,
2
],
[
0,
0,
0,
0,
0,
0,
1,
0,
1,
0,
1,
2
],
[
0,
1,
0,
0,
0,
0,
1,
1,
2,
1,
1,
2
],
[
0,
0,
0,
0,
0,
0,
1,
0,
0,
0,
0,
2
],
[
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
2
],
[
1,
1,
1,
1,
1,
0,
1,
1,
1,
1,
1,
2
],
[
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
2
],
[
0,
2,
1,
2,
0,
0,
1,
0,
2,
2,
2,
2
],
[
0,
2,
0,
1,
0,
0,
1,
0,
2,
0,
0,
2
],
[
0,
2,
1,
1,
0,
0,
1,
0,
2,
0,
0,
2
],
[
2,
2,
2,
2,
2,
2,
2,
2,
2,
2,
2,
2
]
],
"rule_severities": {
"bus_definition_conflict": "error",
"bus_entry_needed": "error",
"bus_to_bus_conflict": "error",
"bus_to_net_conflict": "error",
"different_unit_footprint": "error",
"different_unit_net": "error",
"duplicate_reference": "error",
"duplicate_sheet_names": "error",
"endpoint_off_grid": "warning",
"extra_units": "error",
"footprint_filter": "ignore",
"footprint_link_issues": "warning",
"four_way_junction": "ignore",
"global_label_dangling": "warning",
"hier_label_mismatch": "error",
"label_dangling": "error",
"label_multiple_wires": "warning",
"lib_symbol_issues": "warning",
"lib_symbol_mismatch": "warning",
"missing_bidi_pin": "warning",
"missing_input_pin": "warning",
"missing_power_pin": "error",
"missing_unit": "warning",
"multiple_net_names": "warning",
"net_not_bus_member": "warning",
"no_connect_connected": "warning",
"no_connect_dangling": "warning",
"pin_not_connected": "error",
"pin_not_driven": "error",
"pin_to_pin": "warning",
"power_pin_not_driven": "error",
"same_local_global_label": "warning",
"similar_label_and_power": "warning",
"similar_labels": "warning",
"similar_power": "warning",
"simulation_model_issue": "ignore",
"single_global_label": "ignore",
"unannotated": "error",
"unconnected_wire_endpoint": "warning",
"undefined_netclass": "error",
"unit_value_mismatch": "error",
"unresolved_variable": "error",
"wire_dangling": "error"
}
},
"libraries": {
"pinned_footprint_libs": [],
"pinned_symbol_libs": []
},
"meta": {
"filename": "FinistRC.kicad_pro",
"version": 3
},
"net_settings": {
"classes": [
{
"bus_width": 12,
"clearance": 0.2,
"diff_pair_gap": 0.25,
"diff_pair_via_gap": 0.25,
"diff_pair_width": 0.2,
"line_style": 0,
"microvia_diameter": 0.3,
"microvia_drill": 0.1,
"name": "Default",
"pcb_color": "rgba(0, 0, 0, 0.000)",
"priority": 2147483647,
"schematic_color": "rgba(0, 0, 0, 0.000)",
"track_width": 0.2,
"via_diameter": 0.6,
"via_drill": 0.3,
"wire_width": 6
}
],
"meta": {
"version": 4
},
"net_colors": null,
"netclass_assignments": null,
"netclass_patterns": []
},
"pcbnew": {
"last_paths": {
"gencad": "",
"idf": "",
"netlist": "",
"plot": "",
"pos_files": "",
"specctra_dsn": "",
"step": "",
"svg": "",
"vrml": ""
},
"page_layout_descr_file": ""
},
"schematic": {
"annotate_start_num": 0,
"bom_export_filename": "${PROJECTNAME}.csv",
"bom_fmt_presets": [],
"bom_fmt_settings": {
"field_delimiter": ",",
"keep_line_breaks": false,
"keep_tabs": false,
"name": "CSV",
"ref_delimiter": ",",
"ref_range_delimiter": "",
"string_delimiter": "\""
},
"bom_presets": [],
"bom_settings": {
"exclude_dnp": false,
"fields_ordered": [
{
"group_by": false,
"label": "Reference",
"name": "Reference",
"show": true
},
{
"group_by": false,
"label": "Qty",
"name": "${QUANTITY}",
"show": true
},
{
"group_by": true,
"label": "Value",
"name": "Value",
"show": true
},
{
"group_by": true,
"label": "DNP",
"name": "${DNP}",
"show": true
},
{
"group_by": true,
"label": "Exclude from BOM",
"name": "${EXCLUDE_FROM_BOM}",
"show": true
},
{
"group_by": true,
"label": "Exclude from Board",
"name": "${EXCLUDE_FROM_BOARD}",
"show": true
},
{
"group_by": true,
"label": "Footprint",
"name": "Footprint",
"show": true
},
{
"group_by": false,
"label": "Datasheet",
"name": "Datasheet",
"show": true
}
],
"filter_string": "",
"group_symbols": true,
"include_excluded_from_bom": true,
"name": "Default Editing",
"sort_asc": true,
"sort_field": "Référence"
},
"connection_grid_size": 50.0,
"drawing": {
"dashed_lines_dash_length_ratio": 12.0,
"dashed_lines_gap_length_ratio": 3.0,
"default_line_thickness": 6.0,
"default_text_size": 50.0,
"field_names": [],
"intersheets_ref_own_page": false,
"intersheets_ref_prefix": "",
"intersheets_ref_short": false,
"intersheets_ref_show": false,
"intersheets_ref_suffix": "",
"junction_size_choice": 3,
"label_size_ratio": 0.375,
"operating_point_overlay_i_precision": 3,
"operating_point_overlay_i_range": "~A",
"operating_point_overlay_v_precision": 3,
"operating_point_overlay_v_range": "~V",
"overbar_offset_ratio": 1.23,
"pin_symbol_size": 25.0,
"text_offset_ratio": 0.15
},
"legacy_lib_dir": "",
"legacy_lib_list": [],
"meta": {
"version": 1
},
"net_format_name": "",
"page_layout_descr_file": "",
"plot_directory": "",
"space_save_all_events": true,
"spice_current_sheet_as_root": false,
"spice_external_command": "spice \"%I\"",
"spice_model_current_sheet_as_root": true,
"spice_save_all_currents": false,
"spice_save_all_dissipations": false,
"spice_save_all_voltages": false,
"subpart_first_id": 65,
"subpart_id_separator": 0
},
"sheets": [
[
"ec234cc5-9cd3-451f-aa8e-cf12edcc7448",
"Root"
]
],
"text_variables": {}
}
File diff suppressed because it is too large. Load diff
@@ -0,0 +1 @@
{"ARCHIVE_NAME": "", "EXTRA_LAYERS": "", "ALL_ACTIVE_LAYERS": false, "EXTEND_EDGE_CUT": false, "ALTERNATIVE_EDGE_CUT": false, "AUTO TRANSLATE": true, "AUTO FILL": true, "EXCLUDE DNP": false, "OPEN BROWSER": true, "BACKUP_OPT": true}
File diff suppressed because it is too large. Load diff
+200 -190
View File
@@ -1,191 +1,201 @@
# Journées maritimes de Brest 2027 # Journées maritimes de Brest 2027
Projet de bateaux télécommandés pour le bassin des Journées maritimes. Le matériel repose sur des ESP8266 et deux modes réseau : Projet de bateaux télécommandés pour le bassin des Journées maritimes. Le matériel repose sur des ESP8266/ESP32 et deux modes réseau :
- **MQTT** : un point d'accès OpenWRT fournit le Wi-Fi et le broker MQTT. Un système de supervision Banana Pi suit les périphériques et les batteries. - **MQTT** : un point d'accès OpenWRT fournit le Wi-Fi et le broker MQTT. Un système de supervision Banana Pi suit les périphériques et les batteries.
- **AP autonome** : le bateau crée son propre réseau Wi-Fi et fonctionne sans broker ni supervision. - **AP autonome** : le bateau crée son propre réseau Wi-Fi et fonctionne sans broker ni supervision.
> **NB** les bateaux en mode autonome sont une option supplémentaires au mode Wifi > **NB** les bateaux en mode autonome sont une option supplémentaires au mode Wifi
## Structure PlatformIO ## Structure PlatformIO
Le dépôt contient un seul projet PlatformIO avec quatre environnements : Le dépôt contient un seul projet PlatformIO avec quatre environnements :
| Environnement | Matériel | Réseau | | Environnement | Matériel | Réseau |
| ------------- | ---------------------------- | --------------------- | | ------------- | ---------------------------- | --------------------- |
| `boat_mqtt` | bateau + MX1508 + servo | MQTT | | `boat_mqtt` | bateau + MX1508 + servo | MQTT |
| `remote_mqtt` | télécommande + capteurs Hall | MQTT | | `remote_mqtt` | télécommande + capteurs Hall | MQTT |
| `boat_ap` | bateau + MX1508 + servo | point d'accès ESP8266 | | `boat_ap` | bateau + MX1508 + servo | point d'accès ESP8266 |
| `remote_ap` | télécommande + capteurs Hall | point d'accès ESP8266 | | `remote_ap` | télécommande + capteurs Hall | point d'accès ESP8266 |
> **NB** : Les dispositifs 'autonomes' ne crée leur AP que lorsqu'il > **NB** : Les dispositifs 'autonomes' ne crée leur AP que lorsqu'il
> n'y a pas de Wifi, dans ce cas le bateau crée l'accès Wifi. > n'y a pas de Wifi, dans ce cas le bateau crée l'accès Wifi.
**Mode de fonctionnement** **Mode de fonctionnement**
1. Bateaux 'AP' 1. Bateaux 'AP'
- pas de configuration -> présente le portail captif - pas de configuration -> présente le portail captif
- configuré et wifi présent -> se connecte au Wifi - configuré et wifi présent -> se connecte au Wifi
- configuré et wifi non présent -> se comporte en AP - configuré et wifi non présent -> se comporte en AP
- configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi - configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi
2. Bateaux 'MQTT' 2. Bateaux 'MQTT'
- pas de configuration -> présente le portail captif - pas de configuration -> présente le portail captif
- configuré et wifi présent -> se connecte au Wifi - configuré et wifi présent -> se connecte au Wifi
- configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi - configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi
3. Remote 'AP' 3. Remote 'AP'
- pas de configuration -> présente le portail captif - pas de configuration -> présente le portail captif
- configuré et wifi présent -> se connecte au Wifi - configuré et wifi présent -> se connecte au Wifi
- configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi - configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi
4. Remote 'MQTT' 4. Remote 'MQTT'
- pas de configuration -> présente le portail captif - pas de configuration -> présente le portail captif
- configuré et wifi présent -> se connecte au Wifi - configuré et wifi présent -> se connecte au Wifi
- configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi - configuré et PIN_CONFIG a l'état BAS -> reset de la configuration Wifi
# Compilation avec Platformio # Compilation avec Platformio
Commandes de départ : Commandes de départ :
```text ```text
pio run -e boat_mqtt pio run -e boat_mqtt
pio run -e remote_mqtt pio run -e remote_mqtt
pio run -e boat_ap pio run -e boat_ap
pio run -e remote_ap pio run -e remote_ap
pio device monitor -b 115200 pio device monitor -b 115200
``` ```
Le firmware initial est volontairement passif : il initialise les entrées/sorties et affiche son rôle sur le port série, mais n'active pas les moteurs. Les broches sont centralisées dans `include/pins.h`. Le firmware initial est volontairement passif : il initialise les entrées/sorties et affiche son rôle sur le port série, mais n'active pas les moteurs. Les broches sont centralisées dans `include/pins.h`.
# Hardware # Hardware
Le but est de réaliser une platine unique reprenant tous les composants : ## ESP8266
| Composant | Fonction | Le but est de réaliser une platine unique reprenant tous les composants, cette platine est destinée aux petits modèles en remplacement des modules MTM (Make Them Move).
| --------------- | ------------------------- | Il est alimenté en 1S
| ESP12F | Micro-Controleur |
| APK2112-3.3 | Régulateur 3.3V | | Composant | Fonction |
| MX1508 | Double pont en H | | --------------- | ------------------------- |
| ADS115 | Convertisseur ADC | | ESP12F | Micro-Controleur |
| Hall | Capteurs a Effet Hall (2) | | APK2112-3.3 | Régulateur 3.3V |
| WS2812 | Led status | | MX1508 | Double pont en H |
| TP4056 (1S) | Chargeur Li-ion 1S | | WS2812 | Led status |
| Chargeur/BMS 2S | Chargeur Li-ion 2S |
> **NB** Faut-il prévoir un circuit de charge
### Variantes d'assemblage
## ESP32
Une seule carte peut être utilisée pour les différentes versions en prévoyant
les composants optionnels sur le PCB. La BOM et le plan de placement doivent Platine unique reprenant tous les composants, platine pour les émetteurs, et aux bateaux FinistRC, alimentation 2S
indiquer `DNP` (composant non monté) pour chaque variante :
| Composant | Fonction |
| Variante | Composants à monter | Composants à laisser DNP | | --------------- | ------------------------- |
| ------------ | -------------------------------------------------- | ------------------------ | | ESP32WROOM | Micro-Controleur |
| Bateau | ESP12F, MX1508, servo, WS2812 | ADS115 et capteurs Hall | | APK2112-3.3 | Régulateur 3.3V |
| Télécommande | ESP12F, ADS115 et capteurs Hall, WS2812 | MX1508 et servo | | 1117-5v | Régulateur 5V |
| Accu 1S | TP4056, régulateur compatible 4,2 V | Chargeur/BMS 2S | | MX1508 | Double pont en H |
| Accu 2S | Chargeur/BMS 2S, régulateur 3,3 V compatible 8,4 V | TP4056 | | Hall | Capteurs a Effet Hall (2) |
| WS2812 | Led status |
Les deux circuits de charge ne doivent jamais être montés ni raccordés en
parallèle. Prévoir un connecteur batterie commun, un connecteur de charge > **TODO** :
adapté à la variante et des straps ou ponts de soudure clairement repérés si > - Ajouter Polyswitch sur moteurs
la sélection ne se fait pas uniquement par la BOM. > - Ajouter prises capteurs à effet Hall
### Variantes d'assemblage
### Alimentation
Une seule carte peut être utilisée pour les différentes versions en prévoyant
- Ne jamais alimenter les moteurs depuis le régulateur 3,3 V de l'ESP8266. les composants optionnels sur le PCB. La BOM et le plan de placement doivent
- Relier toutes les masses : batterie, MX1508, régulateur et ESP8266. indiquer `DNP` (composant non monté) pour chaque variante :
- Ajouter un condensateur de découplage près de l'ESP8266 et du MX1508 ; les moteurs peuvent provoquer des resets Wi-Fi.
- Vérifier au multimètre la tension réellement appliquée à l'ESP8266 avant insertion de la batterie. | Variante | Composants à monter | Composants à laisser DNP |
- Le TP4056 est réservé à un accu Li-ion 1S (4,2 V maximum). Pour un accu 2S (8,4 V maximum), utiliser un chargeur et un BMS prévus pour 2S ; ne jamais brancher un TP4056 directement sur un pack 2S. | ------------ | -------------------------------------------------- | ------------------------ |
- Pour la version 2S, ne pas appliquer directement les 8,4 V au régulateur 3,3 V : vérifier sa tension d'entrée maximale et prévoir un convertisseur abaisseur si nécessaire. | Bateau | ESP12F, MX1508, servo, WS2812 | nc |
- Le pont diviseur de mesure batterie doit ramener la tension maximale sous la limite de l'entrée A0 de la carte utilisée. Cette limite varie selon le module ESP8266 : vérifier sa fiche technique. | Télécommande | ESP32, capteurs Hall, WS2812 | MX1508 et servo |
- Pour une batterie 2S, dimensionner le diviseur sur 8,4 V (batterie pleine), pas sur sa tension nominale.
### Broches ESP8266
## Broches ESP8266
Le choix proposé dans `include/pins.h` est :
Le choix proposé dans `include/pins.h` est :
| Fonction | Broche NodeMCU | GPIO |
| --------------------------- | -------------- | --------------- | | Fonction | Broche NodeMCU | GPIO |
| Batterie | A0 | ADC0 | | --------------------------- | -------------- | --------------- |
| I2C SDA | D2 | GPIO4 | | Batterie | A0 | ADC0 |
| I2C SCL | D1 | GPIO5 | | I2C SDA | D2 | GPIO4 |
| Moteur gauche avant/arrière | D5 / D6 | GPIO14 / GPIO12 | | I2C SCL | D1 | GPIO5 |
| Moteur droit avant/arrière | D7 / D8 | GPIO13 / GPIO15 | | Moteur gauche avant/arrière | D5 / D6 | GPIO14 / GPIO12 |
| Servo gouvernail | D4 | GPIO2 | | Moteur droit avant/arrière | D7 / D8 | GPIO13 / GPIO15 |
| Servo gouvernail | D4 | GPIO2 |
Conseils importants :
Conseils importants :
- GPIO0, GPIO2 et GPIO15 participent au démarrage de l'ESP8266. Le MX1508 et le servo ne doivent pas imposer un mauvais niveau logique pendant le boot ; tester le démarrage avec le moteur déconnecté, puis vérifier les niveaux avec un oscilloscope ou un analyseur logique.
- D8/GPIO15 est utilisé ici pour disposer de quatre sorties moteur, mais il doit être validé sur le montage final. Prévoir une résistance ou un buffer si le MX1508 perturbe le niveau de boot. - GPIO0, GPIO2 et GPIO15 participent au démarrage de l'ESP8266. Le MX1508 et le servo ne doivent pas imposer un mauvais niveau logique pendant le boot ; tester le démarrage avec le moteur déconnecté, puis vérifier les niveaux avec un oscilloscope ou un analyseur logique.
- L'ESP8266 ne possède qu'une seule entrée analogique. Deux capteurs Hall analogiques ne peuvent donc pas être raccordés directement : utiliser un ADC externe I2C (ADS115). - D8/GPIO15 est utilisé ici pour disposer de quatre sorties moteur, mais il doit être validé sur le montage final. Prévoir une résistance ou un buffer si le MX1508 perturbe le niveau de boot.
- Si les capteurs Hall sont des capteurs numériques à seuil, les raccorder à des GPIO distincts et adapter `pins.h` et le filtrage logiciel. - L'ESP8266 ne possède qu'une seule entrée analogique. Deux capteurs Hall analogiques ne peuvent donc pas être raccordés directement : utiliser un ADC externe I2C (ADS115).
- Le servo doit avoir une alimentation adaptée et une masse commune ; ne pas supposer que le 3,3 V de l'ESP8266 suffit à fournir son courant de pointe. - Si les capteurs Hall sont des capteurs numériques à seuil, les raccorder à des GPIO distincts et adapter `pins.h` et le filtrage logiciel.
- Le servo doit avoir une alimentation adaptée et une masse commune ; ne pas supposer que le 3,3 V de l'ESP8266 suffit à fournir son courant de pointe.
### Sécurité de fonctionnement
## Broches ESP32
- Prévoir un état d'arrêt au démarrage, à la perte Wi-Fi, à la perte MQTT et après expiration d'un watchdog de commande.
- Le dernier ordre reçu ne doit jamais rester actif indéfiniment : chaque commande doit porter une durée de validité courte. **TODO** A mettre à jour
- Ajouter une commande d'arrêt locale sur chaque pupitre et tester le comportement avec le broker indisponible. Le choix proposé dans `include/pins.h` est :
- Ne tester les moteurs qu'avec l'hélice retirée, puis dans un bassin sécurisé.
| Fonction | Broche NodeMCU | GPIO |
| --------------------------- | -------------- | --------------- |
## Prochaines étapes
### Sécurité de fonctionnement
1. Mesurer et documenter les tensions batterie et les rapports des diviseurs.
2. Valider le démarrage avec le câblage MX1508 et la table de broches. - Prévoir un état d'arrêt au démarrage, à la perte Wi-Fi, à la perte MQTT et après expiration d'un watchdog de commande.
3. Ajouter la lecture calibrée des capteurs Hall et de la batterie. - Le dernier ordre reçu ne doit jamais rester actif indéfiniment : chaque commande doit porter une durée de validité courte.
4. Définir le payload et les topics MQTT, par exemple `bateau/00001/cmd` et `bateau/00001/status`. - Ajouter une commande d'arrêt locale sur chaque pupitre et tester le comportement avec le broker indisponible.
5. Implémenter le failsafe, puis le pilotage moteur/servo. - Ne tester les moteurs qu'avec l'hélice retirée, puis dans un bassin sécurisé.
6. Ajouter la page de configuration Wi-Fi, l'identifiant du bateau et les paramètres de calibration.
# Annexe
## Prochaines étapes
La commande wifiManager.autoConnect("FinistRC_Config") provient de la très populaire bibliothèque WiFiManager (développée à l'origine par tzapu) pour les microcontrôleurs ESP8266 et ESP32 (souvent utilisés en C++ sous l'IDE Arduino).
1. Mesurer et documenter les tensions batterie et les rapports des diviseurs.
Cette fonction est conçue pour gérer automatiquement la connexion Wi-Fi de votre carte sans avoir à inscrire le nom du réseau (SSID) et le mot de passe en dur dans le code. 2. Valider le démarrage avec le câblage MX1508 et la table de broches.
3. Ajouter la lecture calibrée des capteurs Hall et de la batterie.
Voici en détail le déroulement de son fonctionnement étape par étape : 4. Définir le payload et les topics MQTT, par exemple `bateau/00001/cmd` et `bateau/00001/status`.
1. Tentative de connexion silencieuse (Mode Station / STA) 5. Implémenter le failsafe, puis le pilotage moteur/servo.
6. Ajouter la page de configuration Wi-Fi, l'identifiant du bateau et les paramètres de calibration.
Lorsque la carte démarre et qu'elle exécute cette ligne :
# Annexe
Le microcontrôleur va d'abord chercher s'il a déjà des identifiants Wi-Fi enregistrés dans sa mémoire non-volatile (EEPROM / Flash).
La commande wifiManager.autoConnect("FinistRC_Config") provient de la très populaire bibliothèque WiFiManager (développée à l'origine par tzapu) pour les microcontrôleurs ESP8266 et ESP32 (souvent utilisés en C++ sous l'IDE Arduino).
S'il trouve un réseau enregistré : Il tente de s'y connecter en tant que client Wi-Fi standard.
Cette fonction est conçue pour gérer automatiquement la connexion Wi-Fi de votre carte sans avoir à inscrire le nom du réseau (SSID) et le mot de passe en dur dans le code.
Si la connexion réussit : La fonction autoConnect() renvoie true, le programme sort immédiatement de la fonction et continue la suite du code (votre boucle setup() se termine, puis loop() prend le relais).
Voici en détail le déroulement de son fonctionnement étape par étape :
2. Basculement en Point d'Accès (Mode AP) si la connexion échoue 1. Tentative de connexion silencieuse (Mode Station / STA)
Si aucune information Wi-Fi n'est enregistrée, ou si le réseau enregistré est hors de portée / inaccessible (ex: box éteinte ou changement de mot de passe) : Lorsque la carte démarre et qu'elle exécute cette ligne :
La commande bloque le reste du programme (elle ne passe pas aux lignes de code suivantes tant que le réseau n'est pas configuré). Le microcontrôleur va d'abord chercher s'il a déjà des identifiants Wi-Fi enregistrés dans sa mémoire non-volatile (EEPROM / Flash).
L'ESP bascule en mode Point d'Accès (Access Point). S'il trouve un réseau enregistré : Il tente de s'y connecter en tant que client Wi-Fi standard.
Il génère son propre réseau Wi-Fi avec le nom transmis en paramètre : FinistRC_Config. Si la connexion réussit : La fonction autoConnect() renvoie true, le programme sort immédiatement de la fonction et continue la suite du code (votre boucle setup() se termine, puis loop() prend le relais).
3. Portail Captif (Captive Portal) 2. Basculement en Point d'Accès (Mode AP) si la connexion échoue
Vous prenez votre téléphone ou votre ordinateur et vous vous connectez au réseau Wi-Fi FinistRC_Config. Si aucune information Wi-Fi n'est enregistrée, ou si le réseau enregistré est hors de portée / inaccessible (ex: box éteinte ou changement de mot de passe) :
Grâce au mécanisme de Portail Captif, votre appareil détectera automatiquement qu'il n'y a pas d'Internet et ouvrira spontanément une page web (ou vous invitera à "Vous connecter au réseau"). La commande bloque le reste du programme (elle ne passe pas aux lignes de code suivantes tant que le réseau n'est pas configuré).
Si la page ne s'ouvre pas seule, il suffit d'ouvrir un navigateur web et d'aller à l'adresse 192.168.4.1. L'ESP bascule en mode Point d'Accès (Access Point).
4. Configuration et enregistrement Il génère son propre réseau Wi-Fi avec le nom transmis en paramètre : FinistRC_Config.
Sur cette interface web d'accueil : 3. Portail Captif (Captive Portal)
L'utilisateur clique sur "Configure WiFi". Vous prenez votre téléphone ou votre ordinateur et vous vous connectez au réseau Wi-Fi FinistRC_Config.
L'ESP scanne les réseaux Wi-Fi environnants et affiche la liste. Grâce au mécanisme de Portail Captif, votre appareil détectera automatiquement qu'il n'y a pas d'Internet et ouvrira spontanément une page web (ou vous invitera à "Vous connecter au réseau").
L'utilisateur sélectionne sa box Wi-Fi, saisit le mot de passe et valide. Si la page ne s'ouvre pas seule, il suffit d'ouvrir un navigateur web et d'aller à l'adresse 192.168.4.1.
L'ESP sauvegarde les identifiants dans sa mémoire flash, ferme son réseau temporaire FinistRC_Config et redémarre son module Wi-Fi pour se connecter à la box. 4. Configuration et enregistrement
Sur cette interface web d'accueil :
L'utilisateur clique sur "Configure WiFi".
L'ESP scanne les réseaux Wi-Fi environnants et affiche la liste.
L'utilisateur sélectionne sa box Wi-Fi, saisit le mot de passe et valide.
L'ESP sauvegarde les identifiants dans sa mémoire flash, ferme son réseau temporaire FinistRC_Config et redémarre son module Wi-Fi pour se connecter à la box.
Une fois connecté, la fonction autoConnect() se débloque et votre programme principal s'exécute normalement. Une fois connecté, la fonction autoConnect() se débloque et votre programme principal s'exécute normalement.