11.1Sthorpej$NetBSD: i2c_calls,v 1.1 2025/09/21 17:54:16 thorpej Exp $
21.1Sthorpej
31.1Sthorpej/*-
41.1Sthorpej * Copyright (c) 2021 The NetBSD Foundation, Inc.
51.1Sthorpej * All rights reserved.
61.1Sthorpej *
71.1Sthorpej * This code is derived from software contributed to The NetBSD Foundation
81.1Sthorpej * by Jason R. Thorpe.
91.1Sthorpej *
101.1Sthorpej * Redistribution and use in source and binary forms, with or without
111.1Sthorpej * modification, are permitted provided that the following conditions
121.1Sthorpej * are met:
131.1Sthorpej * 1. Redistributions of source code must retain the above copyright
141.1Sthorpej *    notice, this list of conditions and the following disclaimer.
151.1Sthorpej * 2. Redistributions in binary form must reproduce the above copyright
161.1Sthorpej *    notice, this list of conditions and the following disclaimer in the
171.1Sthorpej *    documentation and/or other materials provided with the distribution.
181.1Sthorpej *
191.1Sthorpej * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
201.1Sthorpej * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
211.1Sthorpej * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
221.1Sthorpej * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
231.1Sthorpej * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
241.1Sthorpej * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
251.1Sthorpej * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
261.1Sthorpej * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
271.1Sthorpej * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
281.1Sthorpej * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
291.1Sthorpej * POSSIBILITY OF SUCH DAMAGE.
301.1Sthorpej */
311.1Sthorpej
321.1Sthorpej/*
331.1Sthorpej * Device calls used by the I2C subsystem.
341.1Sthorpej */
351.1Sthorpej
361.1Sthorpejsubsystem i2c;
371.1Sthorpej
381.1Sthorpej#include <dev/i2c/i2cvar.h>
391.1Sthorpej
401.1Sthorpej/*
411.1Sthorpej * i2c-enumerate-devices
421.1Sthorpej *
431.1Sthorpej * Enumerates the devices connected to the I2C bus, filling out
441.1Sthorpej * the i2c_attach_args and invoking the callback for each one.
451.1Sthorpej * The caller provides the storage for the i2c_attach_args.
461.1Sthorpej *
471.1Sthorpej * If the callback returns true, then enumeration continues.  If
481.1Sthorpej * the callback returns false, enumeration is stopped.
491.1Sthorpej *
501.1Sthorpej * Call returns 0 if successful, or an error code upon failure:
511.1Sthorpej *
521.1Sthorpej * ENOTSUP	The device handle implementation for the
531.1Sthorpej *		I2C bus does not support this device call.
541.1Sthorpej */
551.1Sthorpeji2c-enumerate-devices {
561.1Sthorpej	struct i2c_attach_args *ia;	/* IN */
571.1Sthorpej	bool (*callback)(device_t, struct i2c_enumerate_devices_args *);
581.1Sthorpej};
59