/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * USB HandSpring Visor driver
 *
 * Copyright (C) 1999 - 2003
 *     Greg Kroah-Hartman (greg@kroah.com)
 *
 * See Documentation/usb/usb-serial.rst for more information on using this
 * driver.
 *
 */

#ifndef __LINUX_USB_SERIAL_VISOR_H
#define __LINUX_USB_SERIAL_VISOR_H


#define HANDSPRING_VENDOR_ID  0x082d
#define HANDSPRING_VISOR_ID  0x0100
#define HANDSPRING_TREO_ID  0x0200
#define HANDSPRING_TREO600_ID  0x0300

#define PALM_VENDOR_ID   0x0830
#define PALM_M500_ID   0x0001
#define PALM_M505_ID   0x0002
#define PALM_M515_ID   0x0003
#define PALM_I705_ID   0x0020
#define PALM_M125_ID   0x0040
#define PALM_M130_ID   0x0050
#define PALM_TUNGSTEN_T_ID  0x0060
#define PALM_TREO_650   0x0061
#define PALM_TUNGSTEN_Z_ID  0x0031
#define PALM_ZIRE_ID   0x0070
#define PALM_M100_ID   0x0080

#define GSPDA_VENDOR_ID  0x115e
#define GSPDA_XPLORE_M68_ID  0xf100

#define SONY_VENDOR_ID   0x054C
#define SONY_CLIE_3_5_ID  0x0038
#define SONY_CLIE_4_0_ID  0x0066
#define SONY_CLIE_S360_ID  0x0095
#define SONY_CLIE_4_1_ID  0x009A
#define SONY_CLIE_NX60_ID  0x00DA
#define SONY_CLIE_NZ90V_ID  0x00E9
#define SONY_CLIE_UX50_ID  0x0144
#define SONY_CLIE_TJ25_ID  0x0169

#define ACER_VENDOR_ID   0x0502
#define ACER_S10_ID   0x0001

#define SAMSUNG_VENDOR_ID  0x04E8
#define SAMSUNG_SCH_I330_ID  0x8001
#define SAMSUNG_SPH_I500_ID  0x6601

#define TAPWAVE_VENDOR_ID  0x12EF
#define TAPWAVE_ZODIAC_ID  0x0100

#define GARMIN_VENDOR_ID  0x091E
#define GARMIN_IQUE_3600_ID  0x0004

#define ACEECA_VENDOR_ID  0x4766
#define ACEECA_MEZ1000_ID  0x0001

#define KYOCERA_VENDOR_ID  0x0C88
#define KYOCERA_7135_ID   0x0021

#define FOSSIL_VENDOR_ID  0x0E67
#define FOSSIL_ABACUS_ID  0x0002

/****************************************************************************
 * Handspring Visor Vendor specific request codes (bRequest values)
 * A big thank you to Handspring for providing the following information.
 * If anyone wants the original file where these values and structures came
 * from, send email to <greg@kroah.com>.
 ****************************************************************************/

/****************************************************************************
 * VISOR_REQUEST_BYTES_AVAILABLE asks the visor for the number of bytes that
 * are available to be transferred to the host for the specified endpoint.
 * Currently this is not used, and always returns 0x0001
 ****************************************************************************/
#define VISOR_REQUEST_BYTES_AVAILABLE  0x01

/****************************************************************************
 * VISOR_CLOSE_NOTIFICATION is set to the device to notify it that the host
 * is now closing the pipe. An empty packet is sent in response.
 ****************************************************************************/
#define VISOR_CLOSE_NOTIFICATION  0x02

/****************************************************************************
 * VISOR_GET_CONNECTION_INFORMATION is sent by the host during enumeration to
 * get the endpoints used by the connection.
 ****************************************************************************/
#define VISOR_GET_CONNECTION_INFORMATION 0x03


/****************************************************************************
 * VISOR_GET_CONNECTION_INFORMATION returns data in the following format
 ****************************************************************************/
struct visor_connection_info {
 __le16 num_ports;
 struct {
  __u8 port_function_id;
  __u8 port;
 } connections[2];
};


/* struct visor_connection_info.connection[x].port defines: */
#define VISOR_ENDPOINT_1  0x01
#define VISOR_ENDPOINT_2  0x02

/* struct visor_connection_info.connection[x].port_function_id defines: */
#define VISOR_FUNCTION_GENERIC  0x00
#define VISOR_FUNCTION_DEBUGGER  0x01
#define VISOR_FUNCTION_HOTSYNC  0x02
#define VISOR_FUNCTION_CONSOLE  0x03
#define VISOR_FUNCTION_REMOTE_FILE_SYS 0x04


/****************************************************************************
 * PALM_GET_SOME_UNKNOWN_INFORMATION is sent by the host during enumeration to
 * get some information from the M series devices, that is currently unknown.
 ****************************************************************************/
#define PALM_GET_EXT_CONNECTION_INFORMATION 0x04

/**
 * struct palm_ext_connection_info - return data from a PALM_GET_EXT_CONNECTION_INFORMATION request
 * @num_ports: maximum number of functions/connections in use
 * @endpoint_numbers_different: will be 1 if in and out endpoints numbers are
 * different, otherwise it is 0.  If value is 1, then
 * connections.end_point_info is non-zero.  If value is 0, then
 * connections.port contains the endpoint number, which is the same for in
 * and out.
 * @port_function_id: contains the creator id of the application that opened
 * this connection.
 * @port: contains the in/out endpoint number.  Is 0 if in and out endpoint
 * numbers are different.
 * @end_point_info: high nubbe is in endpoint and low nibble will indicate out
 * endpoint.  Is 0 if in and out endpoints are the same.
 *
 * The maximum number of connections currently supported is 2
 */
struct palm_ext_connection_info {
 __u8 num_ports;
 __u8 endpoint_numbers_different;
 __le16 reserved1;
 struct {
  __u32 port_function_id;
  __u8 port;
  __u8 end_point_info;
  __le16 reserved;
 } connections[2];
};

#endif