diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/driver-model/index.rst | 1 | ||||
| -rw-r--r-- | doc/driver-model/serial-howto.rst (renamed from doc/driver-model/serial-howto.txt) | 12 |
2 files changed, 8 insertions, 5 deletions
diff --git a/doc/driver-model/index.rst b/doc/driver-model/index.rst index c6353dcf663..82f4393099f 100644 --- a/doc/driver-model/index.rst +++ b/doc/driver-model/index.rst @@ -16,3 +16,4 @@ Driver Model pci-info pmic-framework remoteproc-framework + serial-howto diff --git a/doc/driver-model/serial-howto.txt b/doc/driver-model/serial-howto.rst index a0df9a7ec28..1469131124b 100644 --- a/doc/driver-model/serial-howto.txt +++ b/doc/driver-model/serial-howto.rst @@ -1,11 +1,13 @@ +.. SPDX-License-Identifier: GPL-2.0+ + How to port a serial driver to driver model =========================================== Almost all of the serial drivers have been converted as at January 2016. These ones remain: - serial_bfin.c - serial_pxa.c + * serial_bfin.c + * serial_pxa.c The deadline for this work was the end of January 2016. If no one steps forward to convert these, at some point there may come a patch to remove them! @@ -17,14 +19,14 @@ model. Please feel free to update this file with your ideas and suggestions. - Define CONFIG_DM_SERIAL for your board, vendor or architecture - If the board does not already use driver model, you need CONFIG_DM also - Your board should then build, but will not boot since there will be no serial - driver + driver - Add the U_BOOT_DRIVER piece at the end (e.g. copy serial_s5p.c for example) - Add a private struct for the driver data - avoid using static variables - Implement each of the driver methods, perhaps by calling your old methods - You may need to adjust the function parameters so that the old and new - implementations can share most of the existing code + implementations can share most of the existing code - If you convert all existing users of the driver, remove the pre-driver-model - code + code In terms of patches a conversion series typically has these patches: - clean up / prepare the driver for conversion |