CANConfigPython 0.1.0a1__py3-none-win32.whl

canconfigpython/resources/skill/canconfig-python/assets/examples/bridge_dual_rates.json

@@ -0,0 +1,18 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_PARAMETER/BRT": [
+      500000,
+      1,
+      13,
+      2
+    ],
+    "CAN2_PARAMETER/BRT": [
+      250000,
+      1,
+      13,
+      2
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/bridge_mapping.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_MAPPING/M1": [
+      1,
+      0,
+      291,
+      0,
+      801
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/cancom_115200_8n1.json

@@ -0,0 +1,10 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CANCOM/BAUD_RATE": 115200,
+    "CANCOM/DATA_LEN": 8,
+    "CANCOM/PARITY": 0,
+    "CANCOM/STOP_LEN": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/cancom_format_crc.json

@@ -0,0 +1,8 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CANCOM/MODE": 2,
+    "CANCOM/FORMAT_MODE_CRC": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/cancom_gap.json

@@ -0,0 +1,8 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CANCOM/STREAM_GAP_TIME": 10,
+    "CANCOM/MSG_GAP_TIME": 20
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/cancom_transparent_id.json

@@ -0,0 +1,10 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CANCOM/MODE": 0,
+    "CANCOM/DIRECTION": 0,
+    "CANCOM/CAN_PROTOCOL": 0,
+    "CANCOM/CAN_ID": 291
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/fb_1m.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_PARAMETER/BRT": [
+      1000000,
+      2,
+      14,
+      4
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/fb_500k.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_PARAMETER/BRT": [
+      500000,
+      2,
+      15,
+      3
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/fb_adaptive_single.json

@@ -0,0 +1,7 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_PARAMETER/BRT_AUTO": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/fb_return_manual.json

@@ -0,0 +1,22 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_PARAMETER/MODE": 0,
+    "CAN1_PARAMETER/BRT_AUTO": 0,
+    "CAN1_PARAMETER/BRT": [
+      500000,
+      2,
+      15,
+      3
+    ],
+    "CAN2_PARAMETER/MODE": 0,
+    "CAN2_PARAMETER/BRT_AUTO": 0,
+    "CAN2_PARAMETER/BRT": [
+      250000,
+      2,
+      15,
+      3
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/fb_silent_adaptive_option.json

@@ -0,0 +1,7 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "ADVANCED_OPTION/SILENT_AUTO_BTR_EN": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/filter_blacklist.json

@@ -0,0 +1,7 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "FILTER_MODE/BLACK_LIST": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/filter_mask.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_FILTER/F1": [
+      1,
+      0,
+      291,
+      3758096383
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/filter_range.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN1_FILTER/F1": [
+      1,
+      1,
+      256,
+      511
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/hub_h_external.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN3_PARAMETER/BRT": [
+      500000,
+      1,
+      5,
+      3,
+      6
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/hub_input_filter.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN_IN_FILTER/F1": [
+      3,
+      0,
+      291,
+      3758096383
+    ],
+    "ADVANCED_OPTION/IN_FILITER_EN": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/hub_l_external.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN3_PARAMETER/BRT": [
+      500000,
+      1,
+      2,
+      1,
+      1
+    ]
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/hub_mapping.json

@@ -0,0 +1,46 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "CAN_MAPPING/M1": [
+      1,
+      291,
+      801,
+      3758096383,
+      255,
+      255,
+      2
+    ],
+    "CAN_MAPPING/MS1": [
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0
+    ],
+    "CAN_MAPPING/MT1": [
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0
+    ],
+    "CAN_MAPPING/MM1": [
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0
+    ],
+    "ADVANCED_OPTION/MAPPING_EN": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/hub_routing.json

@@ -0,0 +1,8 @@
+{
+  "schema_version": 1,
+  "device_uid": "0000-0000-0000-0000-0000-0000",
+  "changes": {
+    "ROUTING_TABLE/CAN1": 6,
+    "ADVANCED_OPTION/ROUTER_EN": 1
+  }
+}

canconfigpython/resources/skill/canconfig-python/assets/examples/index.en.md

