TPP3W and TPP3N Platforms

Hardware Devices Covered by This Platform

Size 3 Tibbo Project PCB (TPP3)
Tibbo Project System (TPS) devices based on this board

This section covers two separate platforms:

TPP3W — supports the GA1000 Wi-Fi add-on
TPP3N — provides limited support for the WA2000 add-on (Wi-Fi only; BLE is 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	2,040 bytes for application data

Platform type	16-bit platform
Clock frequency (CLOCK) and clock control	PLL on: 88.4736Mhz PLL off: 11.0592Mhz
Available network interfaces	Ethernet (net.), Wi-Fi (wln.),PPP (ppp.), PPPoE (pppoe.)⁽¹⁾
GPIO type	Unidirectional⁽²⁾
UART limitations	Max practical baudrate ~921,600bps
Serial port FIFOs	16 bytes for TX, 16 bytes for RX
Serial port line configuration	Depends on the serial port mode
Serial port interrupts and io.intenabled	Interdependent
RTS/CTS remapping	Supported⁽³⁾
ADC	Available through Tibbit modules
Pulse-width modulation (PWM)	Available through Tibbit modules
GA1000 support	YES
WA2000 support	Supports Wi-Fi, BLE is not supported
GA1000 and WA2000 lines remapping	Supported⁽⁴⁾
beep.divider calculation	beep.divider = CLOCK / (2 * desired_frq)
Recommended buzzer frequency divider	2,048Hz, beep.divider = 21600 (with PLL ON)
Display type selection and line remapping	Type selection and line remapping 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
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

1. The sock.allowedinterfaces property refers to the Ethernet interface as "NET," Wi-Fi as "WLN," PPP as "PPP," and PPPoE — as "PPPOE." The sock.targetinterface and sock.currentinterface properties rely on the pl_sock_interfaces enum, whose members differ depending on the platform.

2. Surrounding board hardware and installed Tibbits dictate which GPIO lines must be used as inputs and which as outputs.

3. Default CTS/RTS mapping is different for each serial port:

	RTS	CTS
Port 1	0 — PL_IO_NUM_0	0 — PL_INT_NUM_0 (16 — PL_IO_NUM_16_INT0)
Port 2	1 — PL_IO_NUM_1	1 — PL_INT_NUM_1 (17 — PL_IO_NUM_17_INT1)
Port 3	2 — PL_IO_NUM_2	2 — PL_INT_NUM_2 (18 — PL_IO_NUM_18_INT2)
Port 4	3 — PL_IO_NUM_3	3 — PL_INT_NUM_3 (19 — PL_IO_NUM_19_INT3)

4. Although the platform itself supports remapping, actual "wires" connecting the system to the GA1000 or WA2000 are fixed and your mapping should reflect this:

CS	PL_IO_NUM_49
CLK	PL_IO_NUM_53
DI	PL_IO_NUM_52
DO	PL_IO_NUM_50
RST	PL_IO_NUM_51

Supported Objects, Variable Types, and Functions

beep — generates buzzer patterns using the onboard buzzer
button — monitors the onboard setup (MD) button
fd — manages flash memory file system and direct sector access
io — handles I/O lines, ports, and interrupts
kp — scans keypads of matrix and "binary" types⁽¹⁾
net — controls the Ethernet interface
pat — "plays" patterns on up to five LED pairs
ppp — provides access to the Internet over a serial modem (4G, POTS, etc.)⁽²⁾
pppoe — provides access to the Internet over an ADSL modem
romfile — facilitates access to resource files (fixed data)
rtc — keeps track of date and time
ser — in charge of serial ports (UART, Wiegand, and clock/data modes)
sock — socket communications (up to 16 UDP, TCP, and HTTP sessions)
ssi — implements up to four serial synchronous interface (SSI) channels, supports SPI, I2C, clock/data, etc.
stor — provides access to the EEPROM
sys — in charge of general device functionality
wln — handles the Wi-Fi interface (requires a GA1000 or WA2000 add-on module to be plugged into the TPP2 G2 board)

The kp. object can be configured to communicate with an external keypad connected to the TPP3 via Tibbits. Only one keypad can be serviced at a time.
This may be an external modem connected to the TPP3(G2), a 4G (LTE) Tibbit, or a Cat-M1/NB-IoT Tibbit plugged into the board.

These platforms support the standard set of variable types and functions (a.k.a. "syscalls").

Platform-Specific Constants

enum pl_redir — The list of constants that define buffer redirection (shorting) for this platform
enum pl_io_num — The list of constants that define available I/O lines
enum pl_int_num — The list of constants that define available interrupt lines
enum pl_sock_interfaces — The list of available network interfaces