DS1202 Platform

Hardware devices covered by this platform

  • DS1202 programmable serial controller.

Memory space and key info

RAM

22,271 bytes for application variables and data

Flash

983,040 bytes for application and data storage (shared flash memory)

EEPROM

2040 bytes for application data

TiOS firmware version

[V3.6x]

Platform type

16-bit platform

Clock frequency (CLOCK) and clock control

PLL on (def): 88.4736Mhz, PLL off: 11.0592Mhz

Available network interfaces

Ethernet (net.), PPP (ppp.), PPPoE (pppoe.)(1)

GPIO type

Unidirectional(2)

UART limitations

Max practical baudrate ~921600

Serial port FIFOs

16 byte for TX, 16 bytes for RX

Serial port line configuration

Depends on the serial port mode

Serial port interrupts and io.intenabled

Independent

RTS/CTS remapping

Supported(3)

ADC

N/A

Pulse-width Modulation (PWM)

N/A

GA1000 support

NO

WA2000 support

NO

GA1000 and WA2000 lines remapping

This platform does not support Wi-Fi at all

Beep.divider calculation

N/A (buzzer not provided)

Recommended buzzer frequency divider

N/A (buzzer not provided)

Display type selection and line remapping

Display not supported

Special configuration section of the EEPROM

28 bytes for MAC and device password storage

Device serial number

128 bytes: 64 OTP bytes + 64 fixed bytes(4)

Flash memory configuration

Shared

Self-upgrades for the Tibbo-BASIC/C app.

Supported through fd.copyfirmware, fd.copyfirmwarelzo, and fd.copyfirmwarefromfile methods

Status LEDs (LED Control Lines)

Two green status (SG) LEDs (side and top)

Two red status (SR) LEDs (side and top)

Yellow Ethernet status (EY) LED

Green Ethernet status (EG) LED

Debug communications

Ethernet / UDP Broadcast transport

Ethernet /WinPCap transport

Comments:

  1. The sock.allowedinterfaces property refers to the Ethernet interface as "NET", PPP — as "PPP", and PPPoE — as "PPPOE". Sock.targetinterface and sock.currentinterface properties rely on the pl_sock_interfaces enum, whose members differ depending on the platform.
  2. Surrounding board hardware dictates which GPIO lines must be used as inputs and which — as outputs.
  3. The hardware of this platform supports serial channels, which means that CTS/RTS and DTR/DSR pairs of the DB9 connector can also be used as RX/TX pairs of additional serial channels. Therefore, it is up to you to decide which lines are used as RTS and CTS, and which channels they will belong to. Proper mapping will be required to implement each particular arrangement.
  4. Older DS1202 and DS1202W devices did not contain the serial number. To find out if your DS1202(W) has the serial number onboard, try to read this serial number with the sys.serialnum R/O property. If this property returns an empty string, then the serial number is not present. Sys.serialnum returns all 128 bytes of the serial number. First 64 bytes are one-time-programmable (OTP) with the sys.setserialnum method.

Supported Objects, variable types, and functions

  • Sock — socket communications (up to 16 UDP, TCP, and HTTP sessions);
  • Net — controls the Ethernet port;
  • Ser — in charge of the serial ports (on this device, serial channels of the RS232 port);
  • Ssi  — implements up to four serial synchronous interface (SSI) channels, supports SPI, I2C, clock/data, etc.;
  • Io — handles I/O lines, ports, and interrupts;
  • Fd — manages flash memory file system and direct sector access;
  • Stor — provides access to the EEPROM;
  • Romfile — facilitates access to resource files (fixed data);
  • Pppoe — provides access to the Internet over an ADSL modem;
  • Ppp — provides access to the Internet over a serial modem (GPRS, POTS, etc.);
  • Pat — "plays" patterns on a pair of LEDs;
  • Button — monitors the MD line (setup button);
  • Sys — in charge of general device functionality.

This platform supports the standard set of variable types and functions (a.k.a. "syscalls").

Platform-specific constants

You can find them here.