N720 OpenLinux Software User Guide Version 1.0

Transcription

1 N720 Hardware User Guide () N720 OpenLinux Software User Guide Version 1.0

2 Copyright Copyright 2017 Neoway Technology Co., Ltd. All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means without prior written consent of Shenzhen Neoway Technology Co., Ltd. is the trademark of Shenzhen Neoway Technology Co., Ltd. All other trademarks and trade names mentioned in this document are the property of their respective holders. Notice This document provides guide for users to use the N720 OpenLinux. This document is intended for system engineers (SEs), development engineers, and test engineers. The information in this document is subject to change without notice due to product version update or other reasons. Every effort has been made in preparation of this document to ensure accuracy of the contents, but all statements, information, and recommendations in this document do not constitute a warranty of any kind, express or implied. Shenzhen Neoway provides customers complete technical support. If you have any question, please contact your account manager or to the following addresses: Sales@neoway.com Support@neoway.com Website: Copyright Neoway Technology Co., Ltd i

3 Revision Record Version Changes Date V1.0 Initial draft Copyright Neoway Technology Co., Ltd ii

4 Contents 1 N720 OpenLinux Features Block Diagram Basic Functions Installing USB Driver on Windows Setting Up Development Environment Development Environment Compiling Environment Debugging Environment Debugging Compiling and Running Compiling Running Reference Software Design ADC GPIO UART SPI Network Ethernet OTG AT Copyright Neoway Technology Co., Ltd iii

5 1 N720 OpenLinux 1.1 Features ARM Cortex-A7 processor, 1.3 GHz main frequency, 256kB L2 laches, 28 nm process technology Standard Linux OS, corresponding to kernel version Allow the installation and running of APP developed on standard libc C language RAM: 256MB ROM: 256MB Support different network standards: GSM/GPRS/EDGE&WCDMA R99 to DC-HSPA+&TD-SCDMA&LTE Cat4 Support USB2.0/Dual SIM/ADC/UART/SPI/I2C/PCM Support Android Debug Bridge (ADB) 1.2 Block Diagram Figure 1-1 Logic block diagram N720 OpenLinux module is developed on Qualcomm MDM9x07 platform and provides API functions developed on C language and data structure definition (header files). Developers can create APP programed by C language on a computer running ubuntu OS, compile it using GCC compiling tool targeted ARM, and generate executable file. Copyright Neoway Technology Co., Ltd 1

6 Executable files produced by developers are pushed to the usr/bin directory through the ADB tool. After modifying the file permission, developers can manually start it, or set automatic start with the module by changing the etc/inittab configuration file. 1.3 Basic Functions Basic functions except the last item are inherited from Qualcomm MCM architecture: Network registration monitoring and setting Voice call services Data call services SMS services Location services SIM card services GPIO, ADC, SPI, UART Copyright Neoway Technology Co., Ltd 2

7 2 Installing USB Driver on Windows Check if the USB driver is installed properly. 1. After powering on the N720 module, connect N720 to a computer via a USB cable. 2. On the computer, right-click Computer and choose Properties from the shortcut menu. 3. In Device Manager, check the port. If the USB driver is not installed properly, please perform the following operations: Step 1 Decompress Neoway_N720_drivers.rar. Step 2 Power on N720 module, and connect it to a computer via USB. If the computer displays Device driver software was not successfully installed, then install USB driver manually. Step 3 In Device Manager, right-click Android and select Update Driver Software from the short-cut menu. Copyright Neoway Technology Co., Ltd 3

8 Step 4 In the Update Driver Software-Android dialog box, click Browse my computer for driver software. Step 5 In the page of Browse for driver software on your computer, click Browse and choose the driver software path. Then click Next. If your computer runs 32-bit OS, select Neoway_N720_drivers\32bit. If your computer runs 64-bit OS, select Neoway_N720_drivers\64bit. Copyright Neoway Technology Co., Ltd 4

9 Step 6 If the computer displays Windows Security, click Install this driver software anyway. The installation is completed. Copyright Neoway Technology Co., Ltd 5

10 Step 7 Perform the same steps to install other Android device drivers. After all drivers are installed, they are shown as in the following figure. Step 8 Send an AT command to test the connection. Copyright Neoway Technology Co., Ltd 6

