Switchtec Userspace PROJECT_NUMBER = 4.4
Loading...
Searching...
No Matches
platform.c
Go to the documentation of this file.
1/*
2 * Microsemi Switchtec(tm) PCIe Management Library
3 * Copyright (c) 2017, Microsemi Corporation
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice shall be included
13 * in all copies or substantial portions of the Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
16 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
19 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21 * OTHER DEALINGS IN THE SOFTWARE.
22 *
23 */
24
29
30#include "../switchtec_priv.h"
31#include "switchtec/switchtec.h"
32#include "switchtec/gas.h"
33#include "switchtec/gas_mrpc.h"
34#include "switchtec/errors.h"
35
36#include <string.h>
37#include <errno.h>
38
45struct switchtec_dev *switchtec_open_by_path(const char *path);
46
56struct switchtec_dev *switchtec_open_by_index(int index);
57
67struct switchtec_dev *switchtec_open_by_pci_addr(int domain, int bus,
68 int device, int func);
69
77struct switchtec_dev *switchtec_open_i2c(const char *path, int i2c_addr);
78
85struct switchtec_dev *switchtec_open_uart(int fd);
86
94struct switchtec_dev *switchtec_open_eth(const char *ip, const int inst);
95
101void switchtec_close(struct switchtec_dev *dev)
102{
103 if (!dev)
104 return;
105
106 dev->ops->close(dev);
107}
108
117
125int switchtec_get_fw_version(struct switchtec_dev *dev, char *buf,
126 size_t buflen)
127{
128 struct switchtec_fw_part_summary *sum;
129 struct switchtec_fw_image_info *running_img;
130
131 sum = switchtec_fw_part_summary(dev);
132 if (!sum)
133 return -1;
134
135 if (sum->img.active && sum->img.active->running) {
136 running_img = sum->img.active;
137 } else if (sum->img.inactive && sum->img.inactive->running) {
138 running_img = sum->img.inactive;
139 } else {
141 errno = EIO;
142 return -1;
143 }
144
145 strncpy(buf, running_img->version, buflen);
146 buf[buflen - 1] = '\0';
147
149
150 return 0;
151}
152
159int switchtec_get_device_version(struct switchtec_dev *dev, int *res)
160{
161 if (!dev->ops->get_device_version)
162 return 0;
163
164 return dev->ops->get_device_version(dev, res);
165}
166
178int switchtec_cmd(struct switchtec_dev *dev, uint32_t cmd,
179 const void *payload, size_t payload_len, void *resp,
180 size_t resp_len)
181{
182 int ret;
183
184 cmd &= SWITCHTEC_CMD_MASK;
185 if (!switchtec_is_gen6(dev))
186 cmd |= dev->pax_id << SWITCHTEC_PAX_ID_SHIFT;
187
188 ret = dev->ops->cmd(dev, cmd, payload, payload_len, resp, resp_len);
189 if (ret > 0) {
190 mrpc_error_cmd = cmd & SWITCHTEC_CMD_MASK;
191 errno |= SWITCHTEC_ERRNO_MRPC_FLAG_BIT;
192 }
193
194 return ret;
195}
196
209int switchtec_get_devices(struct switchtec_dev *dev,
210 struct switchtec_status *status,
211 int ports)
212{
213 if (!dev->ops->get_devices)
214 return 0;
215
216 return dev->ops->get_devices(dev, status, ports);
217}
218
228int switchtec_pff_to_port(struct switchtec_dev *dev, int pff,
229 int *partition, int *port)
230{
231 return dev->ops->pff_to_port(dev, pff, partition, port);
232}
233
243int switchtec_port_to_pff(struct switchtec_dev *dev, int partition,
244 int port, int *pff)
245{
246 return dev->ops->port_to_pff(dev, partition, port, pff);
247}
248
270gasptr_t switchtec_gas_map(struct switchtec_dev *dev, int writeable,
271 size_t *map_size)
272{
273 return dev->ops->gas_map(dev, writeable, map_size);
274}
275
282void switchtec_gas_unmap(struct switchtec_dev *dev, gasptr_t map)
283{
284 if (!dev->ops->gas_unmap)
285 return;
286
287 dev->ops->gas_unmap(dev, map);
288}
289
298int switchtec_flash_part(struct switchtec_dev *dev,
299 struct switchtec_fw_image_info *info,
300 enum switchtec_fw_image_part_id_gen3 part)
301{
302 return dev->ops->flash_part(dev, info, part);
303}
304
312int switchtec_event_summary(struct switchtec_dev *dev,
313 struct switchtec_event_summary *sum)
314{
315 return dev->ops->event_summary(dev, sum);
316}
317
328int switchtec_event_ctl(struct switchtec_dev *dev,
329 enum switchtec_event_id e,
330 int index, int flags,
331 uint32_t data[5])
332{
333 return dev->ops->event_ctl(dev, e, index, flags, data);
334}
335
344int switchtec_event_wait(struct switchtec_dev *dev, int timeout_ms)
345{
346 if (!dev->ops->event_wait) {
347 errno = ENOTSUP;
348 return -errno;
349 }
350
351 return dev->ops->event_wait(dev, timeout_ms);
352}
353
361int gas_read8(struct switchtec_dev *dev, uint8_t __gas *addr, uint8_t *val)
362{
363 if (dev->pax_id != dev->local_pax_id)
364 return gas_mrpc_read8(dev, addr, val);
365 else
366 *val = __gas_read8(dev, addr);
367
368 return 0;
369}
370
378int gas_read16(struct switchtec_dev *dev, uint16_t __gas *addr, uint16_t *val)
379{
380 if (dev->pax_id != dev->local_pax_id)
381 return gas_mrpc_read16(dev, addr, val);
382 else
383 *val = __gas_read16(dev, addr);
384
385 return 0;
386}
387
395int gas_read32(struct switchtec_dev *dev, uint32_t __gas *addr, uint32_t *val)
396{
397 if (dev->pax_id != dev->local_pax_id)
398 return gas_mrpc_read32(dev, addr, val);
399 else
400 *val = __gas_read32(dev, addr);
401
402 return 0;
403}
404
412int gas_read64(struct switchtec_dev *dev, uint64_t __gas *addr, uint64_t *val)
413{
414 if (dev->pax_id != dev->local_pax_id)
415 return gas_mrpc_read64(dev, addr, val);
416 else
417 *val = __gas_read64(dev, addr);
418
419 return 0;
420}
421
428void gas_write8(struct switchtec_dev *dev, uint8_t val, uint8_t __gas *addr)
429{
430 if (dev->pax_id != dev->local_pax_id)
431 gas_mrpc_write8(dev, val, addr);
432 else
433 __gas_write8(dev, val, addr);
434}
435
442void gas_write16(struct switchtec_dev *dev, uint16_t val, uint16_t __gas *addr)
443{
444 if (dev->pax_id != dev->local_pax_id)
445 gas_mrpc_write16(dev, val, addr);
446 else
447 __gas_write16(dev, val, addr);
448}
449
456void gas_write32(struct switchtec_dev *dev, uint32_t val, uint32_t __gas *addr)
457{
458 if (dev->pax_id != dev->local_pax_id)
459 gas_mrpc_write32(dev, val, addr);
460 else
461 __gas_write32(dev, val, addr);
462}
463
470void gas_write64(struct switchtec_dev *dev, uint64_t val, uint64_t __gas *addr)
471{
472 if (dev->pax_id != dev->local_pax_id)
473 gas_mrpc_write64(dev, val, addr);
474 else
475 __gas_write64(dev, val, addr);
476}
477
485void memcpy_to_gas(struct switchtec_dev *dev, void __gas *dest,
486 const void *src, size_t n)
487{
488 if (dev->pax_id != dev->local_pax_id)
489 gas_mrpc_memcpy_to_gas(dev, dest, src, n);
490 else
491 __memcpy_to_gas(dev, dest, src, n);
492}
493
502int memcpy_from_gas(struct switchtec_dev *dev, void *dest,
503 const void __gas *src, size_t n)
504{
505 if (dev->pax_id != dev->local_pax_id)
506 return gas_mrpc_memcpy_from_gas(dev, dest, src, n);
507 else
508 __memcpy_from_gas(dev, dest, src, n);
509
510 return 0;
511}
512
520ssize_t write_from_gas(struct switchtec_dev *dev, int fd,
521 const void __gas *src, size_t n)
522{
523 if (dev->pax_id != dev->local_pax_id)
524 return gas_mrpc_write_from_gas(dev, fd, src, n);
525 else
526 return __write_from_gas(dev, fd, src, n);
527}
GAS Accessor functions.
struct switchtec_dev * switchtec_open_uart(int fd)
Open a switchtec device behind a uart device.
int switchtec_list(struct switchtec_device_info **devlist)
List all the switchtec devices in the system.
struct switchtec_dev * switchtec_open_by_index(int index)
Open a switchtec device by index.
int switchtec_cmd(struct switchtec_dev *dev, uint32_t cmd, const void *payload, size_t payload_len, void *resp, size_t resp_len)
Execute an MRPC command.
Definition platform.c:178
void switchtec_close(struct switchtec_dev *dev)
Close a Switchtec device handle.
Definition platform.c:101
int mrpc_error_cmd
The MRPC command ID when errno is set.
Definition switchtec.c:736
struct switchtec_dev * switchtec_open_i2c(const char *path, int i2c_addr)
Open a switchtec device behind an I2C device.
struct switchtec_dev * switchtec_open_by_path(const char *path)
Open a switchtec device by path.
struct switchtec_dev * switchtec_open_eth(const char *ip, const int inst)
Open a switchtec device over ethernet.
int switchtec_get_devices(struct switchtec_dev *dev, struct switchtec_status *status, int ports)
Populate an already retrieved switchtec_status structure list with information about the devices plug...
Definition platform.c:209
int switchtec_get_device_version(struct switchtec_dev *dev, int *res)
Get the minor version number as a user readable int.
Definition platform.c:159
int switchtec_get_fw_version(struct switchtec_dev *dev, char *buf, size_t buflen)
Get the firmware version as a user readable string.
Definition platform.c:125
struct switchtec_dev * switchtec_open_by_pci_addr(int domain, int bus, int device, int func)
Open a switchtec device by PCI address (BDF).
int switchtec_event_ctl(struct switchtec_dev *dev, enum switchtec_event_id e, int index, int flags, uint32_t data[5])
Enable, disable and clear events or retrieve event data.
Definition platform.c:328
int switchtec_event_summary(struct switchtec_dev *dev, struct switchtec_event_summary *sum)
Retrieve a summary of all the events that have occurred in the switch.
Definition platform.c:312
int switchtec_event_wait(struct switchtec_dev *dev, int timeout_ms)
Wait for any event to occur (typically just an interrupt).
Definition platform.c:344
void switchtec_fw_part_summary_free(struct switchtec_fw_part_summary *summary)
Free a firmware part summary data structure.
Definition fw.c:2165
int switchtec_flash_part(struct switchtec_dev *dev, struct switchtec_fw_image_info *info, enum switchtec_fw_image_part_id_gen3 part)
Retrieve information about a flash partition.
Definition platform.c:298
void gas_mrpc_memcpy_to_gas(struct switchtec_dev *dev, void __gas *dest, const void *src, size_t n)
Copy data to the GAS using MRPC commands.
Definition gas_mrpc.c:59
int gas_mrpc_memcpy_from_gas(struct switchtec_dev *dev, void *dest, const void __gas *src, size_t n)
Copy data from the GAS using MRPC commands.
Definition gas_mrpc.c:94
ssize_t gas_mrpc_write_from_gas(struct switchtec_dev *dev, int fd, const void __gas *src, size_t n)
Call write() with data from the GAS using an MRPC command.
Definition gas_mrpc.c:131
void memcpy_to_gas(struct switchtec_dev *dev, void __gas *dest, const void *src, size_t n)
Copy data to the GAS.
Definition platform.c:485
ssize_t write_from_gas(struct switchtec_dev *dev, int fd, const void __gas *src, size_t n)
Call write() with data from the GAS.
Definition platform.c:520
gasptr_t switchtec_gas_map(struct switchtec_dev *dev, int writeable, size_t *map_size)
Map the GAS and return a pointer to access the gas.
Definition platform.c:270
void gas_write16(struct switchtec_dev *dev, uint16_t val, uint16_t __gas *addr)
Write a uint16_t to the GAS.
Definition platform.c:442
void switchtec_gas_unmap(struct switchtec_dev *dev, gasptr_t map)
Unmap the GAS region mapped with.
Definition platform.c:282
void gas_write64(struct switchtec_dev *dev, uint64_t val, uint64_t __gas *addr)
Write a uint64_t to the GAS.
Definition platform.c:470
void gas_write32(struct switchtec_dev *dev, uint32_t val, uint32_t __gas *addr)
Write a uint32_t to the GAS.
Definition platform.c:456
void gas_write8(struct switchtec_dev *dev, uint8_t val, uint8_t __gas *addr)
Write a uint8_t to the GAS.
Definition platform.c:428
int switchtec_port_to_pff(struct switchtec_dev *dev, int partition, int port, int *pff)
Convert a partition and port number to a port function index.
Definition platform.c:243
int switchtec_pff_to_port(struct switchtec_dev *dev, int pff, int *partition, int *port)
Convert a port function index to a partition and port number.
Definition platform.c:228
int gas_read32(struct switchtec_dev *dev, uint32_t __gas *addr, uint32_t *val)
Read a uint32_t from the GAS.
Definition platform.c:395
int gas_read16(struct switchtec_dev *dev, uint16_t __gas *addr, uint16_t *val)
Read a uint16_t from the GAS.
Definition platform.c:378
int memcpy_from_gas(struct switchtec_dev *dev, void *dest, const void __gas *src, size_t n)
Copy data from the GAS.
Definition platform.c:502
int gas_read8(struct switchtec_dev *dev, uint8_t __gas *addr, uint8_t *val)
Read a uint8_t from the GAS.
Definition platform.c:361
int gas_read64(struct switchtec_dev *dev, uint64_t __gas *addr, uint64_t *val)
Read a uint64_t from the GAS.
Definition platform.c:412
Represents a Switchtec device in the switchtec_list() function.
Definition switchtec.h:152
Event summary bitmaps.
Definition switchtec.h:343
Information about a firmware image or partition.
Definition switchtec.h:305
char version[32]
Firmware/Config version.
Definition switchtec.h:309
Port status structure.
Definition switchtec.h:181
Main Switchtec header.
switchtec_event_id
Enumeration of all possible events.
Definition switchtec.h:358
__gas struct switchtec_gas * gasptr_t
Shortform for a pointer to the GAS register space.
Definition switchtec.h:88
static int switchtec_is_gen6(struct switchtec_dev *dev)
Return whether a Switchtec device is a Gen 6 device.
Definition switchtec.h:524