Yap Cat.1 Internet of Things Communication Terminal Product Manual

Version: 0.2

1 Product introduction:

Yap Cat.1 IoT communication terminal (hereinafter referred to as Yap terminal or terminal) is based on the popular IoT module Luat Air724 produced by Shanghai Hezhou IoT. Thanks to the use of advanced cellular IoT 4G LTE Cat.1 communication technology, the device has excellent performance in all aspects such as network coverage, energy consumption, transmission speed, transmission distance, and transmission delay. At the same time, the terminal has both communication and edge data processing functions, excellent data transmission and computing performance, strong scalability, and can be used in most IoT application scenarios. It is not only the best tool for college students to get started with IoT technology, but also a powerful tool for industry professionals to develop IoT devices.

Yap terminal has three basic functions: 4G Volte voice, USB Internet access, and serial DTU communication. In addition, thanks to the built-in Shanghai Hezhou's original Luat virtual machine technology, the Yap terminal can be used independently as an edge IoT control node to drive various sensors and actuators to complete data collection, data transmission, logic control, etc. operate. There are a wide range of terminal drive equipment, such as rangefinders, displays, LED arrays, servo motors, servos, etc.

The biggest difference between the Yap terminal and other traditional IoT devices is its full openness. The device comes with a complete set of open source IoT solutions, covering mobile APP, PC host computer control, cloud platform, and local controller. The full technology chain can be used as a teaching aid for IoT education, or as a prototype for IoT device development to help you quickly build scenario applications.

I hope you can quickly get started with the Internet of Things through this product, develop personalized and open physical network products with friends in the Luat community, and share the happiness and joy of learning Internet of Things technology.

2 Basic usage

2.1 Button function

• The switch above the battery switch panel is the battery connection switch button. The left side is for disconnecting the battery, and the right side is for connecting the battery. If you use battery power, or want to charge the battery, you need to toggle the switch to the right and set it to the connected state.
• Digital dial pad There is a digital dial pad in the middle of the panel, which can be used for digital input. When the corresponding number is entered, the upper screen will be displayed and the button light will light up accordingly.
• Multi-function keys are generally used for function confirmation and have different functions in different scenarios. The default is the 4G Volte voice answering function key.
• The restart hole needs to be touched with a pin to restart it when it crashes. Generally, it is not necessary to use it.
• The firmware programming hole needs to be touched with a pin, which is used to upgrade the firmware in USBBoot mode and is generally not needed.

2.2 Display and indicator light functions

• There is a 128X32 OLED display screen above the status indication panel, which is used to display the current status of the terminal and the received control instructions.
• The first line shows CPU usage and memory usage. Since the RTOS system adopted does not have the concept of task priority, long-term 100% CPU usage will cause the system's underlying services to fail to execute normally and cause a crash and restart. High CPU usage caused by too frequent instruction sending should be avoided. RTOS systems do not have the concept of virtual memory. The memory usage cannot exceed 100% at any time, otherwise it will cause overflow and unpredictable results, usually crash or restart.
• CSQ in the second line represents network signal quality, ranging from 0-31. The larger the value, the greater the signal reception strength. Due to the advanced 4G encoding method, data communication is generally possible if it is above 10, and stable transmission and reception can be achieved if it is above 15.
• The NET in the second line represents the networking status. The Yap terminal has the function of multi-link simultaneous networking. Currently, it supports simultaneous connection of UPWS, MQTT, and Alibaba Cloud. When the corresponding network interface is successfully connected, the corresponding font will be displayed. , if there is no connection, "-" will be displayed
• The last line is the control command display line. When the terminal receives the network command, it will display the command. Due to memory limitations, the screen only supports English characters, and Chinese characters are replaced with "*"
• There are 12 keyboard lights in the center of the screen. If you press the corresponding number button or click the number button on the remote control APP, the corresponding keyboard LED will light up. Since the digital port of the terminal and the keyboard are reused, an expansion port is used to connect to the external module for communication. The LED corresponding to the port will flash accordingly.
• There are two indicator lights below the panel, of which the red one is the charging light. When the light is on, it means charging. Charging must be started first. When this light goes off, it means the battery is full. The green one is the power-on indicator light, which lights up when the computer is turned on normally.

2.3 Interface

• YAP terminal has two external interfaces, Micro USB interface and 12Pin composite bus interface
• The Yap terminal has a built-in 300mA polymer lithium-ion battery. The charger can be connected to the USB interface to charge the battery. It takes about 45 minutes to fully charge. If the terminal is connected to the USB interface of the computer, charging will also cause the computer to map the USB network card to realize the 4G simple Internet access function.
• The 12Pin composite bus interface is an expansion port of the terminal. It supports 1.8V UART, SPI and LCD dedicated interfaces, and provides 4V battery power supply and 1.8-3.3V CNC power interface. It can mount various sensors and actuators for function expansion.

3 basic functions

Yap terminals have two basic forms, voice terminals and IoT communication terminals. The former is used for voice answering and calling, and requires the insertion of an ordinary real-name phone card before use. The latter is used for IoT data transmission and can be inserted into an IoT-specific data card. The usage methods are introduced below.