11 3 Setting Up Development Environment 3.1 Development Environment Compiling Environment PC OS: Ubuntu 64-bit OS, version or later Complier: arm arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2. The tool is packed under /tool/ in the SDK package. On a computer running Ubuntu, decompress the package and change the environment variable $PATH of the system. e.g. arm arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2 is decompressed to /home/zhangyuanxun/downloads/, then add /home/zhangyuanxun/downloads/arm /bin to $PATH by adding the following statement in /etc/profile: PATH="$PATH:/home/zhangyuanxun/Downloads/arm /bin" Debugging Environment PC OS: Windows 7 Debugging tool: ADB -- Android Debug Bridge version (Windows OS is recommended) Check /tool/fastboot.rar in the SDK package. Install USB driver on a Windows computer: android_usb_windows_pid8241_ rar, For installation, refer to Neoway_N720_USB Driver Installation on Windows. The installation files are under /tool/ in the SDK package. 3.2 Debugging Run adb shell to enter the shell. Then run logread to obtain log. Copyright Neoway Technology Co., Ltd 7

12 Run logread in the background and save the logs to the file under the module path. Use printf("xxx\n") to print log in the console window. Standard log functions of the Linux OS are also available: Syslog(LOG_ERR, E/NEO-- VA_ARGS ) Syslog(LOG_ERR, I/NEO-- VA_ARGS ) Syslog(LOG_ERR, D/NEO-- VA_ARGS ) Copyright Neoway Technology Co., Ltd 8

13 3.3 Compiling and Running Compiling Navigate to neoway/sample/uart, and input make. After the compiling is executed successfully, executable UART files are generated under the directory. UART is an example here. If a user has multiple.c files, please modify makefile under the corresponding directory. The following figure shows an example of a makefile. Copyright Neoway Technology Co., Ltd 9

14 Add source files to LOCAL_SRC_FILES. INC_DIR is to save header file directory, and USR_LIB is to save library file connected Running Copy executable UART program generated by make to the computer, and push it to usr/bin of the module through ADB. Modify the file permission. Navigate to shell and execute the program. To set automatic start with the module for the program, modify /etc/inittab in the following way: 1. Export etc/inittab from the module to the computer. 2. Modify inittab. Copyright Neoway Technology Co., Ltd 10

15 3. Push the modified inittab file to the previous directory of the module. The program can automatically start with the module. Copyright Neoway Technology Co., Ltd 11

16 4 Reference Software Design 4.1 ADC Header file #include <stdio.h> #include <string.h> #include <strings.h> #include <stdlib.h> #include <errno.h> #include <termios.h> #include <unistd.h> #include <fcntl.h> #include <sys/ioctl.h> Two ADCs: /dev/neo_adc_temp and /dev/neo_adc2_temp #define NWY_ADC1_DEV "/dev/neo_adc_temp" #define NWY_ADC2_DEV "/dev/neo_adc2_temp" Interface int open(const char* pathname, int flags, mode_t mode) ssize_t read(int fd, void* buf, size_t count) int close(int fd) Standard operation interface. The unit for the value read by ADC is V. Routine For details, refer to \neowaysample\adc\adc.c. 4.2 GPIO Header files #include <stdlib.h> #include <string.h> #include <stdio.h> #include <semaphore.h> #include <sys/ioctl.h> #include <fcntl.h> #include <linux/types.h> GPIO device drivers and GPIO recourses Check the device in /dev/neo_gpio_dev. Copyright Neoway Technology Co., Ltd 12

17 Six GPIOs are open to users: GPIO74/GPIO75/GPIO76/GPIO77/GPIO78/GPIO79. Interface int open(const char* pathname, int flags, mode_t mode) ssize_t ioctl(int fd, void* buf, size_t count) int close(int fd, unsigned long cmd, ) GPIOs are controlled by the ioctl function. //Set the output value of a GPIO. #define NEO_IOCTL_GPIO_SET_VALUE _IOW(NEO_GPIO_DEVIO,1,char[3]) //Read the value on a GPIO. #define NEO_IOCTL_GPIO_GET_VALUE _IOR(NEO_GPIO_DEVIO,2, char[3]) //Set GPIO direction. #define NEO_IOCTL_GPIO_SET_DIR _IOW(NEO_GPIO_DEVIO,3,char[3]) //Read GPIO direction #define NEO_IOCTL_GPIO_GET_DIR _IOR(NEO_GPIO_DEVIO,4,char[3]) Routine For details, refer to /neoway/sample/gpio/gpio.c. 4.3 UART Header file #include "nwy_uart.h" Device driver ports /dev/ttyhsl0 /dev/ttyhsl1 /dev/ttyhsl2 //uart1 //uart2 //uart3 API interface int NWY_UART_Open(const char* port, unsigned int baudrate, Enum_FlowCtrl flowctrl); int NWY_UART_Read(int fd, char* buf, unsigned int buf_len); int NWY_UART_Write(int fd, const char* buf, unsigned int buf_len); int NWY_UART_SetDCB(int fd, ST_UARTDCB *dcb); int NWY_UART_GetDCBConfig(int fd, ST_UARTDCB *dcb); int NWY_UART_IoCtl(int fd, unsigned int cmd, void* pvalue); int NWY_UART_Close(int fd); Routine For details, refer to neoway/sample/uart/uart.c. Copyright Neoway Technology Co., Ltd 13

