Search help

Note: Searching from the top-level index page will search all documents. Searching from a specific document will search only that document.

Find an exact phrase: Wrap your search phrase in "" (double quotes) to only get results where the phrase is exactly matched. For example "PyTorch for the IPU" or "replicated tensor sharding"
Prefix query: Add an * (asterisk) at the end of any word to indicate a prefix query. This will return results containing all words with the specific prefix. For example tensor*

Fuzzy search: Use ~N (tilde followed by a number) at the end of any word for a fuzzy search. This will return results that are similar to the search word. N specifies the “edit distance” (fuzziness) of the match. For example Polibs~1
Words close to each other: ~N (tilde followed by a number) after a phrase (in quotes) returns results where the words are close to each other. N is the maximum number of positions allowed between matching words. For example "ipu version"~2
Logical operators. You can use the following logical operators in a search:
- + signifies AND operation
- | signifies OR operation
- - negates a single word or phrase (returns results without that word or phrase)
- () controls operator precedence

21. C2 PCIe Device IDs and channel map

The following information applies to C2 cards in a PCIe server. For IPU-Machine and IPU-POD systems, see the appropriate product documentation.

21.1. Device IDs

The diagram below shows how single IPUs and then, hierarchically, groups of IPUs are numbered in a 16-IPU system. For example, device ID 25 corresponds to the four IPUs numbered 0 to 3. These numbers are the IDs used by tools such as gc-info.

_images/id-mapping.png — Fig. 21.1 IPU device IDs

21.2. IPU-Link channel mapping

The diagram below shows the how channels connect between the cards in a system.

_images/channel_map.jpg — Fig. 21.2 IPU-Link card-to-card channel map

21.3. PCIe ID to slot mapping

The Graphcore tools typically deduce which IPU cards are in which PCIe slot via a table in the SMBIOS. Alternatively, a JSON configuration file may be provided by setting the environment variable GCDA_CONFIG_FILE. The file must have the following format:

{
  "ipu_card_mapping": [
   "0000:0f:00.0",
   "0000:0e:00.0",
   "0000:0d:00.0",
   "0000:0c:00.0",
   "0000:0b:00.0",
   "0000:0a:00.0",
   "0000:09:00.0",
   "0000:08:00.0",
   "0000:07:00.0",
   "0000:06:00.0",
   "0000:05:00.0",
   "0000:04:00.0",
   "0000:03:00.0",
   "0000:02:00.0",
   "0000:01:00.0",
   "0000:00:00.0"
  ]
}

Where “ipu_card_mapping” is an ordered list of the PCIe IDs for the Graphcore cards, from one side of the chassis to the next. Each pair of IDs should match a single card, and the next pair should be in the next physical slot.