2008-08-12 04:44:35 +00:00
|
|
|
/* packet-i2c.c
|
|
|
|
* Routines for I2C captures (using libpcap extensions)
|
|
|
|
*
|
|
|
|
* Pigeon Point Systems <www.pigeonpoint.com>
|
|
|
|
*
|
|
|
|
* $Id$
|
|
|
|
*
|
2009-04-08 13:07:21 +00:00
|
|
|
* Wireshark - Network traffic analyzer
|
|
|
|
* By Gerald Combs <gerald@wireshark.org>
|
2008-08-12 04:44:35 +00:00
|
|
|
* Copyright 1998 Gerald Combs
|
|
|
|
*
|
|
|
|
* 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
|
2013-04-14 18:55:28 +00:00
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
2008-08-12 04:44:35 +00:00
|
|
|
*/
|
|
|
|
|
2012-09-20 02:03:38 +00:00
|
|
|
#include "config.h"
|
2008-08-12 04:44:35 +00:00
|
|
|
|
|
|
|
#include <glib.h>
|
|
|
|
#include <epan/packet.h>
|
|
|
|
#include <epan/prefs.h>
|
|
|
|
|
|
|
|
#include "packet-i2c.h"
|
2012-02-24 07:57:48 +00:00
|
|
|
#include "packet-hdcp.h"
|
2008-08-12 04:44:35 +00:00
|
|
|
|
|
|
|
static int proto_i2c = -1;
|
|
|
|
|
|
|
|
static int hf_i2c_bus = -1;
|
|
|
|
static int hf_i2c_event = -1;
|
|
|
|
static int hf_i2c_flags = -1;
|
|
|
|
static int hf_i2c_addr = -1;
|
|
|
|
|
|
|
|
static gint ett_i2c = -1;
|
|
|
|
|
|
|
|
enum {
|
|
|
|
SUB_DATA = 0,
|
|
|
|
SUB_IPMB,
|
2012-02-24 07:57:48 +00:00
|
|
|
SUB_HDCP,
|
2008-08-12 04:44:35 +00:00
|
|
|
|
|
|
|
SUB_MAX
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef gboolean (*sub_checkfunc_t)(packet_info *);
|
|
|
|
|
|
|
|
static dissector_handle_t sub_handles[SUB_MAX];
|
|
|
|
static gint sub_selected = SUB_IPMB;
|
|
|
|
|
|
|
|
/* I2C packet flags. */
|
|
|
|
#define I2C_FLAG_RD 0x00000001
|
|
|
|
#define I2C_FLAG_TEN 0x00000010
|
|
|
|
#define I2C_FLAG_REV_DIR_ADDR 0x00002000
|
|
|
|
#define I2C_FLAG_NOSTART 0x00004000
|
|
|
|
|
|
|
|
/* I2C events. */
|
|
|
|
#define I2C_EVENT_PROM_ON (1 << 0) /* Promiscuous mode: on */
|
|
|
|
#define I2C_EVENT_PROM_OFF (1 << 1) /* Promiscuous mode: off */
|
|
|
|
#define I2C_EVENT_ONLINE_ON (1 << 2) /* Online state: on */
|
|
|
|
#define I2C_EVENT_ONLINE_OFF (1 << 3) /* Online state: off */
|
|
|
|
#define I2C_EVENT_ATTACHED_ON (1 << 4) /* Attached state: on */
|
|
|
|
#define I2C_EVENT_ATTACHED_OFF (1 << 5) /* Attached state: off */
|
|
|
|
#define I2C_EVENT_PROM_OVFL_ON (1 << 6) /* Prom. queue overflow: on */
|
|
|
|
#define I2C_EVENT_PROM_OVFL_OFF (1 << 7) /* Prom. queue overflow: off */
|
|
|
|
#define I2C_EVENT_OVFL_ON (1 << 8) /* Queue overflow: on */
|
|
|
|
#define I2C_EVENT_OVFL_OFF (1 << 9) /* Queue overflow: off */
|
|
|
|
|
|
|
|
/* I2C errors. */
|
|
|
|
#define I2C_EVENT_ERR_DATA_LO (1 << 16) /* Unable to drive data LO */
|
|
|
|
#define I2C_EVENT_ERR_DATA_HI (1 << 17) /* Unable to drive data HI */
|
|
|
|
#define I2C_EVENT_ERR_CLOCK_LO (1 << 18) /* Unable to drive clock LO */
|
|
|
|
#define I2C_EVENT_ERR_CLOCK_HI (1 << 19) /* Unable to drive clock HI */
|
|
|
|
#define I2C_EVENT_ERR_CLOCK_TO (1 << 20) /* Clock low timeout */
|
|
|
|
#define I2C_EVENT_ERR_PHYS (1 << 21) /* The I2C bus controller
|
|
|
|
has been physically
|
|
|
|
disconnected from the bus */
|
|
|
|
#define I2C_EVENT_ERR_FAIL (1 << 22) /* Undiagnosed failure */
|
|
|
|
|
|
|
|
void
|
|
|
|
capture_i2c(union wtap_pseudo_header *pseudo_header, packet_counts *ld)
|
|
|
|
{
|
|
|
|
if (pseudo_header->i2c.is_event) {
|
|
|
|
ld->i2c_event++;
|
|
|
|
} else {
|
|
|
|
ld->i2c_data++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static const char *
|
|
|
|
i2c_get_event_desc(int event)
|
|
|
|
{
|
|
|
|
const char *desc;
|
|
|
|
|
|
|
|
switch (event & 0x0000ffff) {
|
|
|
|
case I2C_EVENT_PROM_ON:
|
|
|
|
desc = "Promiscuous mode is enabled";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_PROM_OFF:
|
|
|
|
desc = "Promiscuous mode is disabled";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_ONLINE_ON:
|
|
|
|
desc = "The I2C controller is operational";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_ONLINE_OFF:
|
|
|
|
desc = "The I2C controller is non-operational";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_ATTACHED_ON:
|
|
|
|
desc = "The I2C controller is attached to an I2C bus";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_ATTACHED_OFF:
|
|
|
|
desc = "The I2C controller is detached from an I2C bus";
|
|
|
|
if (event & I2C_EVENT_ERR_DATA_LO) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"unable to drive data LO";
|
|
|
|
} else if (event & I2C_EVENT_ERR_DATA_HI) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"unable to drive data HI";
|
|
|
|
} else if (event & I2C_EVENT_ERR_CLOCK_LO) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"unable to drive clock LO";
|
|
|
|
} else if (event & I2C_EVENT_ERR_CLOCK_HI) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"unable to drive clock HI";
|
|
|
|
} else if (event & I2C_EVENT_ERR_CLOCK_TO) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"clock low timeout";
|
|
|
|
} else if (event & I2C_EVENT_ERR_PHYS) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"the I2C bus controller has been physically "
|
|
|
|
"disconnected from the bus";
|
|
|
|
} else if (event & I2C_EVENT_ERR_FAIL) {
|
|
|
|
desc = "The I2C controller is detached from an I2C bus: "
|
|
|
|
"undiagnosed failure";
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_PROM_OVFL_ON:
|
|
|
|
desc = "The incoming promiscuous data buffer has been overrun; "
|
|
|
|
"some data is lost";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_PROM_OVFL_OFF:
|
|
|
|
desc = "The incoming promiscuous data buffer is available";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_OVFL_ON:
|
|
|
|
desc = "The incoming I2C data buffer has been overrun; "
|
|
|
|
"some data is lost";
|
|
|
|
break;
|
|
|
|
case I2C_EVENT_OVFL_OFF:
|
|
|
|
desc = "The incoming I2C data buffer is available";
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
desc = "<unknown state event>";
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
return desc;
|
|
|
|
}
|
|
|
|
|
|
|
|
static gboolean
|
|
|
|
sub_check_ipmb(packet_info *pinfo)
|
|
|
|
{
|
|
|
|
if (pinfo->pseudo_header->i2c.flags & I2C_FLAG_RD) {
|
|
|
|
/* Master-receive transactions are not possible on IPMB */
|
|
|
|
return FALSE;
|
|
|
|
}
|
|
|
|
|
|
|
|
return TRUE;
|
|
|
|
}
|
|
|
|
|
|
|
|
static sub_checkfunc_t sub_check[SUB_MAX] = {
|
|
|
|
NULL, /* raw data */
|
2012-02-24 07:57:48 +00:00
|
|
|
sub_check_ipmb, /* IPMI */
|
|
|
|
sub_check_hdcp /* HDCP */
|
2008-08-12 04:44:35 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
static void
|
|
|
|
dissect_i2c(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
|
|
|
|
{
|
|
|
|
proto_item *ti;
|
|
|
|
proto_tree *i2c_tree = NULL;
|
|
|
|
int is_event, bus, flags, addr, len;
|
|
|
|
|
|
|
|
is_event = pinfo->pseudo_header->i2c.is_event;
|
|
|
|
flags = pinfo->pseudo_header->i2c.flags;
|
|
|
|
bus = pinfo->pseudo_header->i2c.bus;
|
|
|
|
len = tvb_length(tvb);
|
|
|
|
if (is_event) {
|
|
|
|
addr = 0;
|
|
|
|
} else {
|
|
|
|
if (len == 0) {
|
|
|
|
THROW(ReportedBoundsError);
|
|
|
|
}
|
|
|
|
/* Report 7-bit hardware address */
|
|
|
|
addr = tvb_get_guint8(tvb, 0) >> 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
pinfo->ptype = PT_I2C;
|
|
|
|
|
|
|
|
if (check_col(pinfo->cinfo, COL_PROTOCOL)) {
|
|
|
|
if (is_event)
|
2009-09-23 14:43:23 +00:00
|
|
|
col_set_str(pinfo->cinfo, COL_PROTOCOL, "I2C Event");
|
2008-08-12 04:44:35 +00:00
|
|
|
else
|
|
|
|
col_add_fstr(pinfo->cinfo, COL_PROTOCOL, "I2C %s",
|
|
|
|
(flags & I2C_FLAG_RD) ? "Read" : "Write");
|
|
|
|
}
|
|
|
|
|
|
|
|
if (check_col(pinfo->cinfo, COL_DEF_SRC)) {
|
|
|
|
col_add_fstr(pinfo->cinfo, COL_DEF_SRC, "I2C-%d", bus);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (check_col(pinfo->cinfo, COL_DEF_DST)) {
|
|
|
|
if (is_event)
|
|
|
|
col_add_fstr(pinfo->cinfo, COL_DEF_DST, "----");
|
|
|
|
else
|
|
|
|
col_add_fstr(pinfo->cinfo, COL_DEF_DST, "0x%02x", addr);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (check_col(pinfo->cinfo, COL_INFO)) {
|
|
|
|
if (is_event)
|
|
|
|
col_add_fstr(pinfo->cinfo, COL_INFO, "%s",
|
|
|
|
i2c_get_event_desc(flags));
|
|
|
|
else
|
|
|
|
col_add_fstr(pinfo->cinfo, COL_INFO, "I2C %s, %d bytes",
|
|
|
|
(flags & I2C_FLAG_RD) ? "Read" : "Write", len);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (tree) {
|
|
|
|
ti = proto_tree_add_protocol_format(tree, proto_i2c, tvb, 0, -1,
|
|
|
|
"Inter-Integrated Circuit (%s)",
|
|
|
|
is_event ? "Event" : "Data");
|
|
|
|
|
|
|
|
i2c_tree = proto_item_add_subtree(ti, ett_i2c);
|
|
|
|
proto_tree_add_uint_format(i2c_tree, hf_i2c_bus, tvb, 0, 0, bus,
|
|
|
|
"Bus: I2C-%d", bus);
|
|
|
|
|
|
|
|
if (is_event) {
|
|
|
|
proto_tree_add_uint_format(i2c_tree, hf_i2c_event, tvb, 0, 0,
|
|
|
|
flags, "Event: %s (0x%08x)",
|
|
|
|
i2c_get_event_desc(flags), flags);
|
|
|
|
} else {
|
|
|
|
proto_tree_add_uint_format_value(i2c_tree, hf_i2c_addr, tvb, 0, 1,
|
|
|
|
addr, "0x%02x%s", addr, addr ? "" : " (General Call)");
|
|
|
|
proto_tree_add_uint_format(i2c_tree, hf_i2c_flags, tvb, 0, 0,
|
|
|
|
flags, "Flags: 0x%08x", flags);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!is_event) {
|
2012-02-03 17:30:55 +00:00
|
|
|
if (sub_check[sub_selected] && sub_check[sub_selected](pinfo)) {
|
2008-08-12 04:44:35 +00:00
|
|
|
call_dissector(sub_handles[sub_selected], tvb, pinfo, tree);
|
|
|
|
} else {
|
|
|
|
call_dissector(sub_handles[SUB_DATA], tvb, pinfo, tree);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
proto_register_i2c(void)
|
|
|
|
{
|
|
|
|
static hf_register_info hf[] = {
|
From Kovarththanan Rajaratnam via bug 3548:
(1) Trailing/leading spaces are removed from 'name's/'blurb's
(2) Duplicate 'blurb's are replaced with NULL
(3) Empty ("") 'blurb's are replaced with NULL
(4) BASE_NONE, NULL, 0x0 are used for 'display', 'strings' and 'bitmask' fields
for FT_NONE, FT_BYTES, FT_IPv4, FT_IPv6, FT_ABSOLUTE_TIME, FT_RELATIVE_TIME,
FT_PROTOCOL, FT_STRING and FT_STRINGZ field types
(5) Only allow non-zero value for 'display' if 'bitmask' is non-zero
svn path=/trunk/; revision=28770
2009-06-18 21:30:42 +00:00
|
|
|
{ &hf_i2c_bus, { "Bus ID", "i2c.bus", FT_UINT8, BASE_DEC, NULL, 0, NULL, HFILL }},
|
|
|
|
{ &hf_i2c_addr, { "Target address", "i2c.addr", FT_UINT8, BASE_HEX, NULL, 0, NULL, HFILL }},
|
|
|
|
{ &hf_i2c_event, { "Event", "i2c.event", FT_UINT32, BASE_HEX, NULL, 0, NULL, HFILL }},
|
|
|
|
{ &hf_i2c_flags, { "Flags", "i2c.flags", FT_UINT32, BASE_HEX, NULL, 0, NULL, HFILL }},
|
2008-08-12 04:44:35 +00:00
|
|
|
};
|
|
|
|
static gint *ett[] = {
|
|
|
|
&ett_i2c
|
|
|
|
};
|
|
|
|
static const enum_val_t sub_enum_vals[] = {
|
|
|
|
{ "none", "None (raw I2C)", SUB_DATA },
|
|
|
|
{ "ipmb", "IPMB", SUB_IPMB },
|
2012-02-24 07:57:48 +00:00
|
|
|
{ "hdcp", "HDCP", SUB_HDCP },
|
2008-08-12 04:44:35 +00:00
|
|
|
{ NULL, NULL, 0 }
|
|
|
|
};
|
|
|
|
module_t *m;
|
|
|
|
|
|
|
|
proto_i2c = proto_register_protocol("Inter-Integrated Circuit", "I2C", "i2c");
|
|
|
|
proto_register_field_array(proto_i2c, hf, array_length(hf));
|
|
|
|
proto_register_subtree_array(ett, array_length(ett));
|
|
|
|
|
|
|
|
m = prefs_register_protocol(proto_i2c, NULL);
|
2012-02-24 07:57:48 +00:00
|
|
|
prefs_register_enum_preference(m, "type", "Bus/Data type",
|
|
|
|
"How the I2C messages are interpreted",
|
2008-08-12 04:44:35 +00:00
|
|
|
&sub_selected, sub_enum_vals, FALSE);
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
proto_reg_handoff_i2c(void)
|
|
|
|
{
|
2008-09-26 22:07:45 +00:00
|
|
|
dissector_handle_t i2c_handle;
|
|
|
|
|
|
|
|
sub_handles[SUB_DATA] = find_dissector("data");
|
|
|
|
sub_handles[SUB_IPMB] = find_dissector("ipmi");
|
2012-02-24 07:57:48 +00:00
|
|
|
sub_handles[SUB_HDCP] = find_dissector("hdcp");
|
2008-09-26 22:07:45 +00:00
|
|
|
i2c_handle = create_dissector_handle(dissect_i2c, proto_i2c);
|
2010-12-20 05:35:29 +00:00
|
|
|
dissector_add_uint("wtap_encap", WTAP_ENCAP_I2C, i2c_handle);
|
2008-08-12 04:44:35 +00:00
|
|
|
}
|