DS1101W and DS1101N Platforms

Hardware devices covered by this platform

  • DS1101 programmable serial controller.

This section covers two separate platforms:

  • DS1101W — supports the GA1000 Wi-Fi add-on.
  • DS1001N — provides limited support for the WA2000 add-on (Wi-Fi only; BLE not supported).

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.7x]

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.), Wi-Fi (wln.) , PPP (ppp.), PPPoE (pppoe.)(1)

GPIO type

Unidirectional(2)

UART limitations

Max practical baudrate ~460,800bps

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

YES

WA2000 support

Supports Wi-Fi, BLE is not supported

GA1000 and WA2000 lines remapping

Supported(4)

Beep.divider calculation

beep.divider=CLOCK / (2 * desired_frq)

Recommended buzzer frequency divider

2700Hz, beep.divider = 16200  (with PLL ON)

Display type selection and line remapping

Type selection and line remapping supported, but the hardware dictates the use of "Solomon SSD1305" driver and a predefined control line arrangement

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

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)

Green status (SG) LED

Red status (SR) LED

Yellow Ethernet status (EY) LED

An LED bar consisting of five blue LEDs

Debug communications

Ethernet / UDP Broadcast transport

Ethernet /WinPCap transport

Comments:

  1. The sock.allowedinterfaces property refers to the Ethernet interface as "NET", Wi-Fi — as "WLN", 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. Although the platform itself supports remapping, actual "wires" connecting the system to the GA1000 are fixed and your mapping should reflect this:

CS

15- PL_IO_NUM_15

CLK

14- PL_IO_NUM_14

DI

12- PL_IO_NUM_12

DO

13- PL_IO_NUM_13

RST

11- PL_IO_NUM_11

Supported Objects, variable types, and functions

  • Sock — socket communications (up to 16 UDP, TCP, and HTTP sessions);
  • Net — controls the Ethernet port;
  • Wln — handles the Wi-Fi interface ("W" build works with the GA1000 add-on module, "N" build works with the WA2000 add-on module);
  • Ser — in charge of the serial ports (on this device, serial channels of the RS232 port);
  • Io — handles I/O lines, ports, and interrupts;
  • Lcd — controls the 96x32 monochrome OLED display (therefore, requires the "D" device option);
  • 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;
  • Beep — generates buzzer patterns;

note_warning-wt

As all displays of this type, the DS1101's OLED display has a limited life span. There will be a decrease in the display brightness after ~10000 hours of operation. To prolong display life, use the lcd.lock method to turn the display off whenever possible. Display image is preserved when the display is "locked".

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

Platform-specific constants

You can find them here.