IWR1443BOOST: Data conversion and integration

HI, there:

In the mmwave studio, you can find a MATLAB script at C:\ti\mmwave_studio_02_01_01_00\mmWaveStudio\MatlabExamples\singlechip_raw_data_reader_example\

This script should allow you to parse the data into the frame format, and it should also process through multiple files.  Please give a try and let me know. 

Best,

Zigang

HI,Zigang:

Thank you for your reply. I will try this script and consult you again if I encounter any problems.

Thans.

Dear Zigang,

I do not have a deep understanding of the code of this MATLAB script. What are the parameters marked in the figure? How do I change the code?

Thank you very much!

HI, Kelong:

Please go through the readme.txt file to find the answer.  

Best,

Zigang

Dear Zigang,

I have read readme.txt and exported the 1443.setup.json and 1443.mmwave.json files from MMWave Studio. But there are still some things I don't understand about these functions in the MATLAB script. I just made the changes in line 96 as shown in the first image and ran them as shown in the second image. I will send you setup.json and mmwave.json files and hope you can guide me how to modify these codes and functions. Thank you very much!

{
  "createdByVersion": "2.1.0",
  "createdOn": "2021-10-26T16:01:40.3753322+08:00",
  "configUsed": "E:\\adc_data\\1443.mmwave.json",
  "captureHardware": "DCA1000",
  "DCA1000Config": {
    "dataLoggingMode": "raw",
    "dataTransferMode": "LVDSCapture",
    "dataCaptureMode": "ethernetStream",
    "packetSequenceEnable": 1,
    "packetDelay_us": 25
  },
  "mmWaveDevice": "iwr1443",
  "operatingFreq": 77,
  "mmWaveDeviceConfig": {
    "RS232COMPort": "COM15",
    "RS232BaudRate": "115200",
    "radarSSFirmware": "C:\\ti\\mmwave_studio_02_01_01_00\\rf_eval_firmware\\radarss\\xwr12xx_xwr14xx_radarss.bin",
    "masterSSFirmware": "C:\\ti\\mmwave_studio_02_01_01_00\\rf_eval_firmware\\masterss\\xwr12xx_xwr14xx_masterss.bin"
  },
  "capturedFiles": {
    "numFilesCollected": 1,
    "fileBasePath": "E:\\adc_data",
    "files": [
      {
        "rawFileName": "adc_data_Raw_0.bin",
        "processedFileName": "adc_data.bin",
        "processedFileSummary": {
          "numZeroFillBytes": 0
        }
      }
    ]
  }
}

