ISELED---the new choice of ambient lighting scheme

1.ISELED 介绍

1.1 前言

At present, the mainstream interior atmosphere lighting solutions are divided into two types,One is with automatic addressing functionLIN总线方案,Representative chips egELMOS的E521.31/E521.36,MelexisMLX81106/MLX81108,Indy coreIND83209/IND83211.一种是使用了ISELED技术的Smart RGB LED方案（将LED Driver&Controller和LEDs封装在一起）,On behalf of the chip is as bright as everseddLED 3.0系列,Hongkai OptoelectronicsiCLed系列等.The comparison of the two schemes is shown in the table below：

1.2 ISELED联盟

ISELEDThe Alliance is an open industrial alliance,The goal is to develop a ISELED A comprehensive ecosystem of technologies——A complete system solution for innovative automotive lighting.如今,Various types are available from several manufacturersISELED产品.

从2016年底（ISELED 成立时）最初的5个成员,The number of alliance members has increased to 30多家公司和机构.The members of the alliance are as follows,包含LED厂商,MCU厂商,Auto parts manufacturers, etc.

1.3 ISELED产品

ISELEDThe products on the official website are divided into the following categories：

• SMART DIGITAL LEDS
• LED Driver & Controller
• Microcontrollers
• ADK - Application & Development Kit

以上图为例,Briefly describe these products,

• INLC10AQ属于LED Driver & Controller,Mainly responsible for communication protocols and driversLED.Currently this part of the product is only availableInova能提供
• A3A-FKG-1400-1属于Smart Digital LEDs,可以认为是INLC10AQ和LED的结合体.At present, there are four companies that can provide this part of the product,They are all bright、Hongkai、Everlight and Osram,To do this kind of product need to findInova购买LED Driver & ControllerThen with your ownLED进行结合,最终变成Smart Digital LEDs.
• S32K属于ISELEDspecified by the host nodeMCU,NXP提供了基于S32K的ISELED驱动库,客户使用S32K可以很方便的和Smart Digital LEDsCommunicate and realize various lighting effects.At present, there are two main products that can be provided,除了NXP还有Microchip.
• ADKBelongs to the application and development kit,It is convenient for customers to quickly evaluateISELED方案.目前能提供ADK的主要是Inova和feno两家公司.

1.4 ISLED应用方向

ISELEDThere are currently three application directions,分别是：

• AMBIENT LIGHTING,环境照明,Such as the static atmosphere lights in the car.
• FUNCTIONAL LIGHTING,Functional lighting,If the hand is off the steering wheel, it will warn you.
• DYNAMIC LIGHTING EFFECTS,动态灯效,Such as the dynamic backlight of the instrument cluster.

2.ISELED DriverObtain and install

本篇文章主要介绍基于S32K144控制的ISELED方案试用,So you need to prepare firstS32K1的ISELED软件驱动.

S32K1xx的官方IDEIt is not included after installationISELED驱动的,需要从NXP官网下载对应的exe文件并选择IDEinstallation directory for overwriting installation,才能使用ISELED功能.下面介绍一下如何安装S32K1的ISELED驱动,在进行ISELEDIt is recommended to install it before installationS32DS 2.2,Please refer to the link below for the specific installation method：

S32 Design Studio for ARM 2.2 快速入门

2.1 ISELED Driver获取

1.Enter the following URL in your browser：https://www.nxp.com/design/designs/s32k-iseled-led-lighting-solution:S32K-ISELED）,and log inNXPThe personal account registered on the official website,如下图：

2.点击Design Resources,Move down toSofteware,能看到S32K SDK ISELED driver的下载选项,如下图：

3.点击下载按钮,Click on the jump interfacePrevious,能够看到RTM 4.0.0版本的ISELED驱动：

4.点击SW32K1-ISELED-RTM-4.0.0,Click Agree on the agreement interface that pops up,It will jump to the following interface,接着点击S32K1_ISELED_RTM_4.0.0.exe进行下载,建议ReleaseNotesDownload it too,里面包含了对SDK的要求;

5.下载的同时,点击License Keys,会跳出如下界面;

6.勾选复选框,点击Generate,弹出如下界面;

7.点击Save All按钮,会将license文件下载到本地.

2.2 ISELED Driver安装

2.2.1 安装前准备

Open the one mentioned in the previous chapterS32K1_ISELED_RTM_4.0.0_ReleaseNotes.pdf,可以看到ISELED RTM4.0.0The driver package is andS32K1xx的RTM3.0.0,RTM3.0.1, RTM3.0.2匹配的,所以安装ISELED驱动之前,Make sure to install it firstS32DS For ARM 2.2,This development environment comes with itS32K1xx的RTM3.0.0版本的SDK.

如果不了解S32DS 2.2如果安装,可以参考之前的文章：

S32 Design Studio for ARM 2.2 快速入门

2.2.2 安装注意事项

在S32DS for ARM 2.2安装好之后,双击S32K1_ISELED_RTM_4.0.0.exe进行安装,During the installation process, you need to load the previously savedlicensefile and selectionS32DS安装目录下的S32K1xx_RTM_3.0.0文件夹,如下面两张图：

2.2.3 安装后检查

安装完,可以检查下S32K1xx_RTM_3.0.0Whether the relevant folders in the folder existISELEDRelated documentation and library files.

3.ISELED方案试用

3.1 Demo方案介绍

由于手上没有ISELED的ADK,只能利用S32K144The development board plus a set sent by the previous customerISELEDLight board to build a demo kit,如下图所示：

整体的demo框图如下所示：

3.2 编写Demo程序

3.2.1 图形化界面配置

1.打开S32DS2.2,新建application工程,命名为S32K144EVB_ISELED_Demo_Test,并选择S32K144_SDK 3.0.0版本.

