Skip to content

Commit 1e8840a

Browse files
committed
merge: 'upstream' into pst-v4.3.99 zephyrproject-rtos#22
# Conflicts: # drivers/ethernet/eth_stm32_hal_common.c # subsys/shell/backends/shell_uart.c # subsys/shell/modules/devmem_service.c
2 parents 2e71f87 + 1571654 commit 1e8840a

170 files changed

Lines changed: 4706 additions & 3553 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/assigner.yml

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ on:
99
- ready_for_review
1010
branches:
1111
- main
12+
- collab-*
13+
- v*-branch
1214
issues:
1315
types:
1416
- labeled
@@ -38,7 +40,7 @@ jobs:
3840

3941
- name: Fetch west.yml/Maintainer.yml from pull request
4042
if: >
41-
github.event_name == 'pull_request_target'
43+
github.event_name == 'pull_request_target' && github.base_ref == 'main'
4244
run: |
4345
git fetch origin pull/${{ github.event.pull_request.number }}/merge
4446
git show FETCH_HEAD:west.yml > pr_west.yml
@@ -61,7 +63,11 @@ jobs:
6163
FLAGS+=" -r ${{ github.event.repository.name }}"
6264
FLAGS+=" -M MAINTAINERS.yml"
6365
if [ "${{ github.event_name }}" = "pull_request_target" ]; then
64-
FLAGS+=" -P ${{ github.event.pull_request.number }} --updated-manifest pr_west.yml --updated-maintainer-file pr_MAINTAINERS.yml"
66+
if [ "${{ github.base_ref }}" != "main" ]; then
67+
FLAGS+=" -P ${{ github.event.pull_request.number }} --updated-manifest pr_west.yml --updated-maintainer-file pr_MAINTAINERS.yml"
68+
else
69+
FLAGS+=" -P ${{ github.event.pull_request.number }}"
70+
fi
6571
elif [ "${{ github.event_name }}" = "issues" ]; then
6672
FLAGS+=" -I ${{ github.event.issue.number }}"
6773
elif [ "${{ github.event_name }}" = "schedule" ]; then
@@ -74,7 +80,7 @@ jobs:
7480
7581
- name: Check maintainer file changes
7682
if: >
77-
github.event_name == 'pull_request_target'
83+
github.event_name == 'pull_request_target' && github.base_ref == 'main'
7884
env:
7985
GITHUB_TOKEN: ${{ secrets.ZB_PR_ASSIGNER_GITHUB_TOKEN }}
8086
run: |

MAINTAINERS.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2450,7 +2450,7 @@ Documentation Infrastructure:
24502450
- include/zephyr/drivers/stepper/
24512451
- include/zephyr/drivers/stepper.h
24522452
- dts/bindings/stepper/
2453-
- doc/hardware/peripherals/stepper.rst
2453+
- doc/hardware/peripherals/stepper/
24542454
- samples/drivers/stepper/
24552455
- tests/drivers/build_all/stepper/
24562456
- tests/drivers/stepper/
@@ -3386,6 +3386,7 @@ Microchip RISC-V Platforms:
33863386
status: maintained
33873387
maintainers:
33883388
- fkokosinski
3389+
collaborators:
33893390
- kgugala
33903391
- tgorochowik
33913392
files:

boards/nxp/frdm_mcxn947/CMakeLists.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,6 @@ zephyr_library_sources(board.c)
99

1010
if(CONFIG_FLEXSPI_CONFIG_BLOCK_OFFSET)
1111
# Include flash configuration block
12-
zephyr_compile_definitions(XIP_BOOT_HEADER_ENABLE=1)
1312
zephyr_library_sources(xip/mcxn_flexspi_nor_config.c)
1413
zephyr_library_include_directories(xip)
1514
endif()

boards/nxp/frdm_rw612/CMakeLists.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,6 @@ dt_nodelabel(xtal32 NODELABEL "xtal32")
1010
dt_node_has_status(xtal32_status PATH ${xtal32} STATUS okay)
1111

1212
if(CONFIG_NXP_RW6XX_BOOT_HEADER)
13-
zephyr_compile_definitions(BOARD_FLASH_SIZE=CONFIG_FLASH_SIZE*1024)
1413
# This FCB is specific to the flash on this board, it won't work
1514
# for boards with different flash chips. If you flash this FCB
1615
# onto a board with a different flash chip you may break it.

boards/nxp/mcx_nx4x_evk/CMakeLists.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,6 @@ zephyr_library_sources(board.c)
99

1010
if(CONFIG_FLEXSPI_CONFIG_BLOCK_OFFSET)
1111
# Include flash configuration block
12-
zephyr_compile_definitions(XIP_BOOT_HEADER_ENABLE=1)
1312
zephyr_library_sources(xip/mcxn_flexspi_nor_config.c)
1413
zephyr_library_include_directories(xip)
1514
endif()

boards/nxp/rd_rw612_bga/CMakeLists.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ if(CONFIG_NXP_RW6XX_BOOT_HEADER)
1616
"update your flash configuration block data")
1717
endif()
1818
zephyr_compile_definitions(BOOT_HEADER_ENABLE=1)
19-
zephyr_compile_definitions(BOARD_FLASH_SIZE=CONFIG_FLASH_SIZE*1024)
2019
zephyr_library_sources(MX25U51245GZ4I00_FCB.c)
2120
endif()
2221