{
  "configGenerator": {
    "createdBy": "mmWaveStudio",
    "createdOn": "2021-10-26T15:41:31.7392877+08:00",
    "isConfigIntermediate": 1
  },
  "currentVersion": {
    "jsonCfgVersion": {
      "major": 0,
      "minor": 4,
      "patch": 0
    },
    "DFPVersion": {
      "major": 1,
      "minor": 2,
      "patch": 0
    },
    "SDKVersion": {
      "major": 3,
      "minor": 0,
      "patch": 0
    },
    "mmwavelinkVersion": {
      "major": 1,
      "minor": 2,
      "patch": 0
    }
  },
  "lastBackwardCompatibleVersion": {
    "DFPVersion": {
      "major": 1,
      "minor": 1,
      "patch": 0
    },
    "SDKVersion": {
      "major": 2,
      "minor": 0,
      "patch": 0
    },
    "mmwavelinkVersion": {
      "major": 1,
      "minor": 1,
      "patch": 0
    }
  },
  "regulatoryRestrictions": {
    "frequencyRangeBegin_GHz": 77,
    "frequencyRangeEnd_GHz": 81,
    "maxBandwidthAllowed_MHz": 4000,
    "maxTransmitPowerAllowed_dBm": 12
  },
  "systemConfig": {
    "summary": "This is a comments field not passed to device",
    "sceneParameters": {
      "ambientTemperature_degC": 20,
      "maxDetectableRange_m": 10,
      "rangeResolution_cm": 5,
      "maxVelocity_kmph": 26,
      "velocityResolution_kmph": 2,
      "measurementRate": 10,
      "typicalDetectedObjectRCS": 1
    }
  },
  "mmWaveDevices": [
    {
      "mmWaveDeviceId": 0,
      "rfConfig": {
        "waveformType": "legacyFrameChirp",
        "MIMOScheme": "TDM",
        "rlCalibrationDataFile": "",
        "rlChanCfg_t": {
          "rxChannelEn": "0xF",
          "txChannelEn": "0x7",
          "cascading": 0,
          "cascadingPinoutCfg": "0x0"
        },
        "rlAdcOutCfg_t": {
          "fmt": {
            "b2AdcBits": 2,
            "b8FullScaleReducFctr": 0,
            "b2AdcOutFmt": 2
          }
        },
        "rlLowPowerModeCfg_t": {
          "lpAdcMode": 0
        },
        "rlProfiles": [
          {
            "rlProfileCfg_t": {
              "profileId": 0,
              "pfVcoSelect": "0x0",
              "pfCalLutUpdate": "0x0",
              "startFreqConst_GHz": 77.0,
              "idleTimeConst_usec": 100.0,
              "adcStartTimeConst_usec": 6.0,
              "rampEndTime_usec": 60.0,
              "txOutPowerBackoffCode": "0x0",
              "txPhaseShifter": "0x0",
              "freqSlopeConst_MHz_usec": 29.982000350952148,
              "txStartTime_usec": 0.0,
              "numAdcSamples": 256,
              "digOutSampleRate": 10000,
              "hpfCornerFreq1": 0,
              "hpfCornerFreq2": 0,
              "rxGain_dB": "0x1E"
            }
          }
        ],
        "rlChirps": [
          {
            "rlChirpCfg_t": {
              "chirpStartIdx": 0,
              "chirpEndIdx": 0,
              "profileId": 0,
              "startFreqVar_MHz": 0.0,
              "freqSlopeVar_KHz_usec": 0.0,
              "idleTimeVar_usec": 0.0,
              "adcStartTimeVar_usec": 0.0,
              "txEnable": "0x1"
            }
          }
        ],
        "rlFrameCfg_t": {
          "chirpEndIdx": 0,
          "chirpStartIdx": 0,
          "numLoops": 128,
          "numFrames": 0,
          "framePeriodicity_msec": 40.0,
          "triggerSelect": 1,
          "numDummyChirpsAtEnd": 0,
          "frameTriggerDelay": 0.0
        },
        "rlBpmChirps": [],
        "rlRfPhaseShiftCfgs": [],
        "rlRfProgFiltConfs": [],
        "rlLoopbackBursts": [],
        "rlDynChirpCfgs": [],
        "rlDynPerChirpPhShftCfgs": []
      },
      "rawDataCaptureConfig": {
        "rlDevDataFmtCfg_t": {
          "iqSwapSel": 0,
          "chInterleave": 0
        },
        "rlDevDataPathCfg_t": {
          "intfSel": 1,
          "transferFmtPkt0": "0x1",
          "transferFmtPkt1": "0x0",
          "cqConfig": 2,
          "cq0TransSize": 132,
          "cq1TransSize": 132,
          "cq2TransSize": 72
        },
        "rlDevLaneEnable_t": {
          "laneEn": "0xF"
        },
        "rlDevDataPathClkCfg_t": {
          "laneClkCfg": 1,
          "dataRate_Mbps": 600
        },
        "rlDevLvdsLaneCfg_t": {
          "laneFmtMap": 0,
          "laneParamCfg": "0x1"
        }
      },
      "monitoringConfig": {
      }
    }
  ],
  "processingChainConfig": {
    "detectionChain": {
      "name": "TI_GenericChain",
      "detectionLoss": 1,
      "systemLoss": 1,
      "implementationMargin": 2,
      "detectionSNR": 12,
      "theoreticalRxAntennaGain": 9,
      "theoreticalTxAntennaGain": 9
    }
  }
}

HI, 

You do not need to change the MATLAB script.   All you need to do is to pass the xxxx.setup.json file name through the MATLAB function call as mentioned in the readme.txt.  

rawDataReader('C:\jsonScript\awr14\awr14xx.setup.json','adcData', 'radarCube', 0)

All important is the first parameter xxx.setup.json file.  It contains the information to find mmwave.json file and the raw data file. 

Best,

Zigang

Dear Zigang,