2.Wait until the interface is loaded,添加ISELED组件,如下图,Other components related to it are also added automatically.

3.打开ISELED组件,按下图配置,The relevant parameters will be described in detail in the following chapters.

4.打开timing_pal组件,使用lpit定时器的通道0.

5.Open the clock component,使能Flexio时钟.

至此,The GUI configuration is completed.

3.2.2 main函数编写

首先是clock,timing,iseled的初始化,如下所示：

int main(void)
{
    
  /* Write your local variable definition here */
	testInitType.crcEnable = 1;
	testInitType.firstLedAdr = 1;
	testInitType.tempCmpEnable = 0;
	testInitType.voltSwing = 0;
  /*** Processor Expert internal initialization. DON'T REMOVE THIS CODE!!! ***/
  #ifdef PEX_RTOS_INIT
    PEX_RTOS_INIT();                   /* Initialization of the selected RTOS. Macro is defined by the RTOS component. */
  #endif
  /*** End of Processor Expert internal initialization. ***/
  /* Write your code here */
  /* For example: for(;;) { } */
	CLOCK_SYS_Init(g_clockManConfigsArr, CLOCK_MANAGER_CONFIG_CNT, g_clockManCallbacksArr, CLOCK_MANAGER_CALLBACK_CNT);
	CLOCK_SYS_UpdateConfiguration(0U, CLOCK_MANAGER_POLICY_FORCIBLE);


	/*Initialize timing pal instance used by the ISELED Driver for the timeout mechanism*/
	TIMING_Init(&timing_pal1_instance, &timing_pal1_InitConfig);

	digLED_Init_Interface(NUMBER_OF_INTERFACES, iseled1_InitConfig);
	digLED_Init_Strip(&testInitType, &digLEDResultStrip1, strip);

其中,

• digLED_ReturnType digLED_Init_Interface(uint8_t nrOfInterfaces, const digLED_ConfigType *configStruct);主要是进行ISELED接口的配置,如选择Flexio还是SPI,Control how many waysISELED,Which pins to use,Peripheral timeout period,Use interrupts anywayDMA等.

• digLED_ReturnType digLED_Init_Strip(const digLED_InitType* ChainInitPtr, digLED_ReadDataResultType* ChainInitResultPtr, uint8_t StripNr);Mainly for a specific roadISELEDconfiguration of the communication protocol,As firstISELED的地址,是否进行CRC校验,Differential voltage amplitude,Whether to perform phase shift, etc.

然后调用digLED_ReturnType digLED_Set_RGB(uint8_t Red, uint8_t Green, uint8_t Blue, uint16_t Address, uint8_t StripNr);Realize lighting effects.其中Red,Green,BlueUsed to set the light colorRGB值,Addressrepresents what to setISELED芯片地址（0Represents set allISElED）,StripNrIndicates which way to setISELED.

For example, the code to set the red single flowing water effect is as follows：

void RunWaterRed(void)
 {
    
	  OSIF_TimeDelay(1);
	  digLED_Set_RGB(0       , 0       , 0       , 0, strip);
	  OSIF_TimeDelay(1);
	  uint8_t ledNr;
	  uint8_t r = 255, g = 0,  b = 0;
	  for(ledNr=1; ledNr<=NUM_OF_LED; ledNr++){
    
		  digLED_Set_RGB(r       , g       , b       , ledNr, strip);
		  OSIF_TimeDelay(100);
		  digLED_Set_RGB(0       , 0       , 0       , ledNr, strip);
		  OSIF_TimeDelay(1);
	  }
 }

3.2.3 Demo工程分享

The link to the entire project code is below：

• 链接：https://pan.baidu.com/s/1Bx5gTDurymVcxB1y-SSTwA
• 提取码：5bkl

3.3 Demo测试

ISELED_demo

3.4 ISELED组件说明

由于ISELEDComponents have many parameters,The following figure is highlighted here.

1. Interface,选择ISELED的接口,主要选项有Flexio,LPSPI0,LPSPI1和LPSPI2.
2. Strip Number,表示第几路ISELED,最多可以有13路,其中Strip1到strip10使用Flexio接口,Strip11到Strip13使用LPSPI接口.
3. Data Pin和Clock Pin,Choice and firstISELEDThe data pins to which the chip is connected as well as the clock pins.ISELEDThe chips are directly connected through a differential bus,只有和MCU相连接的ISELED芯片（The first address chip）Take the sync signal.

注意Data Pin和Clock pinThe same cannot be selectedLogical pins.以下图为例,选择PTA10位data pin时,不能选择PTD0或者PTD9为Clock pin,因为他们都属于FXIO_D0.

4. DMA配置,如果使能了DMA配置,下面的DMA接收、send channel as wellEDMAComponents also need to be configured in sync.
5. callback,回调函数设置,If the callback function name is filled in,when the command is received、发送完成,或者发生超时,CRC error等错误时,会调用该函数.
6. Timer channel,配置iseledThe calling timer channel,Sync is requiredtiming_pal进行配置.
7. timeout duration,Configure the timeout period of the three commands,分别是初始化,读和ping.

The recommended calculation formula for the timeout period is as follows(N代表LED数量,The unit of the final calculation result is us)：

8. Interface CLK,Displays the clock source of the selected interface,注意在clockManThe component enables the corresponding clock.
9. Timer CLK,Displays the clock source of the timer in use.

4.References and Websites

• S32K1XXISELEDUG.pdf

• S32K1_ISELED_RTM_4.0.0_ReleaseNotes.pdf

• seddLED3.0 A3A-FKG - v3

• Home - ISELED

• Product Brief INLC10AQ

• S32K-ISELED LED Lighting Solution | NXP Semiconductors