« Close

Datasheets and User Guides

Software & Driver

 

4.4 RAM [T-Series Datasheet]

Overview

Maximum system RAM: 64 KB

When enough RAM is allocated, the next attempt to allocate RAM will fail with the error SYSTEM_MEMORY_BEREFT (errorcode: 2400).

If SYSTEM_MEMORY_BEREFT is occurring, your application must either use smaller amounts of RAM or free previously allocated RAM. Some common things to try:

  • To free allocated stream RAM, stop stream. To use less stream RAM, use a smaller STREAM_BUFFER_SIZE_BYTES and/or smaller STREAM_OUT#(0:3)_BUFFER_ALLOCATE_NUM_BYTES
  • To free other allocated RAM:
    • Write 0 LUA_RUN
    • Write 0 USER_RAM_FIFO#(0:3)_ALLOCATE_NUM_BYTES
    • Write 0 AIN#(0:149)_EF_INDEX

RAM-Allocating Registers

The below registers allocate system RAM (and may return SYSTEM_MEMORY_BEREFT):

Stream
Name Start Address Type Access
STREAM_ENABLE 4990 UINT32 R/W
STREAM_OUT#(0:2)_ENABLE 4090 UINT32 R/W
STREAM_ENABLE
- Address: 4990
Write 1 to start stream. Write 0 to stop stream. Reading this register returns 1 is stream is enabled. When using a triggered stream the stream is considered enabled while waiting for the trigger.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
STREAM_OUT#(0:2)_ENABLE
- Starting Address: 4090
Write 1 to enable, 0 to disable. When enabled, you get 1 update per target per stream scan, so a stream must be active for updates to happen.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
Expanded Names Addresses
STREAM_OUT0_ENABLE, STREAM_OUT1_ENABLE, STREAM_OUT2_ENABLE 4090, 4092, 4094

STREAM_BUFFER_SIZE_BYTES does not allocate RAM, but it does set the amount of RAM allocated by STREAM_ENABLE. LJM_eStreamStart writes to STREAM_ENABLE.

Similarly, STREAM_OUT#(0:3)_BUFFER_ALLOCATE_NUM_BYTES does not allocate RAM, but sets the amount of RAM allocated by STREAM_OUT#(0:3)_ENABLE.

Lua
Name Start Address Type Access
LUA_RUN 6000 UINT32 R/W
LUA_SOURCE_SIZE 6012 UINT32 R/W
LUA_DEBUG_ENABLE 6020 UINT32 R/W
LUA_RUN
- Address: 6000
Writing 1 compiles and runs the Lua script that is loaded in RAM. Writing zero stops the script and begins cleaning up memory. Users may poll the register after writing a value of 0 to verify that the VM is unloaded, and garbage collection is complete. 0 = VM fully unloaded. 1 = Running/in-progress
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
LUA_SOURCE_SIZE
- Address: 6012
Allocates RAM for the source code.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
LUA_DEBUG_ENABLE
- Address: 6020
Write 1 to this register to enable debugging.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:

Lua scripts dynamically allocate RAM.

User
Name Start Address Type Access
USER_RAM_FIFO#(0:2)_ALLOCATE_NUM_BYTES 47900 UINT32 R/W
USER_RAM_FIFO#(0:2)_ALLOCATE_NUM_BYTES
- Starting Address: 47900
Allocate memory for a FIFO buffer. Number of bytes should be sufficient to store users max transfer array size. Note that FLOAT32, INT32, and UINT32 require 4 bytes per value, and UINT16 require 2 bytes per value. Maximum size is limited by available memory. Care should be taken to conserve enough memory for other operations such as AIN_EF, Lua, Stream etc.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
Expanded Names Addresses
USER_RAM_FIFO0_ALLOCATE_NUM_BYTES, USER_RAM_FIFO1_ALLOCATE_NUM_BYTES, USER_RAM_FIFO2_ALLOCATE_NUM_BYTES 47900, 47902, 47904

AIN Extended Features
Name Start Address Type Access
AIN#(0:148)_EF_INDEX 9000 UINT32 R/W
AIN#(0:148)_EF_READ_A 7000 FLOAT32 R
AIN#(0:148)_EF_INDEX
- Starting Address: 9000
Specify the desired extended feature for this analog input with the index value. List of index values: 0=None(disabled); 1=Offset and Slope; 3=Max/Min/Avg; 4=Resistance; 5=Average and Threshold; 10=RMS Flex; 11=FlexRMS; 20=Thermocouple type E; 21=Thermocouple type J; 22=Thermocouple type K; 23=Thermocouple type R; 24=Thermocouple type T; 25=Thermocouple type S; 30=Thermocouple type C; 40=RTD model PT100; 41=RTD model PT500; 42=RTD model PT1000.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
  • T4:
    • The T4 does not support thermocouple modes.