@@ -0,0 +1,55 @@
+# Configuration examples (CANConfigConsole 2.3)
+
+[简体中文](index.zh-CN.md) · [Command and parameter reference](../../references/operations.md)
+
+Every example is a complete request containing schema_version, device_uid and changes. The all-zero UID is a placeholder; replace it with the actual UID of a confirmed target. Copy the file to a working directory, edit the intended fields, save UTF-8, then run apply --dry-run. Execute the same file only after the previewed scope is understood and authorized. Do not modify installed templates.
+
+These are isolated fake-driver acceptance inputs. Passing them does not prove physical timing, bus communication or power-cycle persistence. Partial patches can inherit and write an entire section, so write_count may exceed the changed-field count. Counts and SAVE domains below are expected for the index.json fixture profiles; use the current device's actual preflight result for a real operation.
+
+Types: 13=CANBridge/B_CC_A, 24=CANCOM, 26=CANFB-2F2C, 30=CANRPT-600, 35=CANHub-X6H, 36=CANHub-X6L. Different versions/channel counts require capability checks; do not copy timing, channel lists or expected counts blindly.
+
+## Positive examples (22)
+
+| File / purpose | Prerequisite | Configuration writes / SAVE domains |
+| --- | --- | --- |
+| [CANFB CAN1: fixed 500 kbit/s](fb_500k.json) | All channels manual and fully readable; no DIP override. | 2 / SAVE/1/1 |
+| [CANFB CAN1: fixed 1 Mbit/s](fb_1m.json) | All channels manual and fully readable; no DIP override. | 2 / SAVE/1/1 |
+| [CANBridge: different rates on two channels](bridge_dual_rates.json) | All channels manual and fully readable; no DIP override. | 2 / SAVE/1/0 |
+| [CANRPT-600: CAN3 silent mode](rpt_silent.json) | All channels manual and fully readable; no DIP override. | 6 / SAVE/1/0 |
+| [CANHub-X6H: external CAN3 at 500 kbit/s](hub_h_external.json) | All channels manual and fully readable; no DIP override. | 6 / SAVE/1/1 |
+| [CANHub-X6L: external CAN3 at 500 kbit/s](hub_l_external.json) | All channels manual and fully readable; no DIP override. | 6 / SAVE/1/1 |
+| [CANFB: enable adaptive mode on CAN1](fb_adaptive_single.json) | All channels manual and fully readable; no DIP override. | 1 / SAVE/1/1 |
+| [CANRPT-600: enable adaptive mode on all six channels](rpt_adaptive_all.json) | All channels manual and fully readable; no DIP override. | 6 / SAVE/1/0 |
+| [CANFB: return both channels to explicit manual settings](fb_return_manual.json) | Adaptive state is allowed; explicitly authorize overwriting both channels with new manual values; no DIP override. | 2 / SAVE/1/1 |
+| [CANBridge CAN1: mask filter for ID 0x123](filter_mask.json) | All channels manual and fully readable; no DIP override. | 32 / SAVE/1/0 |
+| [CANBridge CAN1: range filter 0x100-0x1FF](filter_range.json) | All channels manual and fully readable; no DIP override. | 32 / SAVE/1/0 |
+| [CANBridge: select blacklist mode](filter_blacklist.json) | All channels manual and fully readable; no DIP override. | 1 / SAVE/1/0 |
+| [CANHub: enable an input filter on two channels](hub_input_filter.json) | All channels manual and fully readable; no DIP override. | 257 / SAVE/1/2, SAVE/1/5 |
+| [CANBridge: map standard ID 0x123 to 0x321](bridge_mapping.json) | All channels manual and fully readable; no DIP override. | 128 / SAVE/5 |
+| [CANHub: map and forward to CAN2](hub_mapping.json) | Hub firmware 01.16 or later (mapping_format=3); all channels manual and fully readable. | 257 / SAVE/1/3, SAVE/1/5 |
+| [CANHub: route CAN1 to CAN2 and CAN3](hub_routing.json) | All channels manual and fully readable; no DIP override. | 2 / SAVE/1/4, SAVE/1/5 |
+| [CANFB: silent adaptive option](fb_silent_adaptive_option.json) | CANFB 05.09/05.10 supports this bit; setting it does not enable BRT_AUTO. | 1 / SAVE/1/5 |
+| [CANCOM: serial 115200 8N1](cancom_115200_8n1.json) | All channels manual and fully readable; no DIP override. | 1 / SAVE/4 |
+| [CANCOM: bidirectional transparent conversion and standard ID](cancom_transparent_id.json) | All channels manual and fully readable; no DIP override. | 1 / SAVE/4 |
+| [CANCOM: format conversion with CRC](cancom_format_crc.json) | All channels manual and fully readable; no DIP override. | 1 / SAVE/4 |
+| [CANCOM: stream and message gaps](cancom_gap.json) | All channels manual and fully readable; no DIP override. | 1 / SAVE/4 |
+| [Write the first 32-byte USER_DATA block](user_data.json) | All channels manual and fully readable; no DIP override. | 2 / No independent SAVE |
+
+All positive previews expect exit_code=0 and zero effects counts. Mock execution expects exit_code=0 and readback=matched, except adaptive enable: adaptive_flags_matched with adaptive_result=not_verified. All cases retain power_cycle=not_verified. USER_DATA can succeed with save_acknowledged=0.
+
+## Negative examples (8; testing only)
+
+| File / error | Standard schema | CLI exit / error code |
+| --- | --- | --- |
+| [Target UID mismatch](negative/wrong_uid.json) | Passes; device preflight rejects | 6 / uid_mismatch |
+| [A string used for a numeric ID](negative/string_numeric_id.json) | Rejects | 7 / invalid_patch_value |
+| [Unknown parameter name](negative/unknown_field.json) | Rejects | 7 / invalid_patch_field |
+| [Adaptive enable mixed with another change](negative/adaptive_mixed.json) | Rejects | 7 / adaptive_enable_only |
+| [Inheritance from adaptive readback](negative/restricted_inheritance.json) | Passes; device preflight rejects | 7 / readonly_parameters |
+| [Adaptive enable on unsupported CANCOM](negative/unsupported_adaptive.json) | Passes; device preflight rejects | 5 / adaptive_not_supported |
+| [Hub BRT missing PS](negative/hub_missing_ps.json) | Passes; device preflight rejects | 7 / invalid_configuration |
+| [USER_DATA shorter than 32 bytes](negative/short_user_data.json) | Rejects | 7 / invalid_patch_value |
+
+Negative CLI tests deliberately bypass external schema validation to exercise the parser/device checks. Both dry-run and execution must perform zero configuration SET/WRITE/SAVE operations. Some failures happen before a driver trace exists. The general schema allows profile unions, such as 4/5-item BRT arrays, but a Hub requires item 5 (PS) in device preflight. The wrong_uid fixture keeps its all-zero UID; other fixtures replace UID to reach the intended failure branch.
+
+[index.json](index.json) is the shared machine index and process-test input. The index, schema and command result envelopes are not change requests. The same JSON request files are used by both language editions.