N720 OpenLinux Software User Guide Version 1.2

Transcription

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

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 V1.1 Deleted USB driver installation Added GPS and Wi-Fi V1.2 Modified ROM Deleted dual-sim Copyright Neoway Technology Co., Ltd ii

4 Contents 1 N720 OpenLinux Features Block Diagram Basic Functions 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 GPS Wi-Fi Hotspot 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: 512MB Support different network standards: GSM/GPRS/EDGE&WCDMA R99 to DC-HSPA+&TD-SCDMA&LTE Cat4 Support USB2.0/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 Setting Up Development Environment 2.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. 2.2 Debugging Run adb shell to enter the shell. Then run logread to obtain log. Copyright Neoway Technology Co., Ltd 3

8 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 4

9 2.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 5

10 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 6

11 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 7

12 3 Reference Software Design 3.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. 3.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 8

13 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. 3.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 9

14 3.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 10

15 For details, refer to neoway/sample/spi/spi_test.c. 3.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. 3.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 11

16 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. 3.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. 3.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 12

17 3.9 GPS Header files #include <stdlib.h> #include <string.h> #include <stdio.h> #include <semaphore.h> #include "mcm_client.h" #include "mcm_client_v01.h" #include "mcm_common_v01.h" #include "mcm_data_v01.h" #include "data_call_handler.h" #include "mcm_loc_v01.h" Interfaces MCM messages: #define MCM_LOC_SET_INDICATIONS_REQ_V01 0x0300 #define MCM_LOC_SET_INDICATIONS_RESP_V01 0x0300 #define MCM_LOC_SET_POSITION_MODE_REQ_V01 0x0301 #define MCM_LOC_SET_POSITION_MODE_RESP_V01 0x0301 #define MCM_LOC_START_NAV_REQ_V01 0x0302 #define MCM_LOC_START_NAV_RESP_V01 0x0302 #define MCM_LOC_STOP_NAV_REQ_V01 0x0303 #define MCM_LOC_STOP_NAV_RESP_V01 0x0303 #define MCM_LOC_DELETE_AIDING_DATA_REQ_V01 0x0304 #define MCM_LOC_DELETE_AIDING_DATA_RESP_V01 0x0304 #define MCM_LOC_INJECT_TIME_REQ_V01 0x0305 #define MCM_LOC_INJECT_TIME_RESP_V01 0x0305 #define MCM_LOC_INJECT_LOCATION_REQ_V01 0x0306 #define MCM_LOC_INJECT_LOCATION_RESP_V01 0x0306 #define MCM_LOC_XTRA_INJECT_DATA_REQ_V01 0x0307 #define MCM_LOC_XTRA_INJECT_DATA_RESP_V01 0x0307 #define MCM_LOC_AGPS_DATA_CONN_OPEN_REQ_V01 0x0308 #define MCM_LOC_AGPS_DATA_CONN_OPEN_RESP_V01 0x0308 #define MCM_LOC_AGPS_DATA_CONN_CLOSED_REQ_V01 0x0309 Copyright Neoway Technology Co., Ltd 13

18 #define MCM_LOC_AGPS_DATA_CONN_CLOSED_RESP_V01 0x0309 #define MCM_LOC_AGPS_DATA_CONN_FAILED_REQ_V01 0x030A #define MCM_LOC_AGPS_DATA_CONN_FAILED_RESP_V01 0x030A #define MCM_LOC_AGPS_SET_SERVER_REQ_V01 0x030B #define MCM_LOC_AGPS_SET_SERVER_RESP_V01 0x030B #define MCM_LOC_NI_RESPOND_REQ_V01 0x030C #define MCM_LOC_NI_RESPOND_RESP_V01 0x030C #define MCM_LOC_AGPS_RIL_UPDATE_NETWORK_AVAILABILITY_REQ_V01 0x030D #define MCM_LOC_AGPS_RIL_UPDATE_NETWORK_AVAILABILITY_RESP_V01 0x030D #define MCM_LOC_LOCATION_INFO_IND_V01 0x030E #define MCM_LOC_STATUS_INFO_IND_V01 0x030F #define MCM_LOC_SV_INFO_IND_V01 0x0310 #define MCM_LOC_NMEA_INFO_IND_V01 0x0311 #define MCM_LOC_CAPABILITIES_INFO_IND_V01 0x0312 #define MCM_LOC_UTC_TIME_REQ_IND_V01 0x0313 #define MCM_LOC_XTRA_DATA_REQ_IND_V01 0x0314 #define MCM_LOC_AGPS_STATUS_IND_V01 0x0315 #define MCM_LOC_NI_NOTIFICATION_IND_V01 0x031 Routine See neoway/sample/gps/gps.c Wi-Fi Hotspot To enable the Wi-Fi hotspot, follow the steps below: Navigate to shell. Start QCMAP_CLI. Select 30. Select 31. Select 38. Select 32. The Wi-Fi hotspot name is QSoftAP, and the password is Copyright Neoway Technology Co., Ltd 14

19 Copyright Neoway Technology Co., Ltd 15