Skip to content

L
linux
Commit ed6daf2b authored by Quentin Deslandes's avatar Quentin Deslandes Committed by Greg Kroah-Hartman
Browse files
Options

staging: axis-fifo: avoid parsing ignored device tree properties 

Some properties were parsed from the device tree and then ignored by the
driver. Some would return an error if absent from the device tree, then
return an error if they were found because they are unsupported by the
driver.

Avoid parsing unused properties and clearly explain in the documentation
the ignored / unsupported properties.
Signed-off-by: default avatarQuentin Deslandes <quentin.deslandes@itdev.co.uk>
Link: https://lore.kernel.org/r/20191101214232.16960-2-quentin.deslandes@itdev.co.ukSigned-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 3bce4750
Hide whitespace changes
Inline Side-by-side
Showing with 74 additions and 191 deletions
drivers/staging/axis-fifo/axis-fifo.c
View file @ ed6daf2b
......@@ -701,6 +701,68 @@ static int get_dts_property(struct axis_fifo *fifo,
return 0;
}
static int axis_fifo_parse_dt(struct axis_fifo *fifo)
{
int ret;
unsigned int value;
ret = get_dts_property(fifo, "xlnx,axi-str-rxd-tdata-width", &value);
if (ret) {
dev_err(fifo->dt_device, "missing xlnx,axi-str-rxd-tdata-width property\n");
goto end;
} else if (value != 32) {
dev_err(fifo->dt_device, "xlnx,axi-str-rxd-tdata-width only supports 32 bits\n");
ret = -EIO;
goto end;
}
ret = get_dts_property(fifo, "xlnx,axi-str-txd-tdata-width", &value);
if (ret) {
dev_err(fifo->dt_device, "missing xlnx,axi-str-txd-tdata-width property\n");
goto end;
} else if (value != 32) {
dev_err(fifo->dt_device, "xlnx,axi-str-txd-tdata-width only supports 32 bits\n");
ret = -EIO;
goto end;
}
ret = get_dts_property(fifo, "xlnx,rx-fifo-depth",
&fifo->rx_fifo_depth);
if (ret) {
dev_err(fifo->dt_device, "missing xlnx,rx-fifo-depth property\n");
ret = -EIO;
goto end;
}
ret = get_dts_property(fifo, "xlnx,tx-fifo-depth",
&fifo->tx_fifo_depth);
if (ret) {
dev_err(fifo->dt_device, "missing xlnx,tx-fifo-depth property\n");
ret = -EIO;
goto end;
}
/* IP sets TDFV to fifo depth - 4 so we will do the same */
fifo->tx_fifo_depth -= 4;
ret = get_dts_property(fifo, "xlnx,use-rx-data", &fifo->has_rx_fifo);
if (ret) {
dev_err(fifo->dt_device, "missing xlnx,use-rx-data property\n");
ret = -EIO;
goto end;
}
ret = get_dts_property(fifo, "xlnx,use-tx-data", &fifo->has_tx_fifo);
if (ret) {
dev_err(fifo->dt_device, "missing xlnx,use-tx-data property\n");
ret = -EIO;
goto end;
}
end:
return ret;
}
static int axis_fifo_probe(struct platform_device *pdev)
{
struct resource *r_irq; /* interrupt resources */
......@@ -712,34 +774,6 @@ static int axis_fifo_probe(struct platform_device *pdev)
int rc = 0; /* error return value */
/* IP properties from device tree */
unsigned int rxd_tdata_width;
unsigned int txc_tdata_width;
unsigned int txd_tdata_width;
unsigned int tdest_width;
unsigned int tid_width;
unsigned int tuser_width;
unsigned int data_interface_type;
unsigned int has_tdest;
unsigned int has_tid;
unsigned int has_tkeep;
unsigned int has_tstrb;
unsigned int has_tuser;
unsigned int rx_fifo_depth;
unsigned int rx_programmable_empty_threshold;
unsigned int rx_programmable_full_threshold;
unsigned int axi_id_width;
unsigned int axi4_data_width;
unsigned int select_xpm;
unsigned int tx_fifo_depth;
unsigned int tx_programmable_empty_threshold;
unsigned int tx_programmable_full_threshold;
unsigned int use_rx_cut_through;
unsigned int use_rx_data;
unsigned int use_tx_control;
unsigned int use_tx_cut_through;
unsigned int use_tx_data;
/* ----------------------------
* init wrapper device
* ----------------------------
......@@ -806,164 +840,9 @@ static int axis_fifo_probe(struct platform_device *pdev)
* ----------------------------
*/
/* retrieve device tree properties */
rc = get_dts_property(fifo, "xlnx,axi-str-rxd-tdata-width",
&rxd_tdata_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,axi-str-txc-tdata-width",
&txc_tdata_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,axi-str-txd-tdata-width",
&txd_tdata_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,axis-tdest-width", &tdest_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,axis-tid-width", &tid_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,axis-tuser-width", &tuser_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,data-interface-type",
&data_interface_type);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,has-axis-tdest", &has_tdest);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,has-axis-tid", &has_tid);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,has-axis-tkeep", &has_tkeep);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,has-axis-tstrb", &has_tstrb);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,has-axis-tuser", &has_tuser);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,rx-fifo-depth", &rx_fifo_depth);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,rx-fifo-pe-threshold",
&rx_programmable_empty_threshold);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,rx-fifo-pf-threshold",
&rx_programmable_full_threshold);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,s-axi-id-width", &axi_id_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,s-axi4-data-width", &axi4_data_width);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,select-xpm", &select_xpm);
rc = axis_fifo_parse_dt(fifo);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,tx-fifo-depth", &tx_fifo_depth);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,tx-fifo-pe-threshold",
&tx_programmable_empty_threshold);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,tx-fifo-pf-threshold",
&tx_programmable_full_threshold);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,use-rx-cut-through",
&use_rx_cut_through);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,use-rx-data", &use_rx_data);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,use-tx-ctrl", &use_tx_control);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,use-tx-cut-through",
&use_tx_cut_through);
if (rc)
goto err_unmap;
rc = get_dts_property(fifo, "xlnx,use-tx-data", &use_tx_data);
if (rc)
goto err_unmap;
/* check validity of device tree properties */
if (rxd_tdata_width != 32) {
dev_err(fifo->dt_device,
"rxd_tdata_width width [%u] unsupported\n",
rxd_tdata_width);
rc = -EIO;
goto err_unmap;
}
if (txd_tdata_width != 32) {
dev_err(fifo->dt_device,
"txd_tdata_width width [%u] unsupported\n",
txd_tdata_width);
rc = -EIO;
goto err_unmap;
}
if (has_tdest) {
dev_err(fifo->dt_device, "tdest not supported\n");
rc = -EIO;
goto err_unmap;
}
if (has_tid) {
dev_err(fifo->dt_device, "tid not supported\n");
rc = -EIO;
goto err_unmap;
}
if (has_tkeep) {
dev_err(fifo->dt_device, "tkeep not supported\n");
rc = -EIO;
goto err_unmap;
}
if (has_tstrb) {
dev_err(fifo->dt_device, "tstrb not supported\n");
rc = -EIO;
goto err_unmap;
}
if (has_tuser) {
dev_err(fifo->dt_device, "tuser not supported\n");
rc = -EIO;
goto err_unmap;
}
if (use_rx_cut_through) {
dev_err(fifo->dt_device, "rx cut-through not supported\n");
rc = -EIO;
goto err_unmap;
}
if (use_tx_cut_through) {
dev_err(fifo->dt_device, "tx cut-through not supported\n");
rc = -EIO;
goto err_unmap;
}
if (use_tx_control) {
dev_err(fifo->dt_device, "tx control not supported\n");
rc = -EIO;
goto err_unmap;
}
/* TODO
* these exist in the device tree but it's unclear what they do
* - select-xpm
* - data-interface-type
*/
/* set device wrapper properties based on IP config */
fifo->rx_fifo_depth = rx_fifo_depth;
/* IP sets TDFV to fifo depth - 4 so we will do the same */
fifo->tx_fifo_depth = tx_fifo_depth - 4;
fifo->has_rx_fifo = use_rx_data;
fifo->has_tx_fifo = use_tx_data;
reset_ip_core(fifo);
......
drivers/staging/axis-fifo/axis-fifo.txt
View file @ ed6daf2b
......@@ -25,10 +25,10 @@ Required properties:
- xlnx,axi-str-txc-tdata-width: Should be <0x20>
- xlnx,axi-str-txd-protocol: Should be "XIL_AXI_STREAM_ETH_DATA"
- xlnx,axi-str-txd-tdata-width: Should be <0x20>
- xlnx,axis-tdest-width: AXI-Stream TDEST width
- xlnx,axis-tid-width: AXI-Stream TID width
- xlnx,axis-tuser-width: AXI-Stream TUSER width
- xlnx,data-interface-type: Should be <0x0>
- xlnx,axis-tdest-width: AXI-Stream TDEST width (ignored by the driver)
- xlnx,axis-tid-width: AXI-Stream TID width (ignored by the driver)
- xlnx,axis-tuser-width: AXI-Stream TUSER width (ignored by the driver)
- xlnx,data-interface-type: Should be <0x0> (ignored by the driver)
- xlnx,has-axis-tdest: Should be <0x0> (this feature isn't supported)
- xlnx,has-axis-tid: Should be <0x0> (this feature isn't supported)
- xlnx,has-axis-tkeep: Should be <0x0> (this feature isn't supported)
......@@ -36,13 +36,17 @@ Required properties:
- xlnx,has-axis-tuser: Should be <0x0> (this feature isn't supported)
- xlnx,rx-fifo-depth: Depth of RX FIFO in words
- xlnx,rx-fifo-pe-threshold: RX programmable empty interrupt threshold
(ignored by the driver)
- xlnx,rx-fifo-pf-threshold: RX programmable full interrupt threshold
- xlnx,s-axi-id-width: Should be <0x4>
- xlnx,s-axi4-data-width: Should be <0x20>
- xlnx,select-xpm: Should be <0x0>
(ignored by the driver)
- xlnx,s-axi-id-width: Should be <0x4> (ignored by the driver)
- xlnx,s-axi4-data-width: Should be <0x20> (ignored by the driver)
- xlnx,select-xpm: Should be <0x0> (ignored by the driver)
- xlnx,tx-fifo-depth: Depth of TX FIFO in words
- xlnx,tx-fifo-pe-threshold: TX programmable empty interrupt threshold
(ignored by the driver)
- xlnx,tx-fifo-pf-threshold: TX programmable full interrupt threshold
(ignored by the driver)
- xlnx,use-rx-cut-through: Should be <0x0> (this feature isn't supported)
- xlnx,use-rx-data: <0x1> if RX FIFO is enabled, <0x0> otherwise
- xlnx,use-tx-ctrl: Should be <0x0> (this feature isn't supported)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7