drivers/usb/host/ehci-fsl.c - kernel/msm - Gitiles

 /*
  * (C) Copyright David Brownell 2000-2002
  * Copyright (c) 2005 MontaVista Software
  *
  * This program is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License as published by the
  * Free Software Foundation; either version 2 of the License, or (at your
  * option) any later version.
  *
  * This program is distributed in the hope that it will be useful, but
  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  * for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  *
  * Ported to 834x by Randy Vinson <rvinson@mvista.com> using code provided
  * by Hunter Wu.
  */

 #include <linux/platform_device.h>
 #include <linux/fsl_devices.h>

 #include "ehci-fsl.h"

 /* FIXME: Power Managment is un-ported so temporarily disable it */
 #undef CONFIG_PM

 /* PCI-based HCs are common, but plenty of non-PCI HCs are used too */

 /* configure so an HC device and id are always provided */
 /* always called with process context; sleeping is OK */

 /**
  * usb_hcd_fsl_probe - initialize FSL-based HCDs
  * @drvier: Driver to be used for this HCD
  * @pdev: USB Host Controller being probed
  * Context: !in_interrupt()
  *
  * Allocates basic resources for this USB host controller.
  *
  */
 int usb_hcd_fsl_probe(const struct hc_driver *driver,
 		      struct platform_device *pdev)
 {
 	struct fsl_usb2_platform_data *pdata;
 	struct usb_hcd *hcd;
 	struct resource *res;
 	int irq;
 	int retval;
 	unsigned int temp;

 	pr_debug("initializing FSL-SOC USB Controller\n");

 	/* Need platform data for setup */
 	pdata = (struct fsl_usb2_platform_data *)pdev->dev.platform_data;
 	if (!pdata) {
 		dev_err(&pdev->dev,
 			"No platform data for %s.\n", pdev->dev.bus_id);
 		return -ENODEV;
 	}

 	/*
 	 * This is a host mode driver, verify that we're supposed to be
 	 * in host mode.
 	 */
 	if (!((pdata->operating_mode == FSL_USB2_DR_HOST) ||
 	      (pdata->operating_mode == FSL_USB2_MPH_HOST))) {
 		dev_err(&pdev->dev,
 			"Non Host Mode configured for %s. Wrong driver linked.\n",
 			pdev->dev.bus_id);
 		return -ENODEV;
 	}

 	res = platform_get_resource(pdev, IORESOURCE_IRQ, 0);
 	if (!res) {
 		dev_err(&pdev->dev,
 			"Found HC with no IRQ. Check %s setup!\n",
 			pdev->dev.bus_id);
 		return -ENODEV;
 	}
 	irq = res->start;

 	hcd = usb_create_hcd(driver, &pdev->dev, pdev->dev.bus_id);
 	if (!hcd) {
 		retval = -ENOMEM;
 		goto err1;
 	}

 	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 	if (!res) {
 		dev_err(&pdev->dev,
 			"Found HC with no register addr. Check %s setup!\n",
 			pdev->dev.bus_id);
 		retval = -ENODEV;
 		goto err2;
 	}
 	hcd->rsrc_start = res->start;
 	hcd->rsrc_len = res->end - res->start + 1;
 	if (!request_mem_region(hcd->rsrc_start, hcd->rsrc_len,
 				driver->description)) {
 		dev_dbg(&pdev->dev, "controller already in use\n");
 		retval = -EBUSY;
 		goto err2;
 	}
 	hcd->regs = ioremap(hcd->rsrc_start, hcd->rsrc_len);

 	if (hcd->regs == NULL) {
 		dev_dbg(&pdev->dev, "error mapping memory\n");
 		retval = -EFAULT;
 		goto err3;
 	}

 	/* Enable USB controller */
 	temp = in_be32(hcd->regs + 0x500);
 	out_be32(hcd->regs + 0x500, temp | 0x4);

 	/* Set to Host mode */
 	temp = in_le32(hcd->regs + 0x1a8);
 	out_le32(hcd->regs + 0x1a8, temp | 0x3);

 	retval = usb_add_hcd(hcd, irq, SA_SHIRQ);
 	if (retval != 0)
 		goto err4;
 	return retval;

       err4:
 	iounmap(hcd->regs);
       err3:
 	release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
       err2:
 	usb_put_hcd(hcd);
       err1:
 	dev_err(&pdev->dev, "init %s fail, %d\n", pdev->dev.bus_id, retval);
 	return retval;
 }

 /* may be called without controller electrically present */
 /* may be called with controller, bus, and devices active */

 /**
  * usb_hcd_fsl_remove - shutdown processing for FSL-based HCDs
  * @dev: USB Host Controller being removed
  * Context: !in_interrupt()
  *
  * Reverses the effect of usb_hcd_fsl_probe().
  *
  */
 void usb_hcd_fsl_remove(struct usb_hcd *hcd, struct platform_device *pdev)
 {
 	usb_remove_hcd(hcd);
 	iounmap(hcd->regs);
 	release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
 	usb_put_hcd(hcd);
 }

 static void mpc83xx_setup_phy(struct ehci_hcd *ehci,
 			      enum fsl_usb2_phy_modes phy_mode,
 			      unsigned int port_offset)
 {
 	u32 portsc = 0;
 	switch (phy_mode) {
 	case FSL_USB2_PHY_ULPI:
 		portsc |= PORT_PTS_ULPI;
 		break;
 	case FSL_USB2_PHY_SERIAL:
 		portsc |= PORT_PTS_SERIAL;
 		break;
 	case FSL_USB2_PHY_UTMI_WIDE:
 		portsc |= PORT_PTS_PTW;
 		/* fall through */
 	case FSL_USB2_PHY_UTMI:
 		portsc |= PORT_PTS_UTMI;
 		break;
 	case FSL_USB2_PHY_NONE:
 		break;
 	}
 	writel(portsc, &ehci->regs->port_status[port_offset]);
 }

 static void mpc83xx_usb_setup(struct usb_hcd *hcd)
 {
 	struct ehci_hcd *ehci = hcd_to_ehci(hcd);
 	struct fsl_usb2_platform_data *pdata;
 	void __iomem *non_ehci = hcd->regs;

 	pdata =
 	    (struct fsl_usb2_platform_data *)hcd->self.controller->
 	    platform_data;
 	/* Enable PHY interface in the control reg. */
 	out_be32(non_ehci + FSL_SOC_USB_CTRL, 0x00000004);
 	out_be32(non_ehci + FSL_SOC_USB_SNOOP1, 0x0000001b);

 	if (pdata->operating_mode == FSL_USB2_DR_HOST)
 		mpc83xx_setup_phy(ehci, pdata->phy_mode, 0);

 	if (pdata->operating_mode == FSL_USB2_MPH_HOST) {
 		unsigned int chip, rev, svr;

 		svr = mfspr(SPRN_SVR);
 		chip = svr >> 16;
 		rev = (svr >> 4) & 0xf;

 		/* Deal with USB Erratum #14 on MPC834x Rev 1.0 & 1.1 chips */
 		if ((rev == 1) && (chip >= 0x8050) && (chip <= 0x8055))
 			ehci->has_fsl_port_bug = 1;

 		if (pdata->port_enables & FSL_USB2_PORT0_ENABLED)
 			mpc83xx_setup_phy(ehci, pdata->phy_mode, 0);
 		if (pdata->port_enables & FSL_USB2_PORT1_ENABLED)
 			mpc83xx_setup_phy(ehci, pdata->phy_mode, 1);
 	}

 	/* put controller in host mode. */
 	writel(0x00000003, non_ehci + FSL_SOC_USB_USBMODE);
 	out_be32(non_ehci + FSL_SOC_USB_PRICTRL, 0x0000000c);
 	out_be32(non_ehci + FSL_SOC_USB_AGECNTTHRSH, 0x00000040);
 	out_be32(non_ehci + FSL_SOC_USB_SICTRL, 0x00000001);
 }

 /* called after powerup, by probe or system-pm "wakeup" */
 static int ehci_fsl_reinit(struct ehci_hcd *ehci)
 {
 	mpc83xx_usb_setup(ehci_to_hcd(ehci));
 	ehci_port_power(ehci, 0);

 	return 0;
 }

 /* called during probe() after chip reset completes */
 static int ehci_fsl_setup(struct usb_hcd *hcd)
 {
 	struct ehci_hcd *ehci = hcd_to_ehci(hcd);
 	int retval;

 	/* EHCI registers start at offset 0x100 */
 	ehci->caps = hcd->regs + 0x100;
 	ehci->regs = hcd->regs + 0x100 +
 	    HC_LENGTH(readl(&ehci->caps->hc_capbase));
 	dbg_hcs_params(ehci, "reset");
 	dbg_hcc_params(ehci, "reset");

 	/* cache this readonly data; minimize chip reads */
 	ehci->hcs_params = readl(&ehci->caps->hcs_params);

 	retval = ehci_halt(ehci);
 	if (retval)
 		return retval;

 	/* data structure init */
 	retval = ehci_init(hcd);
 	if (retval)
 		return retval;

 	ehci->is_tdi_rh_tt = 1;

 	ehci->sbrn = 0x20;

 	ehci_reset(ehci);

 	retval = ehci_fsl_reinit(ehci);
 	return retval;
 }

 static const struct hc_driver ehci_fsl_hc_driver = {
 	.description = hcd_name,
 	.product_desc = "Freescale On-Chip EHCI Host Controller",
 	.hcd_priv_size = sizeof(struct ehci_hcd),

 	/*
 	 * generic hardware linkage
 	 */
 	.irq = ehci_irq,
 	.flags = HCD_USB2,

 	/*
 	 * basic lifecycle operations
 	 */
 	.reset = ehci_fsl_setup,
 	.start = ehci_run,
 #ifdef	CONFIG_PM
 	.suspend = ehci_bus_suspend,
 	.resume = ehci_bus_resume,
 #endif
 	.stop = ehci_stop,

 	/*
 	 * managing i/o requests and associated device resources
 	 */
 	.urb_enqueue = ehci_urb_enqueue,
 	.urb_dequeue = ehci_urb_dequeue,
 	.endpoint_disable = ehci_endpoint_disable,

 	/*
 	 * scheduling support
 	 */
 	.get_frame_number = ehci_get_frame,

 	/*
 	 * root hub support
 	 */
 	.hub_status_data = ehci_hub_status_data,
 	.hub_control = ehci_hub_control,
 	.bus_suspend = ehci_bus_suspend,
 	.bus_resume = ehci_bus_resume,
 };

 static int ehci_fsl_drv_probe(struct platform_device *pdev)
 {
 	if (usb_disabled())
 		return -ENODEV;

 	return usb_hcd_fsl_probe(&ehci_fsl_hc_driver, pdev);
 }

 static int ehci_fsl_drv_remove(struct platform_device *pdev)
 {
 	struct usb_hcd *hcd = platform_get_drvdata(pdev);

 	usb_hcd_fsl_remove(hcd, pdev);

 	return 0;
 }

 static struct platform_driver ehci_fsl_dr_driver = {
 	.probe = ehci_fsl_drv_probe,
 	.remove = ehci_fsl_drv_remove,
 	.driver = {
 		   .name = "fsl-usb2-dr",
 		   },
 };

 static struct platform_driver ehci_fsl_mph_driver = {
 	.probe = ehci_fsl_drv_probe,
 	.remove = ehci_fsl_drv_remove,
 	.driver = {
 		   .name = "fsl-usb2-mph",
 		   },
 };

 static int __init ehci_fsl_init(void)
 {
 	int retval;

 	pr_debug("%s: block sizes: qh %Zd qtd %Zd itd %Zd sitd %Zd\n",
 		 hcd_name,
 		 sizeof(struct ehci_qh), sizeof(struct ehci_qtd),
 		 sizeof(struct ehci_itd), sizeof(struct ehci_sitd));

 	retval = platform_driver_register(&ehci_fsl_dr_driver);
 	if (retval)
 		return retval;

 	return platform_driver_register(&ehci_fsl_mph_driver);
 }

 static void __exit ehci_fsl_cleanup(void)
 {
 	platform_driver_unregister(&ehci_fsl_mph_driver);
 	platform_driver_unregister(&ehci_fsl_dr_driver);
 }

 module_init(ehci_fsl_init);
 module_exit(ehci_fsl_cleanup);
	/*
	* (C) Copyright David Brownell 2000-2002
	* Copyright (c) 2005 MontaVista Software
	*
	* This program is free software; you can redistribute it and/or modify it
	* under the terms of the GNU General Public License as published by the
	* Free Software Foundation; either version 2 of the License, or (at your
	* option) any later version.
	*
	* This program is distributed in the hope that it will be useful, but
	* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
	* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	* for more details.
	*
	* You should have received a copy of the GNU General Public License
	* along with this program; if not, write to the Free Software Foundation,
	* Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
	*
	* Ported to 834x by Randy Vinson <rvinson@mvista.com> using code provided
	* by Hunter Wu.
	*/

	#include <linux/platform_device.h>
	#include <linux/fsl_devices.h>

	#include "ehci-fsl.h"

	/* FIXME: Power Managment is un-ported so temporarily disable it */
	#undef CONFIG_PM

	/* PCI-based HCs are common, but plenty of non-PCI HCs are used too */

	/* configure so an HC device and id are always provided */
	/* always called with process context; sleeping is OK */

	/**
	* usb_hcd_fsl_probe - initialize FSL-based HCDs
	* @drvier: Driver to be used for this HCD
	* @pdev: USB Host Controller being probed
	* Context: !in_interrupt()
	*
	* Allocates basic resources for this USB host controller.
	*
	*/
	int usb_hcd_fsl_probe(const struct hc_driver *driver,
	struct platform_device *pdev)
	{
	struct fsl_usb2_platform_data *pdata;
	struct usb_hcd *hcd;
	struct resource *res;
	int irq;
	int retval;
	unsigned int temp;

	pr_debug("initializing FSL-SOC USB Controller\n");

	/* Need platform data for setup */
	pdata = (struct fsl_usb2_platform_data *)pdev->dev.platform_data;
	if (!pdata) {
	dev_err(&pdev->dev,
	"No platform data for %s.\n", pdev->dev.bus_id);
	return -ENODEV;
	}

	/*
	* This is a host mode driver, verify that we're supposed to be
	* in host mode.
	*/
	if (!((pdata->operating_mode == FSL_USB2_DR_HOST) \|\|
	(pdata->operating_mode == FSL_USB2_MPH_HOST))) {
	dev_err(&pdev->dev,
	"Non Host Mode configured for %s. Wrong driver linked.\n",
	pdev->dev.bus_id);
	return -ENODEV;
	}

	res = platform_get_resource(pdev, IORESOURCE_IRQ, 0);
	if (!res) {
	dev_err(&pdev->dev,
	"Found HC with no IRQ. Check %s setup!\n",
	pdev->dev.bus_id);
	return -ENODEV;
	}
	irq = res->start;

	hcd = usb_create_hcd(driver, &pdev->dev, pdev->dev.bus_id);
	if (!hcd) {
	retval = -ENOMEM;
	goto err1;
	}

	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
	if (!res) {
	dev_err(&pdev->dev,
	"Found HC with no register addr. Check %s setup!\n",
	pdev->dev.bus_id);
	retval = -ENODEV;
	goto err2;
	}
	hcd->rsrc_start = res->start;
	hcd->rsrc_len = res->end - res->start + 1;
	if (!request_mem_region(hcd->rsrc_start, hcd->rsrc_len,
	driver->description)) {
	dev_dbg(&pdev->dev, "controller already in use\n");
	retval = -EBUSY;
	goto err2;
	}
	hcd->regs = ioremap(hcd->rsrc_start, hcd->rsrc_len);

	if (hcd->regs == NULL) {
	dev_dbg(&pdev->dev, "error mapping memory\n");
	retval = -EFAULT;
	goto err3;
	}

	/* Enable USB controller */
	temp = in_be32(hcd->regs + 0x500);
	out_be32(hcd->regs + 0x500, temp \| 0x4);

	/* Set to Host mode */
	temp = in_le32(hcd->regs + 0x1a8);
	out_le32(hcd->regs + 0x1a8, temp \| 0x3);

	retval = usb_add_hcd(hcd, irq, SA_SHIRQ);
	if (retval != 0)
	goto err4;
	return retval;

	err4:
	iounmap(hcd->regs);
	err3:
	release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
	err2:
	usb_put_hcd(hcd);
	err1:
	dev_err(&pdev->dev, "init %s fail, %d\n", pdev->dev.bus_id, retval);
	return retval;
	}

	/* may be called without controller electrically present */
	/* may be called with controller, bus, and devices active */

	/**
	* usb_hcd_fsl_remove - shutdown processing for FSL-based HCDs
	* @dev: USB Host Controller being removed
	* Context: !in_interrupt()
	*
	* Reverses the effect of usb_hcd_fsl_probe().
	*
	*/
	void usb_hcd_fsl_remove(struct usb_hcd hcd, struct platform_device pdev)
	{
	usb_remove_hcd(hcd);
	iounmap(hcd->regs);
	release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
	usb_put_hcd(hcd);
	}

	static void mpc83xx_setup_phy(struct ehci_hcd *ehci,
	enum fsl_usb2_phy_modes phy_mode,
	unsigned int port_offset)
	{
	u32 portsc = 0;
	switch (phy_mode) {
	case FSL_USB2_PHY_ULPI:
	portsc \|= PORT_PTS_ULPI;
	break;
	case FSL_USB2_PHY_SERIAL:
	portsc \|= PORT_PTS_SERIAL;
	break;
	case FSL_USB2_PHY_UTMI_WIDE:
	portsc \|= PORT_PTS_PTW;
	/* fall through */
	case FSL_USB2_PHY_UTMI:
	portsc \|= PORT_PTS_UTMI;
	break;
	case FSL_USB2_PHY_NONE:
	break;
	}
	writel(portsc, &ehci->regs->port_status[port_offset]);
	}

	static void mpc83xx_usb_setup(struct usb_hcd *hcd)
	{
	struct ehci_hcd *ehci = hcd_to_ehci(hcd);
	struct fsl_usb2_platform_data *pdata;
	void __iomem *non_ehci = hcd->regs;

	pdata =
	(struct fsl_usb2_platform_data *)hcd->self.controller->
	platform_data;
	/* Enable PHY interface in the control reg. */
	out_be32(non_ehci + FSL_SOC_USB_CTRL, 0x00000004);
	out_be32(non_ehci + FSL_SOC_USB_SNOOP1, 0x0000001b);

	if (pdata->operating_mode == FSL_USB2_DR_HOST)
	mpc83xx_setup_phy(ehci, pdata->phy_mode, 0);

	if (pdata->operating_mode == FSL_USB2_MPH_HOST) {
	unsigned int chip, rev, svr;

	svr = mfspr(SPRN_SVR);
	chip = svr >> 16;
	rev = (svr >> 4) & 0xf;

	/* Deal with USB Erratum #14 on MPC834x Rev 1.0 & 1.1 chips */
	if ((rev == 1) && (chip >= 0x8050) && (chip <= 0x8055))
	ehci->has_fsl_port_bug = 1;

	if (pdata->port_enables & FSL_USB2_PORT0_ENABLED)
	mpc83xx_setup_phy(ehci, pdata->phy_mode, 0);
	if (pdata->port_enables & FSL_USB2_PORT1_ENABLED)
	mpc83xx_setup_phy(ehci, pdata->phy_mode, 1);
	}

	/* put controller in host mode. */
	writel(0x00000003, non_ehci + FSL_SOC_USB_USBMODE);
	out_be32(non_ehci + FSL_SOC_USB_PRICTRL, 0x0000000c);
	out_be32(non_ehci + FSL_SOC_USB_AGECNTTHRSH, 0x00000040);
	out_be32(non_ehci + FSL_SOC_USB_SICTRL, 0x00000001);
	}

	/* called after powerup, by probe or system-pm "wakeup" */
	static int ehci_fsl_reinit(struct ehci_hcd *ehci)
	{
	mpc83xx_usb_setup(ehci_to_hcd(ehci));
	ehci_port_power(ehci, 0);

	return 0;
	}

	/* called during probe() after chip reset completes */
	static int ehci_fsl_setup(struct usb_hcd *hcd)
	{
	struct ehci_hcd *ehci = hcd_to_ehci(hcd);
	int retval;

	/* EHCI registers start at offset 0x100 */
	ehci->caps = hcd->regs + 0x100;
	ehci->regs = hcd->regs + 0x100 +
	HC_LENGTH(readl(&ehci->caps->hc_capbase));
	dbg_hcs_params(ehci, "reset");
	dbg_hcc_params(ehci, "reset");

	/* cache this readonly data; minimize chip reads */
	ehci->hcs_params = readl(&ehci->caps->hcs_params);

	retval = ehci_halt(ehci);
	if (retval)
	return retval;

	/* data structure init */
	retval = ehci_init(hcd);
	if (retval)
	return retval;

	ehci->is_tdi_rh_tt = 1;

	ehci->sbrn = 0x20;

	ehci_reset(ehci);

	retval = ehci_fsl_reinit(ehci);
	return retval;
	}

	static const struct hc_driver ehci_fsl_hc_driver = {
	.description = hcd_name,
	.product_desc = "Freescale On-Chip EHCI Host Controller",
	.hcd_priv_size = sizeof(struct ehci_hcd),

	/*
	* generic hardware linkage
	*/
	.irq = ehci_irq,
	.flags = HCD_USB2,

	/*
	* basic lifecycle operations
	*/
	.reset = ehci_fsl_setup,
	.start = ehci_run,
	#ifdef CONFIG_PM
	.suspend = ehci_bus_suspend,
	.resume = ehci_bus_resume,
	#endif
	.stop = ehci_stop,

	/*
	* managing i/o requests and associated device resources
	*/
	.urb_enqueue = ehci_urb_enqueue,
	.urb_dequeue = ehci_urb_dequeue,
	.endpoint_disable = ehci_endpoint_disable,

	/*
	* scheduling support
	*/
	.get_frame_number = ehci_get_frame,

	/*
	* root hub support
	*/
	.hub_status_data = ehci_hub_status_data,
	.hub_control = ehci_hub_control,
	.bus_suspend = ehci_bus_suspend,
	.bus_resume = ehci_bus_resume,
	};

	static int ehci_fsl_drv_probe(struct platform_device *pdev)
	{
	if (usb_disabled())
	return -ENODEV;

	return usb_hcd_fsl_probe(&ehci_fsl_hc_driver, pdev);
	}

	static int ehci_fsl_drv_remove(struct platform_device *pdev)
	{
	struct usb_hcd *hcd = platform_get_drvdata(pdev);

	usb_hcd_fsl_remove(hcd, pdev);

	return 0;
	}

	static struct platform_driver ehci_fsl_dr_driver = {
	.probe = ehci_fsl_drv_probe,
	.remove = ehci_fsl_drv_remove,
	.driver = {
	.name = "fsl-usb2-dr",
	},
	};

	static struct platform_driver ehci_fsl_mph_driver = {
	.probe = ehci_fsl_drv_probe,
	.remove = ehci_fsl_drv_remove,
	.driver = {
	.name = "fsl-usb2-mph",
	},
	};

	static int __init ehci_fsl_init(void)
	{
	int retval;

	pr_debug("%s: block sizes: qh %Zd qtd %Zd itd %Zd sitd %Zd\n",
	hcd_name,
	sizeof(struct ehci_qh), sizeof(struct ehci_qtd),
	sizeof(struct ehci_itd), sizeof(struct ehci_sitd));

	retval = platform_driver_register(&ehci_fsl_dr_driver);
	if (retval)
	return retval;

	return platform_driver_register(&ehci_fsl_mph_driver);
	}

	static void __exit ehci_fsl_cleanup(void)
	{
	platform_driver_unregister(&ehci_fsl_mph_driver);
	platform_driver_unregister(&ehci_fsl_dr_driver);
	}

	module_init(ehci_fsl_init);
	module_exit(ehci_fsl_cleanup);