Expanded Names Addresses
AIN0_EF_INDEX, AIN1_EF_INDEX, AIN2_EF_INDEX, AIN3_EF_INDEX, AIN4_EF_INDEX, AIN5_EF_INDEX, AIN6_EF_INDEX, AIN7_EF_INDEX, AIN8_EF_INDEX, AIN9_EF_INDEX, AIN10_EF_INDEX, AIN11_EF_INDEX, AIN12_EF_INDEX, AIN13_EF_INDEX, AIN14_EF_INDEX, AIN15_EF_INDEX, AIN16_EF_INDEX, AIN17_EF_INDEX, AIN18_EF_INDEX, AIN19_EF_INDEX, AIN20_EF_INDEX, AIN21_EF_INDEX, AIN22_EF_INDEX, AIN23_EF_INDEX, AIN24_EF_INDEX, AIN25_EF_INDEX, AIN26_EF_INDEX, AIN27_EF_INDEX, AIN28_EF_INDEX, AIN29_EF_INDEX, AIN30_EF_INDEX, AIN31_EF_INDEX, AIN32_EF_INDEX, AIN33_EF_INDEX, AIN34_EF_INDEX, AIN35_EF_INDEX, AIN36_EF_INDEX, AIN37_EF_INDEX, AIN38_EF_INDEX, AIN39_EF_INDEX, AIN40_EF_INDEX, AIN41_EF_INDEX, AIN42_EF_INDEX, AIN43_EF_INDEX, AIN44_EF_INDEX, AIN45_EF_INDEX, AIN46_EF_INDEX, AIN47_EF_INDEX, AIN48_EF_INDEX, AIN49_EF_INDEX, AIN50_EF_INDEX, AIN51_EF_INDEX, AIN52_EF_INDEX, AIN53_EF_INDEX, AIN54_EF_INDEX, AIN55_EF_INDEX, AIN56_EF_INDEX, AIN57_EF_INDEX, AIN58_EF_INDEX, AIN59_EF_INDEX, AIN60_EF_INDEX, AIN61_EF_INDEX, AIN62_EF_INDEX, AIN63_EF_INDEX, AIN64_EF_INDEX, AIN65_EF_INDEX, AIN66_EF_INDEX, AIN67_EF_INDEX, AIN68_EF_INDEX, AIN69_EF_INDEX, AIN70_EF_INDEX, AIN71_EF_INDEX, AIN72_EF_INDEX, AIN73_EF_INDEX, AIN74_EF_INDEX, AIN75_EF_INDEX, AIN76_EF_INDEX, AIN77_EF_INDEX, AIN78_EF_INDEX, AIN79_EF_INDEX, AIN80_EF_INDEX, AIN81_EF_INDEX, AIN82_EF_INDEX, AIN83_EF_INDEX, AIN84_EF_INDEX, AIN85_EF_INDEX, AIN86_EF_INDEX, AIN87_EF_INDEX, AIN88_EF_INDEX, AIN89_EF_INDEX, AIN90_EF_INDEX, AIN91_EF_INDEX, AIN92_EF_INDEX, AIN93_EF_INDEX, AIN94_EF_INDEX, AIN95_EF_INDEX, AIN96_EF_INDEX, AIN97_EF_INDEX, AIN98_EF_INDEX, AIN99_EF_INDEX, AIN100_EF_INDEX, AIN101_EF_INDEX, AIN102_EF_INDEX, AIN103_EF_INDEX, AIN104_EF_INDEX, AIN105_EF_INDEX, AIN106_EF_INDEX, AIN107_EF_INDEX, AIN108_EF_INDEX, AIN109_EF_INDEX, AIN110_EF_INDEX, AIN111_EF_INDEX, AIN112_EF_INDEX, AIN113_EF_INDEX, AIN114_EF_INDEX, AIN115_EF_INDEX, AIN116_EF_INDEX, AIN117_EF_INDEX, AIN118_EF_INDEX, AIN119_EF_INDEX, AIN120_EF_INDEX, AIN121_EF_INDEX, AIN122_EF_INDEX, AIN123_EF_INDEX, AIN124_EF_INDEX, AIN125_EF_INDEX, AIN126_EF_INDEX, AIN127_EF_INDEX, AIN128_EF_INDEX, AIN129_EF_INDEX, AIN130_EF_INDEX, AIN131_EF_INDEX, AIN132_EF_INDEX, AIN133_EF_INDEX, AIN134_EF_INDEX, AIN135_EF_INDEX, AIN136_EF_INDEX, AIN137_EF_INDEX, AIN138_EF_INDEX, AIN139_EF_INDEX, AIN140_EF_INDEX, AIN141_EF_INDEX, AIN142_EF_INDEX, AIN143_EF_INDEX, AIN144_EF_INDEX, AIN145_EF_INDEX, AIN146_EF_INDEX, AIN147_EF_INDEX, AIN148_EF_INDEX Show All 9000, 9002, 9004, 9006, 9008, 9010, 9012, 9014, 9016, 9018, 9020, 9022, 9024, 9026, 9028, 9030, 9032, 9034, 9036, 9038, 9040, 9042, 9044, 9046, 9048, 9050, 9052, 9054, 9056, 9058, 9060, 9062, 9064, 9066, 9068, 9070, 9072, 9074, 9076, 9078, 9080, 9082, 9084, 9086, 9088, 9090, 9092, 9094, 9096, 9098, 9100, 9102, 9104, 9106, 9108, 9110, 9112, 9114, 9116, 9118, 9120, 9122, 9124, 9126, 9128, 9130, 9132, 9134, 9136, 9138, 9140, 9142, 9144, 9146, 9148, 9150, 9152, 9154, 9156, 9158, 9160, 9162, 9164, 9166, 9168, 9170, 9172, 9174, 9176, 9178, 9180, 9182, 9184, 9186, 9188, 9190, 9192, 9194, 9196, 9198, 9200, 9202, 9204, 9206, 9208, 9210, 9212, 9214, 9216, 9218, 9220, 9222, 9224, 9226, 9228, 9230, 9232, 9234, 9236, 9238, 9240, 9242, 9244, 9246, 9248, 9250, 9252, 9254, 9256, 9258, 9260, 9262, 9264, 9266, 9268, 9270, 9272, 9274, 9276, 9278, 9280, 9282, 9284, 9286, 9288, 9290, 9292, 9294, 9296 Show All
AIN#(0:148)_EF_READ_A
- Starting Address: 7000
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Read-only
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
Expanded Names Addresses
AIN0_EF_READ_A, AIN1_EF_READ_A, AIN2_EF_READ_A, AIN3_EF_READ_A, AIN4_EF_READ_A, AIN5_EF_READ_A, AIN6_EF_READ_A, AIN7_EF_READ_A, AIN8_EF_READ_A, AIN9_EF_READ_A, AIN10_EF_READ_A, AIN11_EF_READ_A, AIN12_EF_READ_A, AIN13_EF_READ_A, AIN14_EF_READ_A, AIN15_EF_READ_A, AIN16_EF_READ_A, AIN17_EF_READ_A, AIN18_EF_READ_A, AIN19_EF_READ_A, AIN20_EF_READ_A, AIN21_EF_READ_A, AIN22_EF_READ_A, AIN23_EF_READ_A, AIN24_EF_READ_A, AIN25_EF_READ_A, AIN26_EF_READ_A, AIN27_EF_READ_A, AIN28_EF_READ_A, AIN29_EF_READ_A, AIN30_EF_READ_A, AIN31_EF_READ_A, AIN32_EF_READ_A, AIN33_EF_READ_A, AIN34_EF_READ_A, AIN35_EF_READ_A, AIN36_EF_READ_A, AIN37_EF_READ_A, AIN38_EF_READ_A, AIN39_EF_READ_A, AIN40_EF_READ_A, AIN41_EF_READ_A, AIN42_EF_READ_A, AIN43_EF_READ_A, AIN44_EF_READ_A, AIN45_EF_READ_A, AIN46_EF_READ_A, AIN47_EF_READ_A, AIN48_EF_READ_A, AIN49_EF_READ_A, AIN50_EF_READ_A, AIN51_EF_READ_A, AIN52_EF_READ_A, AIN53_EF_READ_A, AIN54_EF_READ_A, AIN55_EF_READ_A, AIN56_EF_READ_A, AIN57_EF_READ_A, AIN58_EF_READ_A, AIN59_EF_READ_A, AIN60_EF_READ_A, AIN61_EF_READ_A, AIN62_EF_READ_A, AIN63_EF_READ_A, AIN64_EF_READ_A, AIN65_EF_READ_A, AIN66_EF_READ_A, AIN67_EF_READ_A, AIN68_EF_READ_A, AIN69_EF_READ_A, AIN70_EF_READ_A, AIN71_EF_READ_A, AIN72_EF_READ_A, AIN73_EF_READ_A, AIN74_EF_READ_A, AIN75_EF_READ_A, AIN76_EF_READ_A, AIN77_EF_READ_A, AIN78_EF_READ_A, AIN79_EF_READ_A, AIN80_EF_READ_A, AIN81_EF_READ_A, AIN82_EF_READ_A, AIN83_EF_READ_A, AIN84_EF_READ_A, AIN85_EF_READ_A, AIN86_EF_READ_A, AIN87_EF_READ_A, AIN88_EF_READ_A, AIN89_EF_READ_A, AIN90_EF_READ_A, AIN91_EF_READ_A, AIN92_EF_READ_A, AIN93_EF_READ_A, AIN94_EF_READ_A, AIN95_EF_READ_A, AIN96_EF_READ_A, AIN97_EF_READ_A, AIN98_EF_READ_A, AIN99_EF_READ_A, AIN100_EF_READ_A, AIN101_EF_READ_A, AIN102_EF_READ_A, AIN103_EF_READ_A, AIN104_EF_READ_A, AIN105_EF_READ_A, AIN106_EF_READ_A, AIN107_EF_READ_A, AIN108_EF_READ_A, AIN109_EF_READ_A, AIN110_EF_READ_A, AIN111_EF_READ_A, AIN112_EF_READ_A, AIN113_EF_READ_A, AIN114_EF_READ_A, AIN115_EF_READ_A, AIN116_EF_READ_A, AIN117_EF_READ_A, AIN118_EF_READ_A, AIN119_EF_READ_A, AIN120_EF_READ_A, AIN121_EF_READ_A, AIN122_EF_READ_A, AIN123_EF_READ_A, AIN124_EF_READ_A, AIN125_EF_READ_A, AIN126_EF_READ_A, AIN127_EF_READ_A, AIN128_EF_READ_A, AIN129_EF_READ_A, AIN130_EF_READ_A, AIN131_EF_READ_A, AIN132_EF_READ_A, AIN133_EF_READ_A, AIN134_EF_READ_A, AIN135_EF_READ_A, AIN136_EF_READ_A, AIN137_EF_READ_A, AIN138_EF_READ_A, AIN139_EF_READ_A, AIN140_EF_READ_A, AIN141_EF_READ_A, AIN142_EF_READ_A, AIN143_EF_READ_A, AIN144_EF_READ_A, AIN145_EF_READ_A, AIN146_EF_READ_A, AIN147_EF_READ_A, AIN148_EF_READ_A Show All 7000, 7002, 7004, 7006, 7008, 7010, 7012, 7014, 7016, 7018, 7020, 7022, 7024, 7026, 7028, 7030, 7032, 7034, 7036, 7038, 7040, 7042, 7044, 7046, 7048, 7050, 7052, 7054, 7056, 7058, 7060, 7062, 7064, 7066, 7068, 7070, 7072, 7074, 7076, 7078, 7080, 7082, 7084, 7086, 7088, 7090, 7092, 7094, 7096, 7098, 7100, 7102, 7104, 7106, 7108, 7110, 7112, 7114, 7116, 7118, 7120, 7122, 7124, 7126, 7128, 7130, 7132, 7134, 7136, 7138, 7140, 7142, 7144, 7146, 7148, 7150, 7152, 7154, 7156, 7158, 7160, 7162, 7164, 7166, 7168, 7170, 7172, 7174, 7176, 7178, 7180, 7182, 7184, 7186, 7188, 7190, 7192, 7194, 7196, 7198, 7200, 7202, 7204, 7206, 7208, 7210, 7212, 7214, 7216, 7218, 7220, 7222, 7224, 7226, 7228, 7230, 7232, 7234, 7236, 7238, 7240, 7242, 7244, 7246, 7248, 7250, 7252, 7254, 7256, 7258, 7260, 7262, 7264, 7266, 7268, 7270, 7272, 7274, 7276, 7278, 7280, 7282, 7284, 7286, 7288, 7290, 7292, 7294, 7296 Show All

File I/O
Name Start Address Type Access
FILE_IO_PATH_WRITE_LEN_BYTES 60640 UINT32 W
FILE_IO_PATH_WRITE_LEN_BYTES
- Address: 60640
Write the length (in bytes) of the file path or directory to access.
  • Data type: UINT32  (type index = 1)
  • Write-only
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:

SPI
Name Start Address Type Access
SPI_GO 5007 UINT16 W
SPI_GO
- Address: 5007
Write 1 to begin the configured SPI transaction.
  • Data type: UINT16  (type index = 0)
  • Write-only
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM

Serial
Name Start Address Type Access
ASYNCH_NUM_BYTES_TX 5440 UINT16 R/W
ASYNCH_ENABLE 5400 UINT16 R/W
ASYNCH_NUM_BYTES_TX
- Address: 5440
The number of bytes to be transmitted after writing to GO. Max is 256.
  • Data type: UINT16  (type index = 0)
  • Readable and writable
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
ASYNCH_ENABLE
- Address: 5400
1 = Turn on Asynch. Configures timing hardware, DIO lines and allocates the receiving buffer.
  • Data type: UINT16  (type index = 0)
  • Readable and writable
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM