1# Licensed to the Apache Software Foundation (ASF) under one
2# or more contributor license agreements.  See the NOTICE file
3# distributed with this work for additional information
4# regarding copyright ownership.  The ASF licenses this file
5# to you under the Apache License, Version 2.0 (the
6# "License"); you may not use this file except in compliance
7# with the License.  You may obtain a copy of the License at
8#
9#  http://www.apache.org/licenses/LICENSE-2.0
10#
11# Unless required by applicable law or agreed to in writing,
12# software distributed under the License is distributed on an
13# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14# KIND, either express or implied.  See the License for the
15# specific language governing permissions and limitations
16# under the License.
17#
18
19syscfg.defs:
20    BOOT_SERIAL_DETECT_PIN:
21        description: >
22            Start the serial boot loader if this pin is asserted at boot time.
23        value: '-1'
24        restrictions:
25            - '(BOOT_SERIAL_DETECT_PIN != -1) ||
26               (BOOT_SERIAL_DETECT_TIMEOUT != 0) ||
27               (BOOT_SERIAL_NVREG_INDEX != -1)'
28
29    BOOT_SERIAL_DETECT_PIN_CFG:
30        description: >
31            GPIO configuration for the serial boot loader detect pin.
32        value: 'HAL_GPIO_PULL_UP'
33
34    BOOT_SERIAL_DETECT_PIN_VAL:
35        description: >
36            The value the detect pin must be set to for the serial boot loader
37            to start.
38        value: 0
39
40    BOOT_SERIAL_DETECT_TIMEOUT:
41        description: >
42            The duration, in milliseconds, to listen on the UART for the
43            management string (BOOT_SERIAL_DETECT_STRING).  If the management
44            string is detected during this period, the serial boot loader is
45            started.  If the period expires without the management string being
46            received, the boot loader runs in the normal (non-serial) mode.
47            Specify 0 to disable listening on the UART for the management
48            string.
49        value: 0
50        restrictions:
51            - '(BOOT_SERIAL_DETECT_PIN != -1) ||
52               (BOOT_SERIAL_DETECT_TIMEOUT != 0) ||
53               (BOOT_SERIAL_NVREG_INDEX != -1)'
54
55    BOOT_SERIAL_DETECT_STRING:
56        description: >
57            The string to listen for on the UART.  If this management string is
58            detected during the timeout period, the serial boot loader is
59            started.  If the period expires without this string being received,
60            the boot loader runs in the normal (non-serial) mode.  This setting
61            has no effect if BOOT_SERIAL_DETECT_TIMEOUT is set to 0.
62        value: '"nmgr"'
63
64    BOOT_SERIAL_REPORT_PIN:
65        description: >
66            The GPIO to toggle while the serial boot loader is running.  Set to
67            -1 to disable reporting.
68        value: 'LED_BLINK_PIN'
69
70    BOOT_SERIAL_REPORT_FREQ:
71        description: >
72            The toggle rate, in Hz, of the serial boot loader report pin.
73        value: 4
74
75    BOOT_SERIAL_NVREG_MAGIC:
76        description: >
77            Magic number, to be saved in a retained (reset-surviving) register.
78            If the value in the register matches, the serial bootloader will
79            load. Value must not be 0.
80        value: 0xB7
81        restrictions:
82            - '(BOOT_SERIAL_NVREG_MAGIC != 0)'
83
84    BOOT_SERIAL_NVREG_INDEX:
85        description: >
86            Index of retained register to use (using hal_nvreg_read) for reading
87            magic value.
88        value: -1
89        restrictions:
90            - '(BOOT_SERIAL_DETECT_PIN != -1) ||
91               (BOOT_SERIAL_DETECT_TIMEOUT != 0) ||
92               (BOOT_SERIAL_NVREG_INDEX != -1)'
93
94    BOOT_SERIAL_MGMT_ECHO:
95        description: If enabled, support for the mcumgr echo command is being added.
96        value: 0
97