Thank you for your reply. Following readme.tet, my code calls the function as shown in the figure. I only modified line 85 and still get an error. Why? What can I do to run this script correctly?

Dear Zigang,

Thank you very much for your reply. I got 'radarCube.mat' file and 'rawdata.mat' file belonging to raw data 'adc_data.bin' file correctly through rawDatareader.m. As shown in the picture below.

I have a few more questions which I would like answered:

Firstly, I want to know the format of the data stored in these two '**.mat' files. I saw the description in the page7-8 of 'Mmwave Radar Device ADC Raw Data Capture'  that the Data collected using IWR1443 with DCA1000 is captured over 4 LVDS Lanes and stored in an interlaced.bin file, as shown below. But I would like to know the data format of 'radarCube.mat' and 'rawdata.mat' files obtained by rawDatareader.m.

Second, on the basis of the first point, I want to know how to draw the data in 'radarCube.mat' and 'rawdata.mat' files as waveform diagrams,and I want to know the vibration amplitude curve of the object tested with IWR1443BOOST over time.

Third, I set the 'infinite frame mode' in MMWave Studio and generated multiple data storage files such as ADC_data_0.bin, ADC_data_1, etc. Can rawDatareader. m convert data from multiple rawdata.bin files to consecutive data from a '**.mat' file in the correct order? How do you get there?

Thank you very much.

Dear Zigang,

1)I use "figure; plot (adcrawdata.data {1}(:,1,1))" and get the following figure. what the x and y axes in this picture refer to?

2)I have a question that I have not been able to understand, that is, what information is captured by ADC1000EVM? What information does a stored binary contain? 

I've been doing a lot of research on the Internet(I am new to the radio field, so the information may not be accurate, thank you for correcting me if there is any mistake). My understanding is that a TI board emits a signal called a "chirp" whose frequency varies linearly with time. A set of chirps forms a "frame". The time of receiving reflected signals from targets at different distances is different.

So, what kind of information does TI board store? Is it the time it takes for the signal to go from the transmitter to the target to the receiver or something else? I have looked it up for several days. It is a pity that I could not get more detailed information. I am looking forward to getting an answer from you.

3)I need to use IWR1443BOOST+DCA1000EVM for an experiment: aim the board at the chest of a person at an interval of about 1 meter for continuous observation for 1 hour, and capture the data within 1 hour through DCA1000EVM.

I want to see how the phase of the signal changes over time over the course of an hour, and the phase changes are due to the breathing and the heartbeat.

How do I get what I want with the data captured by DCA1000EVM? What should be done to DCA1000EVM data?

1) The raw ADC data should be ADC data and is complex value, including real and imaginary.  Sorry, my example was wrong, since the three dimensional array is [number of chirps, number of RX channels, number of ADC samples], so to plot the ADC sample of the first frame, first chirp and first antenna, you should look at:   figure; plot(abs(adcRawData.data{1}(1, 1, :))).  Can you check whether the signal are complex values?

2) ADC data is the ADC output of the received chain.  You can go through the device datasheet to understand the RX chain. 

3) To develop new vital sign demo, you can start with the vital sign demo and read through the document located at:  dev.ti.com/.../node

Best,

Zigang

dear zigang

Can you tell me what the stored complex values mean?

The ADC data has I sample (real) and Q sample (imaginary), the data should be constructed as  I_sample + 1j* Q_sample before saved in as .mat file.

Best,

Zigang

dear zigang,

I found the 3d matrix data for each frame [chirp, antenna, sample] in radarCube.data, 128*4*256. Each sample is a complex value.

Here, I have a question. In my opinion, the radar receiving antenna will receive multiple different reflected signals at one time, and these reflected signals have different frequencies. Why is the data stored only a complex value?

And where is the time information stored? How do I get dynamic time information? Because the data storage method in radarCube. Data is to store the 128*4*256 3D matrix [chirp, antenna, sample] of each frame in a cell. For example, if I want to know the distance change of a moving target over time, How do I get what I want from such a complex number?

Finally, is it convenient to ask a personal question? What are your usual working hours? Local time or US time. Due to the distance between time zones, I cannot timely issue new questions or reply to your reply. If you could tell me your working hours, maybe it would be more convenient for us to communicate without sending or replying messages for more than ten hours each time?

Thank you very much！