boards/st/stm32n6570_dk/twister.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
name: STM32N6570 Discovery Kit
22
type: mcu
33
arch: arm
4-
ram: 128
4+
ram: 192
55
flash: 512
66
vendor: st
77
supported:

doc/connectivity/networking/dsa.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ of i.MX NETC.
8383
.phy_mode = NETC_PHY_MODE(port), \
8484
}; \
8585
struct dsa_port_config dsa_##n##_##port##_config = { \
86-
.use_random_mac_addr = DT_NODE_HAS_PROP(port, zephyr_random_mac_address), \
86+
.use_random_mac_addr = DT_PROP(port, zephyr_random_mac_address), \
8787
.mac_addr = DT_PROP_OR(port, local_mac_address, {0}), \
8888
.port_idx = DT_REG_ADDR(port), \
8989
.phy_dev = DEVICE_DT_GET_OR_NULL(DT_PHANDLE(port, phy_handle)), \

doc/hardware/peripherals/index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ Peripherals
5858
sensor/index.rst
5959
sent.rst
6060
spi.rst
61-
stepper.rst
61+
stepper/index.rst
6262
smbus.rst
6363
uart.rst
6464
usbc_vbus.rst

doc/hardware/peripherals/stepper.rst renamed to doc/hardware/peripherals/stepper/index.rst

Lines changed: 35 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -3,22 +3,27 @@
33
Steppers
44
########
55

6-
The stepper driver API provides a set of functions for controlling and configuring stepper drivers.
6+
The stepper driver subsystem consists of two device driver APIs:
77

8-
Configure Stepper Driver
9-
========================
8+
Stepper-DRV API
9+
***************
10+
11+
The stepper driver API provides a common interface for stepper drivers.
12+
13+
- Configure **micro-stepping resolution** using :c:func:`stepper_drv_set_micro_step_res`
14+
and :c:func:`stepper_drv_get_micro_step_res`.
15+
- **Enable** the stepper driver using :c:func:`stepper_drv_enable`.
16+
- **Disable** the stepper driver using :c:func:`stepper_drv_disable`.
17+
- Register an **event callback** using :c:func:`stepper_drv_set_event_cb`.
18+
19+
Stepper API
20+
***********
21+
22+
The stepper API provides a common interface for stepper controllers.
1023

11-
- Configure **micro-stepping resolution** using :c:func:`stepper_set_micro_step_res`
12-
and :c:func:`stepper_get_micro_step_res`.
1324
- Configure **reference position** in microsteps using :c:func:`stepper_set_reference_position`
1425
and :c:func:`stepper_get_actual_position`.
1526
- Set **step interval** in nanoseconds between steps using :c:func:`stepper_set_microstep_interval`
16-
- **Enable** the stepper driver using :c:func:`stepper_enable`.
17-
- **Disable** the stepper driver using :c:func:`stepper_disable`.
18-
19-
Control Stepper
20-
===============
21-
2227
- **Move by** +/- micro-steps also known as **relative movement** using :c:func:`stepper_move_by`.
2328
- **Move to** a specific position also known as **absolute movement** using :c:func:`stepper_move_to`.
2429
- Run continuously with a **constant step interval** in a specific direction until
@@ -27,30 +32,30 @@ Control Stepper
2732
- Check if the stepper is **moving** using :c:func:`stepper_is_moving`.
2833
- Register an **event callback** using :c:func:`stepper_set_event_callback`.
2934

35+
.. _stepper-device-tree:
36+
3037
Device Tree
31-
===========
38+
***********
3239

3340
In the context of stepper controllers device tree provides the initial hardware
3441
configuration for stepper drivers on a per device level. Each device must specify
3542
a device tree binding in Zephyr, and ideally, a set of hardware configuration options
3643
for things such as current settings, ramp parameters and furthermore. These can then
3744
be used in a boards devicetree to configure a stepper driver to its initial state.
3845

39-
See examples in:
46+
Driver Composition Scenarios
47+
============================
4048

41-
- :dtcompatible:`zephyr,h-bridge-stepper`
42-
- :dtcompatible:`adi,tmc50xx`
49+
Below are two typical scenarios:
4350

44-
Discord
45-
=======
51+
.. toctree::
52+
:maxdepth: 1
4653

47-
Zephyr has a `stepper discord`_ channel for stepper related discussions, which
48-
is open to all.
49-
50-
.. _stepper-api-reference:
54+
integrated_controller_driver.rst
55+
individual_controller_driver.rst
5156

5257
Stepper API Test Suite
53-
======================
58+
**********************
5459

5560
The stepper API test suite provides a set of tests that can be used to verify the functionality of
5661
stepper drivers.
@@ -91,8 +96,16 @@ have been skipped.
9196
API Reference
9297
*************
9398

99+
.. _stepper-drv-api-reference:
100+
94101
A common set of functions which should be implemented by all stepper drivers.
95102

103+
.. doxygengroup:: stepper_drv_interface
104+
105+
.. _stepper-api-reference:
106+
107+
A common set of functions which should be implemented by all stepper controllers.
108+
96109
.. doxygengroup:: stepper_interface
97110

98111
Stepper controller specific APIs

0 commit comments

Comments
 (0)