The following example describes in detail how a Phytec PCM032 Board containing a mpc5200 and a FPGA is configured to be used with flink. The FPGA will contain a single channel PWM module and a single channel GPIO modul. flink was tested with the FPGA on the mpc5200io module as well as with an external FPGA connected through a SPI interface.

The pmc5200 offers a dedicated SPI (8 bit transfers) which can be routed onto the pins of the timer group or the PSC3 group. The PSC1, PSC2, PSC3 or PSC6 can operate as an SPI with 32 bit transfers.

• Configure the board with a working Linux kernel and root file system or use the system described in Installation von Emdebian Grip auf den Phytec phyCORE-MPC5200B. Make sure to have the SPI properly configured (enabled).
• Make sure that the device tree blob is up-to-date. It must contain a node for the hardware SPI (spi@f00) or a PSC-SPI (e.g. spi: psc@2000).
• Get necessary sources for the flink project.

  git clone https://github.com/flink-project/flinkvhdl.git
  git clone https://github.com/flink-project/flinklinux.git
  git clone https://github.com/flink-project/flinklib.git

Proceed as described in flink VHDL.

• In 5: add a block gpio and a block pwm to the system. Leave the standard values as they are except for the PWM module, whose base clock depends on your FPGA clock. Set unique_id of the gpio subdevice to 0x20 and the unique_id of the pwm subdevice to 0x30. Also add a spi_to_avalon module. Use SPI settings as given in the picture below.

  

  

  Adding an interface block
• In 6: set the unique id of the info subdevice to 0x10. Convert a chosen string into a digital value and enter this value in the field description. dev_size should be 0x1c0 for our configuration.
• After 10: the system should now look like:

  

  

  Complete system

Connect the FPGA with the SPI pins on the mpc5200.

There are several ways to properly drive the SPI from the mpc5200.

The hardware SPI and can be routed onto several different pin groups. The PSC-SPI needs configuring of the port configuration register. Our current UBoot does not yet fully suppport device tree configuration, it must be done manually. These actions could be done in a board initialization file. We prefer to put it directly into the mod_init function of the flink_spi driver. The code below sets to port configuration register so that one of the PSC's pin groups runs in SPI mode.

	// use these declarations for platform specific initialization
	static const struct of_device_id mpc52xx_gpio_simple[] = {
		{ .compatible = "fsl,mpc5200-gpio", },
		{}
	};
	struct mpc52xx_gpio __iomem *gpio;
	struct device_node *np;
	u32 portConfig;
	u8 pscNum = 2;	// set to 1,2,3 or 6

	// use in case a PSC serves as SPI
	// set port configuration register of mpc5200
	np = of_find_matching_node(NULL, mpc52xx_gpio_simple);
	gpio = of_iomap(np, 0);
	of_node_put(np);
	if (!gpio) {
		printk(KERN_ERR "%s() failed, expect abnormal behavior\n", __func__);
		return -1;
	}
	portConfig = in_be32(&gpio->port_config);
	#if defined(DBG)
		printk(KERN_DEBUG "[%s] Current port config = 0x%x\n", MODULE_NAME, portConfig);
	#endif
	if (pscNum == 6) {
		portConfig |=  0x00700060;	// PSC6 is Codec/SPI
	} else if (pscNum >= 1 && pscNum <= 3) {
		portConfig &= ~(7 << ((pscNum-1)*4));
		portConfig |=  6 << ((pscNum-1)*4);
	} else {
		printk(KERN_ERR "[%s] Wrong PSC number\n", MODULE_NAME);
		return -1;
	}
	out_be32(&gpio->port_config, portConfig);
	#if defined(DBG)
		printk(KERN_DEBUG "[%s] New port config = 0x%x\n", MODULE_NAME, portConfig);
	#endif
	iounmap(gpio);

Similarly you could configure the PSC3 group that the hardware SPI is output on the pins PSC3_6 .. PSC3_9. In our system this is already done by UBoot.

Compile kernel modules (see flink Linux Kernel Modules) and add them to your kernel image. Add a subnode flink_spi to your device tree under the node spi. In the compatible statement you must specify which protokoll driver to load (compatible = “flink_spi”). You can also specify the clock frequency. When booting the SPI-subsystem will automatically load a master driver (spi-mpc5200 or spi-mpc5200-psc) and the protokoll driver flink_spi.

When loading the driver manually add the following code to the mod_init function of the flink_spi driver.

	struct spi_master *master;
	struct spi_device *dev;
	master = spi_busnum_to_master(num);	// use bus number of master
	if (!master) {
		printk(KERN_ERR "[%s] No master for this bus number\n", MODULE_NAME);
		goto exit;
	}
	dev = spi_new_device(master, &flinkInfo);

num must correspond to your master bus number. This will be 32766 for the hardware SPI and 1,2,3 or 6 for the PSC-SPI. You have to specify driver data as follows.

static struct spi_board_info flinkInfo = {
		.modalias = "flink_spi",
		.max_speed_hz = 2000000,
		.mode = SPI_MODE_1
};

When working with a PSC-SPI you would configure it to run with truly 32 bit transfers. Add the following lines:

	dev = spi_new_device(master, &flinkInfo);
	dev->bits_per_word = 32;
	spi_setup(dev);

Finally, compile kernel modules (see flink Linux Kernel Modules), transfer them to the target and load them:

insmod flink.ko
insmod flink_spi.ko

As we specified an info subdevice we can ommit the memory length when loading flink_lpb.ko.

Compile the flink library (see flink Userspace Library) together with several test applications. Transfer the library and the test application to the target. Make sure that your library path includes the actual location of your library. Run test applications such as lsflink, flinkdio or flinkpwm.

• Configure the board with a working Linux kernel and root file system or use the system described in Installation von Emdebian Grip auf den Phytec phyCORE-MPC5200B
• Make sure that the device tree blob is up-to-date. It must contain a node for the FPGA sitting on the local plus bus.
• Get necessary sources for the flink project.

  git clone https://github.com/flink-project/flinkvhdl.git
  git clone https://github.com/flink-project/flinklinux.git
  git clone https://github.com/flink-project/flinklib.git

Proceed as described in flink VHDL.

• In 5: add a block gpio and a block pwm to the system. Also add a lpb_mpc5200b_to_avalon module. Leave the standard values as they are except for the PWM module, whose base clock should be 33000000. Set unique_id of the gpio subdevice to 0x20 and the unique_id of the pwm subdevice to 0x30

  

  

  Adding an interface block
• In 6: set the unique id of the info subdevice to 0x10. Convert a chosen string into a digital value and enter this value in the field description. dev_size should be 0x1c0 for our configuration.
• After 10: the system should now look like:

  

  

  Complete system
• In 15: assign the pins as follows:

The pins for the PWM output and the GPIO have to be assigned according to your hardware. The FPGA can be loaded through the onboard PROM or through serial loading from the processor, see Installation von Emdebian Grip auf den Phytec phyCORE-MPC5200B.

Compile the Linux kernel modules (flink Linux Kernel Modules), transfer them to the target and load them with

insmod flink.ko
insmod flink_lpb.ko

As we specified an info subdevice we can ommit the memory length when loading flink_lpb.ko.

This step is the same as described under using the SPI.