18 4.4 SPI Header files #include <stdint.h> #include <unistd.h> #include <stdio.h> #include <stdlib.h> #include <getopt.h> #include <fcntl.h> #include <sys/ioctl.h> #include <linux/types.h> #include <linux/spi/spidev.h> Device driver port /dev/spidev1.0 API interface /*data transmission*/ #define SPI_MSGSIZE(N) \ \ ((((N)*(sizeof (struct spi_ioc_transfer))) < (1 << _IOC_SIZEBITS))? ((N)*(sizeof (struct spi_ioc_transfer))) : 0) #define SPI_IOC_MESSAGE(N) _IOW(SPI_IOC_MAGIC, 0, char[spi_msgsize(n)]) /* SPI device read/write mode (SPI_MODE_0..SPI_MODE_3) */ #define SPI_IOC_RD_MODE #define SPI_IOC_WR_MODE _IOR(SPI_IOC_MAGIC, 1, u8) _IOW(SPI_IOC_MAGIC, 1, u8) /* SPI device read/write bit */ #define SPI_IOC_RD_LSB_FIRST #define SPI_IOC_WR_LSB_FIRST _IOR(SPI_IOC_MAGIC, 2, u8) _IOW(SPI_IOC_MAGIC, 2, u8) /* SPI device read/write lengtb*/ #define SPI_IOC_RD_BITS_PER_WORD _IOR(SPI_IOC_MAGIC, 3, u8) #define SPI_IOC_WR_BITS_PER_WORD _IOW(SPI_IOC_MAGIC, 3, u8) /*Max. read/write rate of SPI device, available rate (Hz) including , , , , , , */ #define SPI_IOC_RD_MAX_SPEED_HZ #define SPI_IOC_WR_MAX_SPEED_HZ _IOR(SPI_IOC_MAGIC, 4, u32) _IOW(SPI_IOC_MAGIC, 4, u32) /*SPI device read/write mode*/ #define SPI_IOC_RD_MODE32 #define SPI_IOC_WR_MODE32 _IOR(SPI_IOC_MAGIC, 5, u32) _IOW(SPI_IOC_MAGIC, 5, u32) Routine Copyright Neoway Technology Co., Ltd 14

19 For details, refer to neoway/sample/spi/spi_test.c. 4.5 Network Dialup for network service Call the encapsulation interfaces: int set_up_call( int8_t ip_family, char *apn_name, char *user_name, char *password, int8_t tech_pref, int8_t umts_profile, int8_t cdma_profile //if family //APN name //Username for APN //Password for an APN //technology preference //UMTS profile ID //CDMA profile ID ); Return value: 0 indicates success; 1 indicates error. Refer to neoway/sample/data_call/data_call_setup.c. Stop PPP communication, and disconnect to the network. Call the encapsulation interface: int stop_data_call(void) Return value: 0 indicates success; 1 indicates failure. Obtain the network signal strength. Call MCM_NW_GET_SIGNAL_STRENGTH_REQ_V01 Obtain the current network mode. Call the MCM API: MCM_NW_GET_REGISTRATION_STATUS_REQ_V01 For more about how to develop network functions, refer to Ioe_Cm_Api_Interface_Spec.pdf. 4.6 Ethernet Manual start: insert a network cable, and execute the following commands in adb shell: ifcongfig ///Check network device ifconfig eth0 hw ether 00:1A:6B:38:7D:A8 ///Set the mac address of eth0 ifconfig eth0 up ///Enable etho of the network device. brctl show brctl delif bridge0 eth0 brctl showifconfig eth netmask ///set IP of eth0 manually Copyright Neoway Technology Co., Ltd 15

20 ip route ///check route ifconfig bridge0 down ip route add default dev eth0 ip route ping For details, refer to neoway/sample/ethernet/main.c. 4.7 OTG N720 OpenLinux support OTG, which users should set up the thread. Mount a USB-key disk before using the OTG function. The system displays /dev/sda[??] after the USB key is inserted. Then mount it in the following way: Create a new mounting directory. The /udisk created by the system can be used as the target mounting directory. mount t vfat /dev/sda1 /udisk The USB key is mounted successfully. Navigate to the USB key directory and check the data inside. cd /udisk ls l Files in the USB key are displayed. For details, refer to neoway/sample/udisk/main.c. 4.8 AT Tty device /dev/smd10 is used to send AT commands. Developer can open it and write it to AT commands. For details, refer to neoway/sample/at/attest.c. Copyright Neoway Technology Co., Ltd 16