3.1 4G Volte calls and text messages

4G Volte is a new voice communication method that uses high-quality voice coding. Compared with the traditional 2G line method, the voice call signal is clearer and the call quality is higher. At present, all three major operators have supported it, but some old users have not yet opened this service. They can call the customer service numbers of China Mobile, China Unicom, and telecom operators to activate it for free.

3.1.1 Volte call

• Using the numeric dial pad, you can dial the number directly and press the multi-function key to make a Volte voice call.
• When there is an incoming call from outside, the speaker will play music. At this time, press the multi-function key to answer it.
• You can make and answer calls through the mobile APP by clicking on the APP's digital buttons.
• You can send AT commands through the mobile phone APP to control the outgoing and answering calls, and display the caller number.

  例子1:
  DIAL,117
  屏幕回显[onedial]DIALING,117
  接通后屏幕回显[onedial]CONNECTED
  HUNGUP
  电话主动挂断并回显[onedial]DISCONNECTED
  例子2:
  外部电话主动呼入
  屏幕显示[onedial]INCOMING CALL,138XXXXXXXXX
  PICKUP
  接听电话
  接通后屏幕回显[onedial]CONNECTED
  HUNGUP
  拒接电话
  电话主动挂断并回显[onedial]DISCONNECTED

3.1.2 Sending and receiving text messages

• Due to hardware limitations, the terminal itself cannot send and receive short messages. However, you can use the mobile APP to send and receive short messages by sending AT commands.

  接收短信
  当模块收到短信后控制台显示 [SMS]收到的内容@发送的手机号码
  例子
  SMS,13000000000,这是发送给老米的一条短信，号码被隐去
  发送成功后控制台回显 SMS,13XXXXXXXXX,这是发送给老米的一条短信->DONE

3.2 USB Internet access function

• The Yap terminal itself is a driver-free USB network card that supports Windows 10. Connect the terminal and the computer through a Micro USB cable. An Rndis network card will be recognized on the Windows computer. At this time, the computer already has wireless networking capabilities. If you do not need this function, you need to disable the network card in the device manager to avoid unnecessary data traffic charges.

3.3 Remote control and data communication

Yap terminal has mixed data communication capabilities and supports interconnection between mobile phones, tablets, PCs, microcontrollers, and SOC devices.

3.3.1 Yap cross-platform APP

• Yap terminal uses the built-in Upws open source service component by default for device remote control. The device authenticates and registers to the Upws server by ID and MM through the UDP protocol, and the App connects to the Upws server through the Websocket interface through the ID and MM, so that the device and the mobile APP can conduct two-way data communication.
• Yap APP is based on H5 technology and has many advantages such as no need to download, fast running speed, and no platform dependence. You can use WeChat, Alipay or any mobile phone or tablet browser that supports QR code scanning to control the device.

3.3.2 Remote control function

• There is a QR code on the back and bottom of the Yap terminal. Scan the QR code to operate it remotely.
• At the top of the APP is the device ID, which is equivalent to the device’s ID number and is unique. The dial pad in the middle enables voice calls. The lower part is the command sending and receiving window. The upper form is responsible for receiving messages from the device, and the lower form is responsible for sending messages. You can edit commands through the soft keyboard and click the send button below to send commands. You can also click the send form. Use the drop-down button on the right to select the built-in command prompt information, then edit the prompt content before sending.

3.3.3 Remote data communication

• Yap terminal itself supports serial port data communication. Three communication protocols and devices can be used for transparent transmission of string formats. The so-called string transparent transmission means that the string input from the network interface will be transmitted to the device side, and the string input from the device side will be transmitted to the network interface. Network connections are automatically maintained by Yap terminals and cloud servers.
• Take the open source Upws IoT communication protocol supported by Yap terminal as an example. You can access the 9000 port of the server box.miuser.net through the Websocket protocol. If the device is connected to the computer through the USB interface, the virtual serial device LUAT USB Device 1 AT will appear. (COMXX), use any serial port debugging tool (LLCOM is recommended - a serial port debugging tool that can run Lua scripts) to complete bidirectional string format data transparent transmission. For specific code, please refer to the open source Yap APP, which is written based on JavaScript and is completely open source.
• You can complete the networking functions of MQTT IoT general protocol and Alibaba Cloud IoT communication platform by burning midemo firmware. Yap terminal supports three networks online at the same time.
• You can map the transparent transmission port to any hardware serial port through midemo firmware. Yap terminal supports multi-serial port transparent transmission.

3.4 Chinese voice reading

• The Yap terminal supports the online reading function of Chinese, numbers, and English letters. Use the APP to send commands, and the device will remotely read the input text in real time, with clear and loud voice. For example, TTSPLUS, Hello, dear Luat partners, the device immediately reads: "Hello, dear Luat partners." Note that the English commas in the read content should be changed to full-width Chinese commas. After the reading is completed, the system will receive TTSPLUS ,Hello, dear Luat partners->DONE news

4 Firmware open source address

This project currently provides a complete open source version, including circuit, firmware, shell, etc. To obtain all project resources, please join the group: 970858559