Skip to content

Commit a1bdf95

Browse files
authored
Rename main branch (#331)
1 parent 966b4af commit a1bdf95

File tree

3 files changed

+14
-14
lines changed

3 files changed

+14
-14
lines changed

.github/workflows/linter.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ name: Lint code
33

44
on:
55
push:
6-
branches-ignore: [master]
6+
branches-ignore: [main, master]
77
pull_request:
8-
branches-ignore: [master]
8+
branches-ignore: [main, master]
99

1010
jobs:
1111
build:

README.md

+12-12
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ADI MAX78000/MAX78002 Model Training and Synthesis
22

3-
February 26, 2024
3+
March 8, 2024
44

55
ADI’s MAX78000/MAX78002 project is comprised of five repositories:
66

@@ -329,7 +329,7 @@ To create the virtual environment and install basic wheels:
329329
$ cd ai8x-training
330330
```
331331

332-
The default branch is “develop” which is updated most frequently. If you want to use the “master” branch instead, switch to “master” using `git checkout master`.
332+
The default branch is “develop” which is updated most frequently. If you want to use the “main” branch instead, switch to “main” using `git checkout main`.
333333

334334
If using pyenv, set the local directory to use Python 3.8.11.
335335

@@ -394,7 +394,7 @@ For all other systems, including macOS, and CUDA 10.2 on Linux:
394394

395395
##### Repository Branches
396396

397-
By default, the `develop` branch is checked out. This branch is the most frequently updated branch and it contains the latest improvements to the project. To switch to the main branch that is updated less frequently, but may be more stable, use the command `git checkout master`.
397+
By default, the `develop` branch is checked out. This branch is the most frequently updated branch and it contains the latest improvements to the project. To switch to the main branch that is updated less frequently, but may be more stable, use the command `git checkout main`.
398398

399399
###### TensorFlow / Keras
400400

@@ -481,7 +481,7 @@ $ cd <your/project>
481481
$ cd ai8x-synthesis
482482
```
483483

484-
If you want to use the main branch, switch to “master” using the optional command `git checkout master`.
484+
If you want to use the main branch, switch to “main” using the optional command `git checkout main`.
485485

486486
If using pyenv, run:
487487

@@ -738,7 +738,7 @@ The number of discarded pixels is network specific and dependent on pooling stri
738738

739739
*Note: Streaming mode requires the use of [FIFOs](#fifos).*
740740

741-
For concrete examples on how to implement streaming mode with a camera, please see the [Camera Streaming Guide](https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/master/Guides/Camera_Streaming_Guide.md).
741+
For concrete examples on how to implement streaming mode with a camera, please see the [Camera Streaming Guide](https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/main/Guides/Camera_Streaming_Guide.md).
742742

743743
#### FIFOs
744744

@@ -2214,7 +2214,7 @@ The following table describes the most important command line arguments for `ai8
22142214
22152215
### YAML Network Description
22162216
2217-
The [quick-start guide](https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/master/Guides/YAML%20Quickstart.md) provides a short overview of the purpose and structure of the YAML network description file.
2217+
The [quick-start guide](https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/main/Guides/YAML%20Quickstart.md) provides a short overview of the purpose and structure of the YAML network description file.
22182218
22192219
If `yamllint` is installed and available in the shell path, it is automatically run against the configuration file and all warnings and errors are reported.
22202220
*Note: The name of the linter can be changed using the `--yamllint` command line argument.*
@@ -3029,7 +3029,7 @@ To run another inference, ensure all quadrants are disabled (stopping the state
30293029
The generated code is split between API code (in `cnn.c`) and data-dependent code in `main.c` or `main_riscv.c`. The data-dependent code is based on a known-answer test. The `main()` function shows the proper sequence of steps to load and configure the CNN accelerator, run it, unload it, and verify the result.
30303030
30313031
`void load_input(void);`
3032-
Load the example input. This function can serve as a template for loading data into the CNN accelerator. Note that the clocks and power to the accelerator must be enabled first. If this is skipped, the device may appear to hang and the [recovery procedure](https://github.com/MaximIntegratedAI/MaximAI_Documentation/tree/master/MAX78000_Feather#how-to-unlock-a-max78000-that-can-no-longer-be-programmed) may have to be used.
3032+
Load the example input. This function can serve as a template for loading data into the CNN accelerator. Note that the clocks and power to the accelerator must be enabled first. If this is skipped, the device may appear to hang and the [recovery procedure](https://github.com/MaximIntegratedAI/MaximAI_Documentation/tree/main/MAX78000_Feather#how-to-unlock-a-max78000-that-can-no-longer-be-programmed) may have to be used.
30333033
30343034
`int check_output(void);`
30353035
This function verifies that the known-answer test works correctly in hardware (using the example input). This function is typically not needed in the final application.
@@ -3223,7 +3223,7 @@ There can be many reasons why the known-answer test (KAT) fails for a given netw
32233223
* For very short and small networks, disable the use of WFI (wait for interrupt) instructions while waiting for completion of the CNN computations by using the command line option `--no-wfi`. *Explanation: In these cases, the network terminates more quickly than the time it takes between testing for completion and executing the WFI instruction, so the WFI instruction is never interrupted and the code may appear to hang.*
32243224
* The `--no-wfi` option can also be useful when trying to debug code, since the debugger loses connection when the device enters sleep mode using `__WFI()`.
32253225
* By default, there is a two-second delay at the beginning of the code. This time allows the debugger to take control before the device enters any kind of sleep mode. `--no-wfi` disables sleep mode (see also the related information [above](#known-answer-test-kat-console-does-not-print-passfail)). The time delay can be modified using the `--debugwait` option.
3226-
If the delay is too short or skipped altogether, and the device does not wake at the end of execution, the device may appear to hang and the [recovery procedure](https://github.com/MaximIntegratedAI/MaximAI_Documentation/tree/master/MAX78000_Feather#how-to-unlock-a-max78000-that-can-no-longer-be-programmed) may have to be used in order to load new code or to debug code.
3226+
If the delay is too short or skipped altogether, and the device does not wake at the end of execution, the device may appear to hang and the [recovery procedure](https://github.com/MaximIntegratedAI/MaximAI_Documentation/tree/main/MAX78000_Feather#how-to-unlock-a-max78000-that-can-no-longer-be-programmed) may have to be used in order to load new code or to debug code.
32273227
* For very large and deep networks, enable the boost power supply using the `--boost` command line option. On the EVkit, the boost supply is connected to port pin P2.5, so the command line option is `--boost 2.5`.
32283228
* The default compiler optimization level is `-O2`, and incorrect code may be generated under rare circumstances. Lower the optimization level in the generated `Makefile` to `-O1`, clean (`make distclean && make clean`), and rebuild the project (`make`). If this solves the problem, one of the possible reasons is that code is missing the `volatile` keyword for certain variables.
32293229
To permanently adjust the default compiler optimization level, modify `MXC_OPTIMIZE_CFLAGS` in `assets/embedded-ai85/templateMakefile` for Arm code and `assets/embedded-riscv-ai85/templateMakefile.RISCV` for RISC-V code.
@@ -3258,7 +3258,7 @@ When running C code generated with `--energy`, the power display on the EVKit wi
32583258
32593259
*Note: MAX78000 uses LED1 and LED2 to trigger power measurement via MAX32625 and MAX34417.*
32603260
3261-
See the [benchmarking guide](https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/master/Guides/MAX7800x%20Power%20Monitor%20and%20Energy%20Benchmarking%20Guide.pdf) for more information about benchmarking.
3261+
See the [benchmarking guide](https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/main/Guides/MAX7800x%20Power%20Monitor%20and%20Energy%20Benchmarking%20Guide.pdf) for more information about benchmarking.
32623262
32633263
32643264
@@ -3286,7 +3286,7 @@ Code should not generate any warnings in any of the tools (some of the component
32863286
(ai8x-synthesis) $ pip3 install flake8 pylint mypy isort
32873287
```
32883288
3289-
The GitHub projects use the [GitHub Super-Linter](https://github.com/github/super-linter) to automatically verify push operations and pull requests. The Super-Linter can be installed locally using [podman](https://podman.io) (or Docker), see [installation instructions](https://github.com/github/super-linter/blob/master/docs/run-linter-locally.md).
3289+
The GitHub projects use the [GitHub Super-Linter](https://github.com/github/super-linter) to automatically verify push operations and pull requests. The Super-Linter can be installed locally using [podman](https://podman.io) (or Docker), see [installation instructions](https://github.com/github/super-linter/blob/main/docs/run-linter-locally.md).
32903290
To run locally, create a clean copy of the repository and run the following command from the project directory (i.e., `ai8x-training` or `ai8x-synthesis`):
32913291
32923292
```shell
@@ -3295,11 +3295,11 @@ $ podman run --rm -e RUN_LOCAL=true -e VALIDATE_MARKDOWN=false -e VALIDATE_PYTHO
32953295
32963296
### Submitting Changes
32973297
3298-
Do not try to push any changes into the master branch. Instead, create a fork and submit a pull request against the `develop` branch. The easiest way to do this is using a [graphical client](#additional-software) such as Fork or GitHub Desktop.
3298+
Do not try to push any changes into the main branch. Instead, create a fork and submit a pull request against the `develop` branch. The easiest way to do this is using a [graphical client](#additional-software) such as Fork or GitHub Desktop.
32993299
33003300
*Note: After creating the fork, you must re-enable actions in the “Actions” tab of the repository on GitHub.*
33013301
33023302
The following document has more information:
3303-
<https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/master/CONTRIBUTING.md>
3303+
<https://github.com/MaximIntegratedAI/MaximAI_Documentation/blob/main/CONTRIBUTING.md>
33043304
33053305
---

README.pdf

-74 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)