Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
MX25L(4)		     Kernel Interfaces Manual			MX25L(4)

NAME
     mx25l -- SpiFlash compatible non-volatile storage devices driver

SYNOPSIS
     device mx25l

     In loader.conf(5):
     mx25l_load="YES"

DESCRIPTION
     The  mx25l  driver  provides support for the family of non-volatile storage
     devices known collectively as SpiFlash(tm).  SpiFlash chips typically  have
     part numbers beginning with EN25, IS25, MX25, S25, SST25, or W25.

     The  mx25l  driver  uses opcode 0x9f to read the manufacturer and device ID
     data to determine whether the device is supported.  The device ID is looked
     up using a table of data within the driver which describes  the  attributes
     of  each  supported device, such as block size, sector size, and device ca-
     pacity.  When a supported device is found, the mx25l driver creates a  disk
     device  and makes it accessible at /dev/flash/spi?.  The new disk device is
     then tasted by the available geom(4) modules as with any disk device.

HARDWARE
     The mx25l driver supports the following spi flash memory devices:

     *	 AT25DF641
     *	 EN25F32
     *	 EN25P32
     *	 EN25P64
     *	 EN25Q32
     *	 EN25Q64
     *	 GD25Q64
     *	 M25P32
     *	 M25P64
     *	 MX25L1606E
     *	 MX25LL128
     *	 MX25LL256
     *	 MX25LL32
     *	 MX25LL64
     *	 N25Q64
     *	 S25FL032
     *	 S25FL064
     *	 S25FL128
     *	 S25FL256S
     *	 SST25VF010A
     *	 SST25VF032B
     *	 W25Q128
     *	 W25Q256
     *	 W25Q32
     *	 W25Q64
     *	 W25Q64BV
     *	 W25X32
     *	 W25X64

FDT CONFIGURATION
     On an fdt(4) based system, the mx25l device is defined as	a  slave  device
     subnode  of  the SPI bus controller node.	All properties documented in the
     spibus.txt bindings document can be used with the mx25l device.   The  most
     commonly-used ones are documented below.

     The following properties are required in the mx25l device subnode:

     compatible
	     Must be the string "jedec,spi-nor".

     reg     Chip select address of device.

     spi-max-frequency
	     The maximum bus frequency to use when communicating with this slave
	     device.   Actual bus speed may be lower, depending on the capabili-
	     ties of the SPI bus controller hardware.

     The following properties are optional for the mx25l device subnode:

     spi-cpha
	     Empty property indicating the slave device requires  shifted  clock
	     phase (CPHA) mode.

     spi-cpol
	     Empty  property  indicating the slave device requires inverse clock
	     polarity (CPOL) mode.

     spi-cs-high
	     Empty property indicating the slave device requires chip select ac-
	     tive high.

HINTS CONFIGURATION
     On a device.hints(5) based system, such as MIPS, these values  are  config-
     urable for mx25l:

     hint.mx25l.%d.at
	     The spibus the mx25l instance is attached to.

     hint.mx25l.%d.clock
	     The  maximum  bus frequency to use when communicating with this de-
	     vice.  Actual bus speed may be lower, depending on the capabilities
	     of the SPI bus controller hardware.

     hint.mx25l.%d.cs
	     The chip-select number to assert when performing I/O for  this  de-
	     vice.   Set the high bit (1 << 31) to invert the logic level of the
	     chip select line.

     hint.mx25l.%d.mode
	     The SPI mode (0-3) to use when communicating with this device.

FILES
     /dev/flash/spi?  Provides read/write access to the storage device.

SEE ALSO
     fdt(4), geom(4)

HISTORY
     The mx25l driver first appeared in FreeBSD 8.0.

FreeBSD ports 15.quarterly	November 11, 2025			MX25L(4)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mx25l&sektion=4&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help